@weavelogic/knowledge-graph-agent 0.6.0 → 0.7.1

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 (219) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +70 -3
  3. package/dist/_virtual/__vite-browser-external.js +2 -2
  4. package/dist/_virtual/__vite-browser-external.js.map +1 -1
  5. package/dist/_virtual/index12.js +7 -0
  6. package/dist/_virtual/index12.js.map +1 -0
  7. package/dist/_virtual/ort-web.min.js +8 -0
  8. package/dist/_virtual/ort-web.min.js.map +1 -0
  9. package/dist/_virtual/ort-web.min2.js +5 -0
  10. package/dist/_virtual/ort-web.min2.js.map +1 -0
  11. package/dist/agents/base-agent.d.ts +63 -0
  12. package/dist/agents/base-agent.d.ts.map +1 -1
  13. package/dist/agents/base-agent.js +139 -0
  14. package/dist/agents/base-agent.js.map +1 -1
  15. package/dist/agents/coordinator-agent.d.ts +422 -0
  16. package/dist/agents/coordinator-agent.d.ts.map +1 -0
  17. package/dist/agents/documenter-agent.d.ts +298 -0
  18. package/dist/agents/documenter-agent.d.ts.map +1 -0
  19. package/dist/agents/index.d.ts +11 -1
  20. package/dist/agents/index.d.ts.map +1 -1
  21. package/dist/agents/index.js +4 -0
  22. package/dist/agents/index.js.map +1 -1
  23. package/dist/agents/mixins/index.d.ts +9 -0
  24. package/dist/agents/mixins/index.d.ts.map +1 -0
  25. package/dist/agents/mixins/trajectory-mixin.d.ts +112 -0
  26. package/dist/agents/mixins/trajectory-mixin.d.ts.map +1 -0
  27. package/dist/agents/optimizer-agent.d.ts +388 -0
  28. package/dist/agents/optimizer-agent.d.ts.map +1 -0
  29. package/dist/agents/planner-agent.d.ts +395 -0
  30. package/dist/agents/planner-agent.d.ts.map +1 -0
  31. package/dist/agents/registry.d.ts.map +1 -1
  32. package/dist/agents/registry.js +5 -0
  33. package/dist/agents/registry.js.map +1 -1
  34. package/dist/agents/reviewer-agent.d.ts +330 -0
  35. package/dist/agents/reviewer-agent.d.ts.map +1 -0
  36. package/dist/agents/types.d.ts +12 -1
  37. package/dist/agents/types.d.ts.map +1 -1
  38. package/dist/agents/types.js +1 -0
  39. package/dist/agents/types.js.map +1 -1
  40. package/dist/cli/commands/hive-mind/add-frontmatter.d.ts +102 -0
  41. package/dist/cli/commands/hive-mind/add-frontmatter.d.ts.map +1 -0
  42. package/dist/cli/commands/hive-mind/add-frontmatter.js +439 -0
  43. package/dist/cli/commands/hive-mind/add-frontmatter.js.map +1 -0
  44. package/dist/cli/commands/hive-mind/analyze-links.d.ts +80 -0
  45. package/dist/cli/commands/hive-mind/analyze-links.d.ts.map +1 -0
  46. package/dist/cli/commands/hive-mind/analyze-links.js +367 -0
  47. package/dist/cli/commands/hive-mind/analyze-links.js.map +1 -0
  48. package/dist/cli/commands/hive-mind/find-connections.d.ts +75 -0
  49. package/dist/cli/commands/hive-mind/find-connections.d.ts.map +1 -0
  50. package/dist/cli/commands/hive-mind/find-connections.js +347 -0
  51. package/dist/cli/commands/hive-mind/find-connections.js.map +1 -0
  52. package/dist/cli/commands/hive-mind/index.d.ts +37 -0
  53. package/dist/cli/commands/hive-mind/index.d.ts.map +1 -0
  54. package/dist/cli/commands/hive-mind/index.js +33 -0
  55. package/dist/cli/commands/hive-mind/index.js.map +1 -0
  56. package/dist/cli/commands/hive-mind/validate-names.d.ts +79 -0
  57. package/dist/cli/commands/hive-mind/validate-names.d.ts.map +1 -0
  58. package/dist/cli/commands/hive-mind/validate-names.js +353 -0
  59. package/dist/cli/commands/hive-mind/validate-names.js.map +1 -0
  60. package/dist/cli/commands/vector.js +2 -0
  61. package/dist/cli/commands/vector.js.map +1 -1
  62. package/dist/cli/index.d.ts.map +1 -1
  63. package/dist/cli/index.js +7 -0
  64. package/dist/cli/index.js.map +1 -1
  65. package/dist/equilibrium/agent-equilibrium.d.ts +194 -0
  66. package/dist/equilibrium/agent-equilibrium.d.ts.map +1 -0
  67. package/dist/equilibrium/agent-equilibrium.js +304 -0
  68. package/dist/equilibrium/agent-equilibrium.js.map +1 -0
  69. package/dist/equilibrium/graph-equilibrium.d.ts +177 -0
  70. package/dist/equilibrium/graph-equilibrium.d.ts.map +1 -0
  71. package/dist/equilibrium/index.d.ts +11 -0
  72. package/dist/equilibrium/index.d.ts.map +1 -0
  73. package/dist/equilibrium/memory-equilibrium.d.ts +153 -0
  74. package/dist/equilibrium/memory-equilibrium.d.ts.map +1 -0
  75. package/dist/graphql/resolvers/index.d.ts.map +1 -1
  76. package/dist/graphql/resolvers/queries.d.ts +11 -0
  77. package/dist/graphql/resolvers/queries.d.ts.map +1 -1
  78. package/dist/index.d.ts +2 -0
  79. package/dist/index.d.ts.map +1 -1
  80. package/dist/index.js +10 -4
  81. package/dist/index.js.map +1 -1
  82. package/dist/inference/index.d.ts +9 -0
  83. package/dist/inference/index.d.ts.map +1 -0
  84. package/dist/inference/model-selection.d.ts +131 -0
  85. package/dist/inference/model-selection.d.ts.map +1 -0
  86. package/dist/integrations/agentic-flow/adapters/agent-booster-adapter.d.ts +265 -0
  87. package/dist/integrations/agentic-flow/adapters/agent-booster-adapter.d.ts.map +1 -0
  88. package/dist/integrations/agentic-flow/adapters/agentdb-adapter.d.ts +197 -0
  89. package/dist/integrations/agentic-flow/adapters/agentdb-adapter.d.ts.map +1 -0
  90. package/dist/integrations/agentic-flow/adapters/agentdb-vector-store.d.ts +249 -0
  91. package/dist/integrations/agentic-flow/adapters/agentdb-vector-store.d.ts.map +1 -0
  92. package/dist/integrations/agentic-flow/adapters/base-adapter.d.ts +120 -0
  93. package/dist/integrations/agentic-flow/adapters/base-adapter.d.ts.map +1 -0
  94. package/dist/integrations/agentic-flow/adapters/federation-hub-adapter.d.ts +444 -0
  95. package/dist/integrations/agentic-flow/adapters/federation-hub-adapter.d.ts.map +1 -0
  96. package/dist/integrations/agentic-flow/adapters/index.d.ts +17 -0
  97. package/dist/integrations/agentic-flow/adapters/index.d.ts.map +1 -0
  98. package/dist/integrations/agentic-flow/adapters/model-router-adapter.d.ts +242 -0
  99. package/dist/integrations/agentic-flow/adapters/model-router-adapter.d.ts.map +1 -0
  100. package/dist/integrations/agentic-flow/adapters/quic-transport-adapter.d.ts +364 -0
  101. package/dist/integrations/agentic-flow/adapters/quic-transport-adapter.d.ts.map +1 -0
  102. package/dist/integrations/agentic-flow/adapters/reasoning-bank-adapter.d.ts +209 -0
  103. package/dist/integrations/agentic-flow/adapters/reasoning-bank-adapter.d.ts.map +1 -0
  104. package/dist/integrations/agentic-flow/benchmark/index.d.ts +9 -0
  105. package/dist/integrations/agentic-flow/benchmark/index.d.ts.map +1 -0
  106. package/dist/integrations/agentic-flow/benchmark/vector-benchmark.d.ts +253 -0
  107. package/dist/integrations/agentic-flow/benchmark/vector-benchmark.d.ts.map +1 -0
  108. package/dist/integrations/agentic-flow/config.d.ts +109 -0
  109. package/dist/integrations/agentic-flow/config.d.ts.map +1 -0
  110. package/dist/integrations/agentic-flow/feature-flags.d.ts +140 -0
  111. package/dist/integrations/agentic-flow/feature-flags.d.ts.map +1 -0
  112. package/dist/integrations/agentic-flow/index.d.ts +22 -0
  113. package/dist/integrations/agentic-flow/index.d.ts.map +1 -0
  114. package/dist/integrations/agentic-flow/migration/index.d.ts +9 -0
  115. package/dist/integrations/agentic-flow/migration/index.d.ts.map +1 -0
  116. package/dist/integrations/agentic-flow/migration/migrate-to-agentdb.d.ts +242 -0
  117. package/dist/integrations/agentic-flow/migration/migrate-to-agentdb.d.ts.map +1 -0
  118. package/dist/learning/index.d.ts +91 -0
  119. package/dist/learning/index.d.ts.map +1 -0
  120. package/dist/learning/learning-loop.d.ts +176 -0
  121. package/dist/learning/learning-loop.d.ts.map +1 -0
  122. package/dist/learning/services/ab-testing-framework.d.ts +135 -0
  123. package/dist/learning/services/ab-testing-framework.d.ts.map +1 -0
  124. package/dist/learning/services/agent-priming-service.d.ts +207 -0
  125. package/dist/learning/services/agent-priming-service.d.ts.map +1 -0
  126. package/dist/learning/services/daily-log-generator.d.ts +113 -0
  127. package/dist/learning/services/daily-log-generator.d.ts.map +1 -0
  128. package/dist/learning/services/index.d.ts +14 -0
  129. package/dist/learning/services/index.d.ts.map +1 -0
  130. package/dist/learning/services/memory-extraction-service.d.ts +87 -0
  131. package/dist/learning/services/memory-extraction-service.d.ts.map +1 -0
  132. package/dist/learning/services/task-completion-consumer.d.ts +162 -0
  133. package/dist/learning/services/task-completion-consumer.d.ts.map +1 -0
  134. package/dist/learning/services/trajectory-tracker.d.ts +174 -0
  135. package/dist/learning/services/trajectory-tracker.d.ts.map +1 -0
  136. package/dist/learning/types.d.ts +516 -0
  137. package/dist/learning/types.d.ts.map +1 -0
  138. package/dist/mcp/clients/claude-flow-memory-client.d.ts +259 -0
  139. package/dist/mcp/clients/claude-flow-memory-client.d.ts.map +1 -0
  140. package/dist/mcp/clients/claude-flow-memory-client.js +305 -0
  141. package/dist/mcp/clients/claude-flow-memory-client.js.map +1 -0
  142. package/dist/mcp/clients/index.d.ts +11 -0
  143. package/dist/mcp/clients/index.d.ts.map +1 -0
  144. package/dist/mcp/clients/mcp-client-adapter.d.ts +146 -0
  145. package/dist/mcp/clients/mcp-client-adapter.d.ts.map +1 -0
  146. package/dist/mcp/clients/mcp-client-adapter.js +372 -0
  147. package/dist/mcp/clients/mcp-client-adapter.js.map +1 -0
  148. package/dist/mcp/index.d.ts +10 -0
  149. package/dist/mcp/index.d.ts.map +1 -0
  150. package/dist/memory/vault-sync.d.ts +12 -0
  151. package/dist/memory/vault-sync.d.ts.map +1 -1
  152. package/dist/memory/vault-sync.js +94 -11
  153. package/dist/memory/vault-sync.js.map +1 -1
  154. package/dist/node_modules/@huggingface/jinja/dist/index.js +118 -0
  155. package/dist/node_modules/@huggingface/jinja/dist/index.js.map +1 -0
  156. package/dist/node_modules/@typescript-eslint/project-service/dist/index.js +1 -1
  157. package/dist/node_modules/@xenova/transformers/src/backends/onnx.js +24 -0
  158. package/dist/node_modules/@xenova/transformers/src/backends/onnx.js.map +1 -0
  159. package/dist/node_modules/@xenova/transformers/src/configs.js +52 -0
  160. package/dist/node_modules/@xenova/transformers/src/configs.js.map +1 -0
  161. package/dist/node_modules/@xenova/transformers/src/env.js +35 -0
  162. package/dist/node_modules/@xenova/transformers/src/env.js.map +1 -0
  163. package/dist/node_modules/@xenova/transformers/src/models.js +3852 -0
  164. package/dist/node_modules/@xenova/transformers/src/models.js.map +1 -0
  165. package/dist/node_modules/@xenova/transformers/src/tokenizers.js +144 -0
  166. package/dist/node_modules/@xenova/transformers/src/tokenizers.js.map +1 -0
  167. package/dist/node_modules/@xenova/transformers/src/utils/core.js +52 -0
  168. package/dist/node_modules/@xenova/transformers/src/utils/core.js.map +1 -0
  169. package/dist/node_modules/@xenova/transformers/src/utils/generation.js +623 -0
  170. package/dist/node_modules/@xenova/transformers/src/utils/generation.js.map +1 -0
  171. package/dist/node_modules/@xenova/transformers/src/utils/hub.js +395 -0
  172. package/dist/node_modules/@xenova/transformers/src/utils/hub.js.map +1 -0
  173. package/dist/node_modules/@xenova/transformers/src/utils/image.js +12 -0
  174. package/dist/node_modules/@xenova/transformers/src/utils/image.js.map +1 -0
  175. package/dist/node_modules/@xenova/transformers/src/utils/maths.js +89 -0
  176. package/dist/node_modules/@xenova/transformers/src/utils/maths.js.map +1 -0
  177. package/dist/node_modules/@xenova/transformers/src/utils/tensor.js +750 -0
  178. package/dist/node_modules/@xenova/transformers/src/utils/tensor.js.map +1 -0
  179. package/dist/node_modules/fdir/dist/index.js +13 -13
  180. package/dist/node_modules/fdir/dist/index.js.map +1 -1
  181. package/dist/node_modules/onnxruntime-common/dist/lib/backend-impl.js +67 -0
  182. package/dist/node_modules/onnxruntime-common/dist/lib/backend-impl.js.map +1 -0
  183. package/dist/node_modules/onnxruntime-common/dist/lib/env-impl.js +24 -0
  184. package/dist/node_modules/onnxruntime-common/dist/lib/env-impl.js.map +1 -0
  185. package/dist/node_modules/onnxruntime-common/dist/lib/env.js +6 -0
  186. package/dist/node_modules/onnxruntime-common/dist/lib/env.js.map +1 -0
  187. package/dist/node_modules/onnxruntime-common/dist/lib/index.js +11 -0
  188. package/dist/node_modules/onnxruntime-common/dist/lib/index.js.map +1 -0
  189. package/dist/node_modules/onnxruntime-common/dist/lib/inference-session-impl.js +162 -0
  190. package/dist/node_modules/onnxruntime-common/dist/lib/inference-session-impl.js.map +1 -0
  191. package/dist/node_modules/onnxruntime-common/dist/lib/inference-session.js +6 -0
  192. package/dist/node_modules/onnxruntime-common/dist/lib/inference-session.js.map +1 -0
  193. package/dist/node_modules/onnxruntime-common/dist/lib/tensor-impl.js +393 -0
  194. package/dist/node_modules/onnxruntime-common/dist/lib/tensor-impl.js.map +1 -0
  195. package/dist/node_modules/onnxruntime-common/dist/lib/tensor.js +6 -0
  196. package/dist/node_modules/onnxruntime-common/dist/lib/tensor.js.map +1 -0
  197. package/dist/node_modules/onnxruntime-web/dist/ort-web.min.js +12919 -0
  198. package/dist/node_modules/onnxruntime-web/dist/ort-web.min.js.map +1 -0
  199. package/dist/node_modules/tinyglobby/dist/index.js +14 -14
  200. package/dist/node_modules/tinyglobby/dist/index.js.map +1 -1
  201. package/dist/node_modules/typescript/lib/typescript.js +24 -24
  202. package/dist/node_modules/typescript/lib/typescript.js.map +1 -1
  203. package/dist/transport/agent-transport.d.ts +269 -0
  204. package/dist/transport/agent-transport.d.ts.map +1 -0
  205. package/dist/transport/index.d.ts +10 -0
  206. package/dist/transport/index.d.ts.map +1 -0
  207. package/dist/vector/index.d.ts +1 -1
  208. package/dist/vector/index.d.ts.map +1 -1
  209. package/dist/vector/services/embedding-service.d.ts +244 -0
  210. package/dist/vector/services/embedding-service.d.ts.map +1 -0
  211. package/dist/vector/services/embedding-service.js +10 -0
  212. package/dist/vector/services/embedding-service.js.map +1 -0
  213. package/dist/vector/services/hybrid-search.d.ts +320 -0
  214. package/dist/vector/services/hybrid-search.d.ts.map +1 -0
  215. package/dist/vector/services/hybrid-search.js +3 -0
  216. package/dist/vector/services/hybrid-search.js.map +1 -0
  217. package/dist/vector/services/index.d.ts +4 -0
  218. package/dist/vector/services/index.d.ts.map +1 -1
  219. package/package.json +10 -1
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * Knowledge Graph Agent\n *\n * NPM library for creating and managing knowledge graphs for Claude Code.\n *\n * @packageDocumentation\n */\n\n// Internal imports for quickInit\nimport { createDatabase as _createDatabase } from './core/database.js';\nimport { initDocs as _initDocs, docsExist as _docsExist } from './generators/docs-init.js';\nimport { generateAndSave as _generateAndSave } from './generators/graph-generator.js';\nimport { updateClaudeMd as _updateClaudeMd } from './generators/claude-md.js';\n\n// ============================================================================\n// Core\n// ============================================================================\n\nexport {\n KnowledgeGraphManager,\n createKnowledgeGraph,\n} from './core/graph.js';\n\nexport {\n KnowledgeGraphDatabase,\n createDatabase,\n} from './core/database.js';\n\n// Cache exports\nexport {\n ShadowCache,\n createShadowCache,\n loadShadowCache,\n} from './core/cache.js';\n\nexport type {\n FileMetadata,\n FileType,\n ChangeType,\n FileChange,\n CacheStats,\n ShadowCacheOptions,\n} from './core/cache.js';\n\nexport type {\n // Node types\n NodeType,\n NodeStatus,\n NodeLink,\n NodeFrontmatter,\n KnowledgeNode,\n\n // Graph types\n GraphEdge,\n GraphMetadata,\n GraphStats,\n KnowledgeGraph,\n\n // Configuration\n KGConfig,\n ConfigSchema,\n\n // Generator types\n GeneratorOptions,\n GeneratedDocument,\n DocsInitOptions,\n DocsInitResult,\n\n // Integration types\n MemoryEntry,\n SyncResult,\n\n // CLAUDE.md types\n ClaudeMdSection,\n ClaudeMdTemplate,\n ClaudeMdGeneratorOptions,\n} from './core/types.js';\n\n// ============================================================================\n// Generators\n// ============================================================================\n\nexport {\n generateGraph,\n generateAndSave,\n updateGraph,\n} from './generators/graph-generator.js';\n\nexport {\n initDocs,\n docsExist,\n getDocsPath,\n} from './generators/docs-init.js';\n\nexport {\n generateClaudeMd,\n updateClaudeMd,\n addSection,\n getSectionTemplate,\n listSectionTemplates,\n} from './generators/claude-md.js';\n\n// Conversion exports\nexport {\n convertDocs,\n addFrontmatter,\n validateFrontmatter,\n} from './generators/docs-convert.js';\n\nexport type {\n ConvertOptions,\n ConvertResult,\n FrontmatterOptions,\n FrontmatterResult,\n} from './generators/docs-convert.js';\n\n// Analyzer exports\nexport {\n analyzeDocs,\n} from './generators/docs-analyzer.js';\n\nexport type {\n AnalyzerOptions,\n AnalyzedDoc,\n AnalyzerResult,\n} from './generators/docs-analyzer.js';\n\n// ============================================================================\n// Integrations\n// ============================================================================\n\nexport {\n ClaudeFlowIntegration,\n createClaudeFlowIntegration,\n generateMcpConfig,\n} from './integrations/claude-flow.js';\n\n// ============================================================================\n// CLI\n// ============================================================================\n\nexport { createCLI } from './cli/index.js';\n\n// ============================================================================\n// Agents\n// ============================================================================\n\nexport {\n // Agent system core\n AgentType,\n AgentStatus,\n TaskPriority,\n MessageType,\n createMessageId,\n createTaskId,\n createAgentId,\n\n // Registry\n AgentRegistry,\n getRegistry,\n createRegistry,\n setDefaultRegistry,\n registerDefaultAgents,\n\n // Base Agent\n BaseAgent,\n createTask,\n isAgentResult,\n isAgentError,\n\n // Specialized Agents\n ResearcherAgent,\n CoderAgent,\n TesterAgent,\n AnalystAgent,\n ArchitectAgent,\n\n // Rules Engine\n RulesEngine,\n createRulesEngine,\n createRule,\n createConditionalRule,\n createFileChangeLogRule,\n createGraphUpdateNotificationRule,\n createAgentCompletionRule,\n} from './agents/index.js';\n\nexport type {\n // Agent types\n AgentConfig,\n ResearcherAgentConfig,\n CoderAgentConfig,\n TesterAgentConfig,\n AnalystAgentConfig,\n ArchitectAgentConfig,\n SpecializedAgentConfig,\n TaskInput,\n AgentTask,\n AgentResult as AgentSystemResult,\n AgentError,\n ExecutionMetrics,\n ResultArtifact,\n AgentMessage,\n TaskRequestMessage,\n TaskResponseMessage,\n StatusMessage,\n ErrorMessage,\n CoordinationMessage,\n AgentMessageUnion,\n AgentState,\n AgentFactory,\n AgentInstance,\n AgentCapability,\n AgentHealthCheck,\n RegistryOptions,\n SpawnOptions,\n\n // Rules Engine types\n RuleTrigger,\n RulePriority,\n RuleExecutionStatus,\n RuleContext,\n RuleCondition,\n RuleAction,\n AgentRule,\n RuleExecutionLog,\n RuleStatistics,\n EngineStatistics,\n RulesEngineConfig,\n} from './agents/index.js';\n\n// ============================================================================\n// Cultivation\n// ============================================================================\n\nexport {\n SeedGenerator,\n analyzeSeed,\n initPrimitives,\n DeepAnalyzer,\n createDeepAnalyzer,\n analyzeDeep,\n} from './cultivation/index.js';\n\nexport type {\n VaultContext,\n Ecosystem,\n DependencyType,\n ServiceType,\n DependencyInfo,\n ServiceInfo,\n SeedAnalysis,\n DocumentMetadata as CultivationDocumentMetadata,\n GeneratedDocument as CultivationGeneratedDocument,\n CultivationReport,\n CultivationOptions,\n GapAnalysis as CultivationGapAnalysis,\n InitPrimitivesResult,\n DeepAnalyzerOptions,\n AgentResult,\n DeepAnalysisResult,\n} from './cultivation/index.js';\n\n// ============================================================================\n// SOPs\n// ============================================================================\n\nexport {\n // Enums\n SOPCategory,\n ComplianceStatus,\n SOPPriority,\n IRBStatus,\n GraphLayer,\n // Registry\n getSOPById,\n getSOPsByCategory,\n getSOPsRequiringIRB,\n searchSOPs,\n getAllSOPs,\n getSopCount,\n getCategories,\n // Compliance\n checkCompliance,\n checkSOPCompliance,\n meetsMinimumCompliance,\n // Gap Analysis\n analyzeGaps,\n getGapsForSOP,\n getQuickWins,\n calculateProgress,\n // Overlay Management\n createMultiLayerGraph,\n addProjectLayer,\n addComplianceOverlay,\n filterByLayer,\n filterByComplianceStatus,\n getComplianceSummary,\n getGapNodes,\n toggleLayerVisibility,\n exportToVisualizationFormat,\n createSOPFocusedSubgraph,\n} from './sops/index.js';\n\nexport type {\n // SOP types\n SOPRequirement,\n SOPCheckpoint,\n SOPDefinition,\n SOPAssessment,\n ComplianceGap,\n LayerDefinition,\n LayerNode,\n LayerEdge,\n MultiLayerGraph,\n ComplianceReport,\n SOPFrontmatter,\n SOPConfig,\n // Compliance types\n ComplianceCheckOptions,\n ComplianceCheckResult,\n EvidenceItem,\n // Gap types\n GapAnalysisOptions,\n GapAnalysisResult,\n GapSummary,\n RemediationRoadmap,\n RemediationPhase,\n GapDependency,\n // Overlay types\n OverlayManagerOptions,\n NodeStyleConfig,\n} from './sops/index.js';\n\n// ============================================================================\n// Workflows\n// ============================================================================\n\nexport {\n WorkflowStatus,\n WorkflowRegistry,\n createWorkflowRegistry,\n} from './workflows/index.js';\n\nexport type {\n StepContext,\n StepHandler,\n RollbackHandler,\n WorkflowStep,\n WorkflowDefinition,\n StepExecution,\n WorkflowExecution,\n WorkflowResult,\n WorkflowExecutionStats,\n WorkflowRegistryOptions,\n WorkflowListOptions,\n ExecutionHistoryOptions,\n WorkflowEventType,\n WorkflowEvent,\n WorkflowEventListener,\n} from './workflows/index.js';\n\n// ============================================================================\n// Memory\n// ============================================================================\n\nexport {\n VaultMemorySync,\n createVaultMemorySync,\n} from './memory/index.js';\n\nexport type {\n SyncDirection,\n ConflictStrategy,\n SyncStatus,\n MemoryNode,\n SyncConflict,\n VaultSyncOptions,\n SyncOperationResult,\n FullSyncResult,\n} from './memory/index.js';\n\n// ============================================================================\n// Utils\n// ============================================================================\n\nexport {\n // Error Taxonomy\n ErrorCategory,\n ErrorSeverity,\n classifyError,\n isRetryableError,\n isTransientError,\n isRateLimitError,\n isPermanentError,\n KnowledgeGraphError,\n createValidationError,\n createConfigurationError,\n createResourceError,\n // Error Recovery\n withRetry,\n retry,\n withFallback,\n withCircuitBreaker,\n retryable,\n calculateBackoff,\n sleep,\n CircuitBreaker,\n CircuitState,\n RetriesExhaustedError,\n CircuitOpenError,\n // Logger\n Logger,\n LogLevel,\n getLogger,\n createLogger,\n setDefaultLogger,\n parseLogLevel,\n createProgressLogger,\n} from './utils/index.js';\n\nexport type {\n ClassifiedError,\n RetryOptions,\n RetryResult,\n FallbackOptions,\n CircuitBreakerOptions,\n LoggerOptions,\n LogEntry,\n ProgressLogger,\n} from './utils/index.js';\n\n// ============================================================================\n// MCP Server\n// ============================================================================\n\nexport {\n KnowledgeGraphMCPServer,\n createMCPServer,\n runServer,\n initializeTools,\n registerTool,\n getToolHandler,\n getToolDefinition,\n getToolDefinitions,\n getToolCategories,\n handleToolCall,\n handleError,\n createErrorResult,\n createSuccessResult,\n} from './mcp-server/index.js';\n\nexport type {\n MCPServerConfig,\n ServerHealth,\n ToolCategory,\n ToolHandler,\n ToolHandlerEntry,\n ToolResult,\n ToolContext,\n ToolInputSchema,\n ToolDefinition,\n GraphQueryParams,\n GraphNodeResult,\n AgentInvokeParams,\n AgentResult as MCPAgentResult,\n WorkflowParams,\n WorkflowResult as MCPWorkflowResult,\n MemoryParams,\n MemoryResult,\n} from './mcp-server/index.js';\n\n// ============================================================================\n// Server Infrastructure\n// ============================================================================\n\nexport {\n // Server Manager\n ServerManager,\n createServerManager,\n\n // Shared Services\n SharedServices,\n createSharedServices,\n getSharedServices,\n createDefaultConfig,\n\n // Service Container\n ServiceContainer,\n createServiceContainer,\n getServiceContainer,\n hasServiceContainer,\n shutdownServiceContainer,\n\n // TypedEventBus\n TypedEventBus,\n createTypedEventBus,\n createSubscriptionIterator,\n createNodeTypeFilter,\n createSourceFilter,\n\n // Constants\n DEFAULT_GRAPHQL_PORT,\n DEFAULT_DASHBOARD_PORT,\n DEFAULT_DATABASE_PATH,\n SHUTDOWN_TIMEOUT,\n HEALTH_CHECK_INTERVAL,\n} from './server/index.js';\n\nexport type {\n // Configuration types\n ServerConfig,\n MCPServerConfig as ServerMCPConfig,\n GraphQLServerConfig,\n DashboardServerConfig,\n DatabaseServerConfig,\n CacheServerConfig,\n\n // State types\n ServerStatus,\n ServerState,\n ServerManagerState,\n\n // Health types\n ComponentHealth as ServerComponentHealth,\n HealthStatus as ServerHealthStatus,\n\n // Event types\n ServerEventType,\n ServerEvent,\n ServerEventListener,\n\n // Instance types\n HTTPServerInstance,\n MCPServerInstance,\n\n // CLI types\n ServeCommandOptions,\n ParsedServeOptions,\n\n // Interface types\n ISharedServices,\n IServerManager,\n\n // Service Container types\n ServiceInitState,\n ServiceDependency,\n ContainerConfig,\n ContainerEventType,\n\n // TypedEventBus types\n EventType as ServerEventTypeEnum,\n EventDataMap,\n EventEntry,\n EventFilter,\n EventHandler as ServerEventHandler,\n Unsubscribe,\n NodeEventData,\n RelationEventData,\n AgentEventData,\n WorkflowEventData,\n PluginEventData,\n HealthEventData,\n CacheEvictionData,\n EventTypeMetrics,\n EventBusMetrics,\n ITypedEventBus,\n TypedEventBusOptions,\n} from './server/index.js';\n\n// ============================================================================\n// GraphQL\n// ============================================================================\n\nexport {\n // Server\n createGraphQLServer,\n\n // Context\n createContextFactory,\n hasScope,\n requireAuth,\n requireScope,\n isGraphQLContext,\n\n // Scalars\n DateTimeScalar,\n JSONScalar,\n UUIDScalar,\n FilePathScalar,\n customScalars,\n scalarTypeDefs,\n} from './graphql/index.js';\n\nexport type {\n // Server types\n GraphQLServerConfig as GraphQLServerOptions,\n GraphQLServerInstance,\n CorsConfig,\n HealthCheckResponse as GraphQLHealthCheckResponse,\n\n // Context types\n GraphQLContext,\n AuthResult,\n RequestMeta,\n RequestUtils,\n Services as GraphQLServices,\n ContextFactoryConfig,\n} from './graphql/index.js';\n\n// ============================================================================\n// Services\n// ============================================================================\n\nexport {\n ServiceManager,\n createServiceManager,\n FileWatcherService,\n} from './services/index.js';\n\nexport type {\n ServiceStatus,\n ServiceType as ManagerServiceType,\n ServiceConfig,\n ServiceState,\n ServiceMetrics,\n ServiceHandler,\n} from './services/index.js';\n\n// ============================================================================\n// Config\n// ============================================================================\n\nexport {\n ConfigManager,\n createConfigManager,\n getDefaultConfig,\n} from './config/index.js';\n\nexport type {\n KGConfiguration,\n DatabaseConfig,\n CacheConfig,\n AgentConfig as ConfigAgentConfig,\n ServicesConfig,\n LoggingConfig,\n ConfigMigration,\n} from './config/index.js';\n\n// ============================================================================\n// Health\n// ============================================================================\n\nexport {\n HealthMonitor,\n createHealthMonitor,\n createDatabaseCheck,\n createCacheCheck,\n createMemoryCheck,\n createDiskCheck,\n} from './health/index.js';\n\nexport type {\n HealthStatus,\n ComponentHealth,\n SystemHealth,\n MemoryMetrics,\n PerformanceMetrics,\n HealthCheck,\n HealthMonitorConfig,\n} from './health/index.js';\n\n// ============================================================================\n// Chunking\n// ============================================================================\n\nexport {\n Chunker,\n createChunker,\n chunkDocument,\n} from './chunking/index.js';\n\nexport type {\n ChunkStrategy,\n ChunkOptions,\n Chunk,\n ChunkMetadata,\n ChunkResult,\n} from './chunking/index.js';\n\n// ============================================================================\n// Recovery\n// ============================================================================\n\nexport {\n BackupManager,\n createBackupManager,\n IntegrityChecker,\n createIntegrityChecker,\n checkDatabaseIntegrity,\n} from './recovery/index.js';\n\nexport type {\n BackupConfig,\n BackupInfo,\n RestoreResult,\n RecoveryOptions,\n IntegrityCheckResult,\n TableIntegrity,\n} from './recovery/index.js';\n\n// ============================================================================\n// Advanced Caching\n// ============================================================================\n\nexport {\n AdvancedCache,\n createAdvancedCache,\n} from './caching/index.js';\n\nexport type {\n EvictionPolicy,\n CacheEntry,\n CacheConfig as AdvancedCacheConfig,\n CacheStats as AdvancedCacheStats,\n} from './caching/index.js';\n\n// ============================================================================\n// Reasoning\n// ============================================================================\n\nexport {\n DecisionTracker,\n createDecisionTracker,\n getDecisionTracker,\n} from './reasoning/index.js';\n\nexport type {\n DecisionType,\n ConfidenceLevel,\n Decision,\n DecisionContext,\n Alternative,\n DecisionOutcome,\n ReasoningChain,\n} from './reasoning/index.js';\n\n// ============================================================================\n// Workflow DevKit\n// ============================================================================\n\nexport {\n createWorkflowConfig,\n validateWorkflowConfig,\n createPostgresConfig,\n createVercelConfig,\n createLocalConfig,\n defaultConfig as defaultWorkflowConfig,\n} from './workflow/index.js';\n\nexport type {\n // Configuration types\n WorkflowConfig as WorkflowDevKitConfig,\n PostgresPoolConfig,\n PostgresWorldConfig,\n VercelWorldConfig,\n LocalWorldConfig,\n // World state types\n WorldState,\n // Event types\n NodeUpdateEvent,\n GapDetectedEvent,\n WorkflowCompleteEvent,\n WorkflowRunMetadata as DevKitRunMetadata,\n // Task types\n TaskSpec,\n DocumentGap,\n GapAnalysis as DevKitGapAnalysis,\n // GOAP types\n GOAPAction,\n GOAPGoal,\n GOAPPlanStep,\n GOAPPlan,\n GOAPPlanExtended,\n PlanExecutionResult,\n ReadinessEvaluation,\n // Execution types\n WorkflowExecutionOptions as DevKitExecutionOptions,\n WorkflowExecutionResult as DevKitExecutionResult,\n // Hook types\n HookHandler,\n HookRegistration,\n} from './workflow/index.js';\n\n// ============================================================================\n// Plugins\n// ============================================================================\n\n// Plugin System - Core exports (includes types, manager, analyzers)\n// This re-exports everything from plugins/index.js including:\n// - Types: PluginType, PluginHook, PluginStatus, PluginCapability, PluginDependency,\n// PluginConfigSchema, KGPluginManifest, PluginMetadata, KGPlugin, AnalyzerPlugin,\n// PluginContext, PluginAPI, PluginCommand, PluginEventEmitter, PluginLoader,\n// PluginRegistry, PluginManager, PluginManagerConfig, DiscoveredPlugin,\n// PluginLoadOptions, PluginLoadResult, PluginRegistryEvents, AnalysisInput,\n// AnalysisResult, AnalysisStreamChunk, PluginFactory, PluginConstructor,\n// PluginModuleExport, PluginConfigType\n// - Manager: PluginManagerImpl, PluginRegistryImpl, PluginLoaderImpl,\n// createPluginManager, createPluginRegistry, createPluginLoader,\n// createDefaultPluginManager\n// - Analyzers: CodeComplexityPlugin, DependencyHealthPlugin, and related exports\nexport * from './plugins/index.js';\n\n// ============================================================================\n// Quick Start\n// ============================================================================\n\n/**\n * Quick start function for programmatic usage\n *\n * @example\n * ```typescript\n * import { quickInit } from '@weave-nn/knowledge-graph-agent';\n *\n * await quickInit({\n * projectRoot: '/path/to/project',\n * docsPath: 'docs',\n * });\n * ```\n */\nexport async function quickInit(options: {\n projectRoot: string;\n docsPath?: string;\n generateGraph?: boolean;\n updateClaudeMd?: boolean;\n}): Promise<{\n success: boolean;\n docsCreated: boolean;\n graphGenerated: boolean;\n claudeMdUpdated: boolean;\n errors: string[];\n}> {\n const {\n projectRoot,\n docsPath = 'docs',\n generateGraph: genGraph = true,\n updateClaudeMd: updateClaude = true,\n } = options;\n\n const result = {\n success: true,\n docsCreated: false,\n graphGenerated: false,\n claudeMdUpdated: false,\n errors: [] as string[],\n };\n\n try {\n // Initialize docs if needed\n const { existsSync, mkdirSync, writeFileSync } = await import('fs');\n const { join } = await import('path');\n\n // Create .kg directory\n const kgDir = join(projectRoot, '.kg');\n if (!existsSync(kgDir)) {\n mkdirSync(kgDir, { recursive: true });\n }\n\n // Initialize database\n const dbPath = join(kgDir, 'knowledge.db');\n const db = _createDatabase(dbPath);\n db.setMetadata('initialized', new Date().toISOString());\n\n // Initialize docs\n if (!_docsExist(projectRoot, docsPath)) {\n const docsResult = await _initDocs({\n projectRoot,\n docsPath,\n includeExamples: true,\n detectFramework: true,\n });\n result.docsCreated = docsResult.success;\n if (!docsResult.success) {\n result.errors.push(...docsResult.errors);\n }\n }\n\n // Generate graph\n if (genGraph && _docsExist(projectRoot, docsPath)) {\n const graphResult = await _generateAndSave(\n {\n projectRoot,\n outputPath: join(projectRoot, docsPath),\n },\n dbPath\n );\n result.graphGenerated = graphResult.success;\n if (!graphResult.success) {\n result.errors.push(...graphResult.stats.errors);\n }\n }\n\n // Update CLAUDE.md\n if (updateClaude) {\n const claudeResult = await _updateClaudeMd({\n projectRoot,\n includeKnowledgeGraph: true,\n includeClaudeFlow: true,\n });\n result.claudeMdUpdated = claudeResult.created || claudeResult.updated;\n }\n\n db.close();\n result.success = result.errors.length === 0;\n\n } catch (error) {\n result.success = false;\n result.errors.push(String(error));\n }\n\n return result;\n}\n"],"names":["_createDatabase","_docsExist","_initDocs","_generateAndSave","_updateClaudeMd"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8zBA,eAAsB,UAAU,SAW7B;AACD,QAAM;AAAA,IACJ;AAAA,IACA,WAAW;AAAA,IACX,eAAe,WAAW;AAAA,IAC1B,gBAAgB,eAAe;AAAA,EAAA,IAC7B;AAEJ,QAAM,SAAS;AAAA,IACb,SAAS;AAAA,IACT,aAAa;AAAA,IACb,gBAAgB;AAAA,IAChB,iBAAiB;AAAA,IACjB,QAAQ,CAAA;AAAA,EAAC;AAGX,MAAI;AAEF,UAAM,EAAE,YAAY,WAAW,kBAAkB,MAAM,OAAO,IAAI;AAClE,UAAM,EAAE,KAAA,IAAS,MAAM,OAAO,MAAM;AAGpC,UAAM,QAAQ,KAAK,aAAa,KAAK;AACrC,QAAI,CAAC,WAAW,KAAK,GAAG;AACtB,gBAAU,OAAO,EAAE,WAAW,KAAA,CAAM;AAAA,IACtC;AAGA,UAAM,SAAS,KAAK,OAAO,cAAc;AACzC,UAAM,KAAKA,eAAgB,MAAM;AACjC,OAAG,YAAY,gBAAe,oBAAI,KAAA,GAAO,aAAa;AAGtD,QAAI,CAACC,UAAW,aAAa,QAAQ,GAAG;AACtC,YAAM,aAAa,MAAMC,SAAU;AAAA,QACjC;AAAA,QACA;AAAA,QACA,iBAAiB;AAAA,QACjB,iBAAiB;AAAA,MAAA,CAClB;AACD,aAAO,cAAc,WAAW;AAChC,UAAI,CAAC,WAAW,SAAS;AACvB,eAAO,OAAO,KAAK,GAAG,WAAW,MAAM;AAAA,MACzC;AAAA,IACF;AAGA,QAAI,YAAYD,UAAW,aAAa,QAAQ,GAAG;AACjD,YAAM,cAAc,MAAME;AAAAA,QACxB;AAAA,UACE;AAAA,UACA,YAAY,KAAK,aAAa,QAAQ;AAAA,QAAA;AAAA,QAExC;AAAA,MAAA;AAEF,aAAO,iBAAiB,YAAY;AACpC,UAAI,CAAC,YAAY,SAAS;AACxB,eAAO,OAAO,KAAK,GAAG,YAAY,MAAM,MAAM;AAAA,MAChD;AAAA,IACF;AAGA,QAAI,cAAc;AAChB,YAAM,eAAe,MAAMC,eAAgB;AAAA,QACzC;AAAA,QACA,uBAAuB;AAAA,QACvB,mBAAmB;AAAA,MAAA,CACpB;AACD,aAAO,kBAAkB,aAAa,WAAW,aAAa;AAAA,IAChE;AAEA,OAAG,MAAA;AACH,WAAO,UAAU,OAAO,OAAO,WAAW;AAAA,EAE5C,SAAS,OAAO;AACd,WAAO,UAAU;AACjB,WAAO,OAAO,KAAK,OAAO,KAAK,CAAC;AAAA,EAClC;AAEA,SAAO;AACT;"}
1
+ {"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * Knowledge Graph Agent\n *\n * NPM library for creating and managing knowledge graphs for Claude Code.\n *\n * @packageDocumentation\n */\n\n// Internal imports for quickInit\nimport { createDatabase as _createDatabase } from './core/database.js';\nimport { initDocs as _initDocs, docsExist as _docsExist } from './generators/docs-init.js';\nimport { generateAndSave as _generateAndSave } from './generators/graph-generator.js';\nimport { updateClaudeMd as _updateClaudeMd } from './generators/claude-md.js';\n\n// ============================================================================\n// Core\n// ============================================================================\n\nexport {\n KnowledgeGraphManager,\n createKnowledgeGraph,\n} from './core/graph.js';\n\nexport {\n KnowledgeGraphDatabase,\n createDatabase,\n} from './core/database.js';\n\n// Cache exports\nexport {\n ShadowCache,\n createShadowCache,\n loadShadowCache,\n} from './core/cache.js';\n\nexport type {\n FileMetadata,\n FileType,\n ChangeType,\n FileChange,\n CacheStats,\n ShadowCacheOptions,\n} from './core/cache.js';\n\nexport type {\n // Node types\n NodeType,\n NodeStatus,\n NodeLink,\n NodeFrontmatter,\n KnowledgeNode,\n\n // Graph types\n GraphEdge,\n GraphMetadata,\n GraphStats,\n KnowledgeGraph,\n\n // Configuration\n KGConfig,\n ConfigSchema,\n\n // Generator types\n GeneratorOptions,\n GeneratedDocument,\n DocsInitOptions,\n DocsInitResult,\n\n // Integration types\n MemoryEntry,\n SyncResult,\n\n // CLAUDE.md types\n ClaudeMdSection,\n ClaudeMdTemplate,\n ClaudeMdGeneratorOptions,\n} from './core/types.js';\n\n// ============================================================================\n// Generators\n// ============================================================================\n\nexport {\n generateGraph,\n generateAndSave,\n updateGraph,\n} from './generators/graph-generator.js';\n\nexport {\n initDocs,\n docsExist,\n getDocsPath,\n} from './generators/docs-init.js';\n\nexport {\n generateClaudeMd,\n updateClaudeMd,\n addSection,\n getSectionTemplate,\n listSectionTemplates,\n} from './generators/claude-md.js';\n\n// Conversion exports\nexport {\n convertDocs,\n addFrontmatter,\n validateFrontmatter,\n} from './generators/docs-convert.js';\n\nexport type {\n ConvertOptions,\n ConvertResult,\n FrontmatterOptions,\n FrontmatterResult,\n} from './generators/docs-convert.js';\n\n// Analyzer exports\nexport {\n analyzeDocs,\n} from './generators/docs-analyzer.js';\n\nexport type {\n AnalyzerOptions,\n AnalyzedDoc,\n AnalyzerResult,\n} from './generators/docs-analyzer.js';\n\n// ============================================================================\n// Integrations\n// ============================================================================\n\nexport {\n ClaudeFlowIntegration,\n createClaudeFlowIntegration,\n generateMcpConfig,\n} from './integrations/claude-flow.js';\n\n// ============================================================================\n// CLI\n// ============================================================================\n\nexport { createCLI } from './cli/index.js';\n\n// ============================================================================\n// Agents\n// ============================================================================\n\nexport {\n // Agent system core\n AgentType,\n AgentStatus,\n TaskPriority,\n MessageType,\n createMessageId,\n createTaskId,\n createAgentId,\n\n // Registry\n AgentRegistry,\n getRegistry,\n createRegistry,\n setDefaultRegistry,\n registerDefaultAgents,\n\n // Base Agent\n BaseAgent,\n createTask,\n isAgentResult,\n isAgentError,\n\n // Specialized Agents\n ResearcherAgent,\n CoderAgent,\n TesterAgent,\n AnalystAgent,\n ArchitectAgent,\n\n // Rules Engine\n RulesEngine,\n createRulesEngine,\n createRule,\n createConditionalRule,\n createFileChangeLogRule,\n createGraphUpdateNotificationRule,\n createAgentCompletionRule,\n} from './agents/index.js';\n\nexport type {\n // Agent types\n AgentConfig,\n ResearcherAgentConfig,\n CoderAgentConfig,\n TesterAgentConfig,\n AnalystAgentConfig,\n ArchitectAgentConfig,\n SpecializedAgentConfig,\n TaskInput,\n AgentTask,\n AgentResult as AgentSystemResult,\n AgentError,\n ExecutionMetrics,\n ResultArtifact,\n AgentMessage,\n TaskRequestMessage,\n TaskResponseMessage,\n StatusMessage,\n ErrorMessage,\n CoordinationMessage,\n AgentMessageUnion,\n AgentState,\n AgentFactory,\n AgentInstance,\n AgentCapability,\n AgentHealthCheck,\n RegistryOptions,\n SpawnOptions,\n\n // Rules Engine types\n RuleTrigger,\n RulePriority,\n RuleExecutionStatus,\n RuleContext,\n RuleCondition,\n RuleAction,\n AgentRule,\n RuleExecutionLog,\n RuleStatistics,\n EngineStatistics,\n RulesEngineConfig,\n} from './agents/index.js';\n\n// ============================================================================\n// Cultivation\n// ============================================================================\n\nexport {\n SeedGenerator,\n analyzeSeed,\n initPrimitives,\n DeepAnalyzer,\n createDeepAnalyzer,\n analyzeDeep,\n} from './cultivation/index.js';\n\nexport type {\n VaultContext,\n Ecosystem,\n DependencyType,\n ServiceType,\n DependencyInfo,\n ServiceInfo,\n SeedAnalysis,\n DocumentMetadata as CultivationDocumentMetadata,\n GeneratedDocument as CultivationGeneratedDocument,\n CultivationReport,\n CultivationOptions,\n GapAnalysis as CultivationGapAnalysis,\n InitPrimitivesResult,\n DeepAnalyzerOptions,\n AgentResult,\n DeepAnalysisResult,\n} from './cultivation/index.js';\n\n// ============================================================================\n// SOPs\n// ============================================================================\n\nexport {\n // Enums\n SOPCategory,\n ComplianceStatus,\n SOPPriority,\n IRBStatus,\n GraphLayer,\n // Registry\n getSOPById,\n getSOPsByCategory,\n getSOPsRequiringIRB,\n searchSOPs,\n getAllSOPs,\n getSopCount,\n getCategories,\n // Compliance\n checkCompliance,\n checkSOPCompliance,\n meetsMinimumCompliance,\n // Gap Analysis\n analyzeGaps,\n getGapsForSOP,\n getQuickWins,\n calculateProgress,\n // Overlay Management\n createMultiLayerGraph,\n addProjectLayer,\n addComplianceOverlay,\n filterByLayer,\n filterByComplianceStatus,\n getComplianceSummary,\n getGapNodes,\n toggleLayerVisibility,\n exportToVisualizationFormat,\n createSOPFocusedSubgraph,\n} from './sops/index.js';\n\nexport type {\n // SOP types\n SOPRequirement,\n SOPCheckpoint,\n SOPDefinition,\n SOPAssessment,\n ComplianceGap,\n LayerDefinition,\n LayerNode,\n LayerEdge,\n MultiLayerGraph,\n ComplianceReport,\n SOPFrontmatter,\n SOPConfig,\n // Compliance types\n ComplianceCheckOptions,\n ComplianceCheckResult,\n EvidenceItem,\n // Gap types\n GapAnalysisOptions,\n GapAnalysisResult,\n GapSummary,\n RemediationRoadmap,\n RemediationPhase,\n GapDependency,\n // Overlay types\n OverlayManagerOptions,\n NodeStyleConfig,\n} from './sops/index.js';\n\n// ============================================================================\n// Workflows\n// ============================================================================\n\nexport {\n WorkflowStatus,\n WorkflowRegistry,\n createWorkflowRegistry,\n} from './workflows/index.js';\n\nexport type {\n StepContext,\n StepHandler,\n RollbackHandler,\n WorkflowStep,\n WorkflowDefinition,\n StepExecution,\n WorkflowExecution,\n WorkflowResult,\n WorkflowExecutionStats,\n WorkflowRegistryOptions,\n WorkflowListOptions,\n ExecutionHistoryOptions,\n WorkflowEventType,\n WorkflowEvent,\n WorkflowEventListener,\n} from './workflows/index.js';\n\n// ============================================================================\n// Memory\n// ============================================================================\n\nexport {\n VaultMemorySync,\n createVaultMemorySync,\n} from './memory/index.js';\n\nexport type {\n SyncDirection,\n ConflictStrategy,\n SyncStatus,\n MemoryNode,\n SyncConflict,\n VaultSyncOptions,\n SyncOperationResult,\n FullSyncResult,\n} from './memory/index.js';\n\n// ============================================================================\n// Utils\n// ============================================================================\n\nexport {\n // Error Taxonomy\n ErrorCategory,\n ErrorSeverity,\n classifyError,\n isRetryableError,\n isTransientError,\n isRateLimitError,\n isPermanentError,\n KnowledgeGraphError,\n createValidationError,\n createConfigurationError,\n createResourceError,\n // Error Recovery\n withRetry,\n retry,\n withFallback,\n withCircuitBreaker,\n retryable,\n calculateBackoff,\n sleep,\n CircuitBreaker,\n CircuitState,\n RetriesExhaustedError,\n CircuitOpenError,\n // Logger\n Logger,\n LogLevel,\n getLogger,\n createLogger,\n setDefaultLogger,\n parseLogLevel,\n createProgressLogger,\n} from './utils/index.js';\n\nexport type {\n ClassifiedError,\n RetryOptions,\n RetryResult,\n FallbackOptions,\n CircuitBreakerOptions,\n LoggerOptions,\n LogEntry,\n ProgressLogger,\n} from './utils/index.js';\n\n// ============================================================================\n// MCP Server\n// ============================================================================\n\nexport {\n KnowledgeGraphMCPServer,\n createMCPServer,\n runServer,\n initializeTools,\n registerTool,\n getToolHandler,\n getToolDefinition,\n getToolDefinitions,\n getToolCategories,\n handleToolCall,\n handleError,\n createErrorResult,\n createSuccessResult,\n} from './mcp-server/index.js';\n\nexport type {\n MCPServerConfig,\n ServerHealth,\n ToolCategory,\n ToolHandler,\n ToolHandlerEntry,\n ToolResult,\n ToolContext,\n ToolInputSchema,\n ToolDefinition,\n GraphQueryParams,\n GraphNodeResult,\n AgentInvokeParams,\n AgentResult as MCPAgentResult,\n WorkflowParams,\n WorkflowResult as MCPWorkflowResult,\n MemoryParams,\n MemoryResult,\n} from './mcp-server/index.js';\n\n// ============================================================================\n// Server Infrastructure\n// ============================================================================\n\nexport {\n // Server Manager\n ServerManager,\n createServerManager,\n\n // Shared Services\n SharedServices,\n createSharedServices,\n getSharedServices,\n createDefaultConfig,\n\n // Service Container\n ServiceContainer,\n createServiceContainer,\n getServiceContainer,\n hasServiceContainer,\n shutdownServiceContainer,\n\n // TypedEventBus\n TypedEventBus,\n createTypedEventBus,\n createSubscriptionIterator,\n createNodeTypeFilter,\n createSourceFilter,\n\n // Constants\n DEFAULT_GRAPHQL_PORT,\n DEFAULT_DASHBOARD_PORT,\n DEFAULT_DATABASE_PATH,\n SHUTDOWN_TIMEOUT,\n HEALTH_CHECK_INTERVAL,\n} from './server/index.js';\n\nexport type {\n // Configuration types\n ServerConfig,\n MCPServerConfig as ServerMCPConfig,\n GraphQLServerConfig,\n DashboardServerConfig,\n DatabaseServerConfig,\n CacheServerConfig,\n\n // State types\n ServerStatus,\n ServerState,\n ServerManagerState,\n\n // Health types\n ComponentHealth as ServerComponentHealth,\n HealthStatus as ServerHealthStatus,\n\n // Event types\n ServerEventType,\n ServerEvent,\n ServerEventListener,\n\n // Instance types\n HTTPServerInstance,\n MCPServerInstance,\n\n // CLI types\n ServeCommandOptions,\n ParsedServeOptions,\n\n // Interface types\n ISharedServices,\n IServerManager,\n\n // Service Container types\n ServiceInitState,\n ServiceDependency,\n ContainerConfig,\n ContainerEventType,\n\n // TypedEventBus types\n EventType as ServerEventTypeEnum,\n EventDataMap,\n EventEntry,\n EventFilter,\n EventHandler as ServerEventHandler,\n Unsubscribe,\n NodeEventData,\n RelationEventData,\n AgentEventData,\n WorkflowEventData,\n PluginEventData,\n HealthEventData,\n CacheEvictionData,\n EventTypeMetrics,\n EventBusMetrics,\n ITypedEventBus,\n TypedEventBusOptions,\n} from './server/index.js';\n\n// ============================================================================\n// GraphQL\n// ============================================================================\n\nexport {\n // Server\n createGraphQLServer,\n\n // Context\n createContextFactory,\n hasScope,\n requireAuth,\n requireScope,\n isGraphQLContext,\n\n // Scalars\n DateTimeScalar,\n JSONScalar,\n UUIDScalar,\n FilePathScalar,\n customScalars,\n scalarTypeDefs,\n} from './graphql/index.js';\n\nexport type {\n // Server types\n GraphQLServerConfig as GraphQLServerOptions,\n GraphQLServerInstance,\n CorsConfig,\n HealthCheckResponse as GraphQLHealthCheckResponse,\n\n // Context types\n GraphQLContext,\n AuthResult,\n RequestMeta,\n RequestUtils,\n Services as GraphQLServices,\n ContextFactoryConfig,\n} from './graphql/index.js';\n\n// ============================================================================\n// Services\n// ============================================================================\n\nexport {\n ServiceManager,\n createServiceManager,\n FileWatcherService,\n} from './services/index.js';\n\nexport type {\n ServiceStatus,\n ServiceType as ManagerServiceType,\n ServiceConfig,\n ServiceState,\n ServiceMetrics,\n ServiceHandler,\n} from './services/index.js';\n\n// ============================================================================\n// Config\n// ============================================================================\n\nexport {\n ConfigManager,\n createConfigManager,\n getDefaultConfig,\n} from './config/index.js';\n\nexport type {\n KGConfiguration,\n DatabaseConfig,\n CacheConfig,\n AgentConfig as ConfigAgentConfig,\n ServicesConfig,\n LoggingConfig,\n ConfigMigration,\n} from './config/index.js';\n\n// ============================================================================\n// Health\n// ============================================================================\n\nexport {\n HealthMonitor,\n createHealthMonitor,\n createDatabaseCheck,\n createCacheCheck,\n createMemoryCheck,\n createDiskCheck,\n} from './health/index.js';\n\nexport type {\n HealthStatus,\n ComponentHealth,\n SystemHealth,\n MemoryMetrics,\n PerformanceMetrics,\n HealthCheck,\n HealthMonitorConfig,\n} from './health/index.js';\n\n// ============================================================================\n// Chunking\n// ============================================================================\n\nexport {\n Chunker,\n createChunker,\n chunkDocument,\n} from './chunking/index.js';\n\nexport type {\n ChunkStrategy,\n ChunkOptions,\n Chunk,\n ChunkMetadata,\n ChunkResult,\n} from './chunking/index.js';\n\n// ============================================================================\n// Recovery\n// ============================================================================\n\nexport {\n BackupManager,\n createBackupManager,\n IntegrityChecker,\n createIntegrityChecker,\n checkDatabaseIntegrity,\n} from './recovery/index.js';\n\nexport type {\n BackupConfig,\n BackupInfo,\n RestoreResult,\n RecoveryOptions,\n IntegrityCheckResult,\n TableIntegrity,\n} from './recovery/index.js';\n\n// ============================================================================\n// Advanced Caching\n// ============================================================================\n\nexport {\n AdvancedCache,\n createAdvancedCache,\n} from './caching/index.js';\n\nexport type {\n EvictionPolicy,\n CacheEntry,\n CacheConfig as AdvancedCacheConfig,\n CacheStats as AdvancedCacheStats,\n} from './caching/index.js';\n\n// ============================================================================\n// Reasoning\n// ============================================================================\n\nexport {\n DecisionTracker,\n createDecisionTracker,\n getDecisionTracker,\n} from './reasoning/index.js';\n\nexport type {\n DecisionType,\n ConfidenceLevel,\n Decision,\n DecisionContext,\n Alternative,\n DecisionOutcome,\n ReasoningChain,\n} from './reasoning/index.js';\n\n// ============================================================================\n// Workflow DevKit\n// ============================================================================\n\nexport {\n createWorkflowConfig,\n validateWorkflowConfig,\n createPostgresConfig,\n createVercelConfig,\n createLocalConfig,\n defaultConfig as defaultWorkflowConfig,\n} from './workflow/index.js';\n\nexport type {\n // Configuration types\n WorkflowConfig as WorkflowDevKitConfig,\n PostgresPoolConfig,\n PostgresWorldConfig,\n VercelWorldConfig,\n LocalWorldConfig,\n // World state types\n WorldState,\n // Event types\n NodeUpdateEvent,\n GapDetectedEvent,\n WorkflowCompleteEvent,\n WorkflowRunMetadata as DevKitRunMetadata,\n // Task types\n TaskSpec,\n DocumentGap,\n GapAnalysis as DevKitGapAnalysis,\n // GOAP types\n GOAPAction,\n GOAPGoal,\n GOAPPlanStep,\n GOAPPlan,\n GOAPPlanExtended,\n PlanExecutionResult,\n ReadinessEvaluation,\n // Execution types\n WorkflowExecutionOptions as DevKitExecutionOptions,\n WorkflowExecutionResult as DevKitExecutionResult,\n // Hook types\n HookHandler,\n HookRegistration,\n} from './workflow/index.js';\n\n// ============================================================================\n// Plugins\n// ============================================================================\n\n// Plugin System - Core exports (includes types, manager, analyzers)\n// This re-exports everything from plugins/index.js including:\n// - Types: PluginType, PluginHook, PluginStatus, PluginCapability, PluginDependency,\n// PluginConfigSchema, KGPluginManifest, PluginMetadata, KGPlugin, AnalyzerPlugin,\n// PluginContext, PluginAPI, PluginCommand, PluginEventEmitter, PluginLoader,\n// PluginRegistry, PluginManager, PluginManagerConfig, DiscoveredPlugin,\n// PluginLoadOptions, PluginLoadResult, PluginRegistryEvents, AnalysisInput,\n// AnalysisResult, AnalysisStreamChunk, PluginFactory, PluginConstructor,\n// PluginModuleExport, PluginConfigType\n// - Manager: PluginManagerImpl, PluginRegistryImpl, PluginLoaderImpl,\n// createPluginManager, createPluginRegistry, createPluginLoader,\n// createDefaultPluginManager\n// - Analyzers: CodeComplexityPlugin, DependencyHealthPlugin, and related exports\nexport * from './plugins/index.js';\n\n// ============================================================================\n// Equilibrium (SPEC-006a)\n// ============================================================================\n\nexport {\n AgentEquilibriumSelector,\n createAgentEquilibriumSelector,\n createEquilibriumTask,\n} from './equilibrium/index.js';\n\nexport type {\n AgentParticipation,\n EquilibriumConfig,\n EquilibriumResult,\n Task as EquilibriumTask,\n} from './equilibrium/index.js';\n\n// ============================================================================\n// Quick Start\n// ============================================================================\n\n/**\n * Quick start function for programmatic usage\n *\n * @example\n * ```typescript\n * import { quickInit } from '@weave-nn/knowledge-graph-agent';\n *\n * await quickInit({\n * projectRoot: '/path/to/project',\n * docsPath: 'docs',\n * });\n * ```\n */\nexport async function quickInit(options: {\n projectRoot: string;\n docsPath?: string;\n generateGraph?: boolean;\n updateClaudeMd?: boolean;\n}): Promise<{\n success: boolean;\n docsCreated: boolean;\n graphGenerated: boolean;\n claudeMdUpdated: boolean;\n errors: string[];\n}> {\n const {\n projectRoot,\n docsPath = 'docs',\n generateGraph: genGraph = true,\n updateClaudeMd: updateClaude = true,\n } = options;\n\n const result = {\n success: true,\n docsCreated: false,\n graphGenerated: false,\n claudeMdUpdated: false,\n errors: [] as string[],\n };\n\n try {\n // Initialize docs if needed\n const { existsSync, mkdirSync, writeFileSync } = await import('fs');\n const { join } = await import('path');\n\n // Create .kg directory\n const kgDir = join(projectRoot, '.kg');\n if (!existsSync(kgDir)) {\n mkdirSync(kgDir, { recursive: true });\n }\n\n // Initialize database\n const dbPath = join(kgDir, 'knowledge.db');\n const db = _createDatabase(dbPath);\n db.setMetadata('initialized', new Date().toISOString());\n\n // Initialize docs\n if (!_docsExist(projectRoot, docsPath)) {\n const docsResult = await _initDocs({\n projectRoot,\n docsPath,\n includeExamples: true,\n detectFramework: true,\n });\n result.docsCreated = docsResult.success;\n if (!docsResult.success) {\n result.errors.push(...docsResult.errors);\n }\n }\n\n // Generate graph\n if (genGraph && _docsExist(projectRoot, docsPath)) {\n const graphResult = await _generateAndSave(\n {\n projectRoot,\n outputPath: join(projectRoot, docsPath),\n },\n dbPath\n );\n result.graphGenerated = graphResult.success;\n if (!graphResult.success) {\n result.errors.push(...graphResult.stats.errors);\n }\n }\n\n // Update CLAUDE.md\n if (updateClaude) {\n const claudeResult = await _updateClaudeMd({\n projectRoot,\n includeKnowledgeGraph: true,\n includeClaudeFlow: true,\n });\n result.claudeMdUpdated = claudeResult.created || claudeResult.updated;\n }\n\n db.close();\n result.success = result.errors.length === 0;\n\n } catch (error) {\n result.success = false;\n result.errors.push(String(error));\n }\n\n return result;\n}\n"],"names":["_createDatabase","_docsExist","_initDocs","_generateAndSave","_updateClaudeMd"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+0BA,eAAsB,UAAU,SAW7B;AACD,QAAM;AAAA,IACJ;AAAA,IACA,WAAW;AAAA,IACX,eAAe,WAAW;AAAA,IAC1B,gBAAgB,eAAe;AAAA,EAAA,IAC7B;AAEJ,QAAM,SAAS;AAAA,IACb,SAAS;AAAA,IACT,aAAa;AAAA,IACb,gBAAgB;AAAA,IAChB,iBAAiB;AAAA,IACjB,QAAQ,CAAA;AAAA,EAAC;AAGX,MAAI;AAEF,UAAM,EAAE,YAAY,WAAW,kBAAkB,MAAM,OAAO,IAAI;AAClE,UAAM,EAAE,KAAA,IAAS,MAAM,OAAO,MAAM;AAGpC,UAAM,QAAQ,KAAK,aAAa,KAAK;AACrC,QAAI,CAAC,WAAW,KAAK,GAAG;AACtB,gBAAU,OAAO,EAAE,WAAW,KAAA,CAAM;AAAA,IACtC;AAGA,UAAM,SAAS,KAAK,OAAO,cAAc;AACzC,UAAM,KAAKA,eAAgB,MAAM;AACjC,OAAG,YAAY,gBAAe,oBAAI,KAAA,GAAO,aAAa;AAGtD,QAAI,CAACC,UAAW,aAAa,QAAQ,GAAG;AACtC,YAAM,aAAa,MAAMC,SAAU;AAAA,QACjC;AAAA,QACA;AAAA,QACA,iBAAiB;AAAA,QACjB,iBAAiB;AAAA,MAAA,CAClB;AACD,aAAO,cAAc,WAAW;AAChC,UAAI,CAAC,WAAW,SAAS;AACvB,eAAO,OAAO,KAAK,GAAG,WAAW,MAAM;AAAA,MACzC;AAAA,IACF;AAGA,QAAI,YAAYD,UAAW,aAAa,QAAQ,GAAG;AACjD,YAAM,cAAc,MAAME;AAAAA,QACxB;AAAA,UACE;AAAA,UACA,YAAY,KAAK,aAAa,QAAQ;AAAA,QAAA;AAAA,QAExC;AAAA,MAAA;AAEF,aAAO,iBAAiB,YAAY;AACpC,UAAI,CAAC,YAAY,SAAS;AACxB,eAAO,OAAO,KAAK,GAAG,YAAY,MAAM,MAAM;AAAA,MAChD;AAAA,IACF;AAGA,QAAI,cAAc;AAChB,YAAM,eAAe,MAAMC,eAAgB;AAAA,QACzC;AAAA,QACA,uBAAuB;AAAA,QACvB,mBAAmB;AAAA,MAAA,CACpB;AACD,aAAO,kBAAkB,aAAa,WAAW,aAAa;AAAA,IAChE;AAEA,OAAG,MAAA;AACH,WAAO,UAAU,OAAO,OAAO,WAAW;AAAA,EAE5C,SAAS,OAAO;AACd,WAAO,UAAU;AACjB,WAAO,OAAO,KAAK,OAAO,KAAK,CAAC;AAAA,EAClC;AAEA,SAAO;AACT;"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Inference Module
3
+ *
4
+ * Provides model selection and inference utilities for the knowledge graph agent.
5
+ *
6
+ * @module inference
7
+ */
8
+ export { getModelRouter, resetModelRouter, selectModelForAgent, selectModelForTask, getCheapestModel, getBestQualityModel, getCodeModel, getReasoningModel, recordModelUsage, getCostSavingsReport, getAvailableModels, hasLocalModels, type RoutingDecision, type TaskRequirements, type ModelRouterConfig, type ModelInfo, } from './model-selection.js';
9
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inference/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,SAAS,GACf,MAAM,sBAAsB,CAAC"}
@@ -0,0 +1,131 @@
1
+ /**
2
+ * Model Selection Integration Layer
3
+ *
4
+ * High-level API for selecting optimal models for agent tasks.
5
+ * Integrates with the ModelRouterAdapter for cost-optimized routing.
6
+ *
7
+ * @module inference/model-selection
8
+ */
9
+ import { ModelRouterAdapter, type RoutingDecision, type ModelRouterConfig, type ModelInfo } from '../integrations/agentic-flow/adapters/model-router-adapter.js';
10
+ import { AgentType } from '../agents/types.js';
11
+ /**
12
+ * Get or create the global model router instance
13
+ *
14
+ * @param config - Optional configuration (only used on first call)
15
+ * @returns The global ModelRouterAdapter instance
16
+ */
17
+ export declare function getModelRouter(config?: Partial<ModelRouterConfig>): Promise<ModelRouterAdapter>;
18
+ /**
19
+ * Reset the global router (useful for testing)
20
+ */
21
+ export declare function resetModelRouter(): void;
22
+ /**
23
+ * Select the optimal model for an agent type
24
+ *
25
+ * @param agentType - The type of agent that needs a model
26
+ * @param estimatedTokens - Estimated token count for the task
27
+ * @returns Routing decision with selected model
28
+ *
29
+ * @example
30
+ * ```typescript
31
+ * const decision = await selectModelForAgent(AgentType.CODER, 2000);
32
+ * console.log(`Using ${decision.model.name} - ${decision.reason}`);
33
+ * ```
34
+ */
35
+ export declare function selectModelForAgent(agentType: AgentType, estimatedTokens?: number): Promise<RoutingDecision>;
36
+ /**
37
+ * Select the optimal model for a specific task
38
+ *
39
+ * @param taskDescription - Description of the task
40
+ * @param requirements - Task requirements
41
+ * @returns Routing decision with selected model
42
+ *
43
+ * @example
44
+ * ```typescript
45
+ * const decision = await selectModelForTask(
46
+ * 'Generate unit tests for auth module',
47
+ * { codeGeneration: true, maxCost: 0.03 }
48
+ * );
49
+ * ```
50
+ */
51
+ export declare function selectModelForTask(taskDescription: string, requirements: {
52
+ codeGeneration?: boolean;
53
+ codeAnalysis?: boolean;
54
+ textGeneration?: boolean;
55
+ reasoning?: boolean;
56
+ maxCost?: number;
57
+ minQuality?: number;
58
+ preferLocal?: boolean;
59
+ }): Promise<RoutingDecision>;
60
+ /**
61
+ * Get the cheapest model that meets minimum quality
62
+ *
63
+ * @param minQuality - Minimum quality threshold (0-1)
64
+ * @returns Routing decision with cheapest qualifying model
65
+ */
66
+ export declare function getCheapestModel(minQuality?: number): Promise<RoutingDecision>;
67
+ /**
68
+ * Get the best quality model within budget
69
+ *
70
+ * @param maxCost - Maximum acceptable cost
71
+ * @returns Routing decision with highest quality model in budget
72
+ */
73
+ export declare function getBestQualityModel(maxCost?: number): Promise<RoutingDecision>;
74
+ /**
75
+ * Get models optimized for code tasks
76
+ *
77
+ * @param estimatedTokens - Estimated token count
78
+ * @param maxCost - Maximum acceptable cost
79
+ * @returns Routing decision optimized for coding
80
+ */
81
+ export declare function getCodeModel(estimatedTokens?: number, maxCost?: number): Promise<RoutingDecision>;
82
+ /**
83
+ * Get models optimized for reasoning tasks
84
+ *
85
+ * @param estimatedTokens - Estimated token count
86
+ * @param maxCost - Maximum acceptable cost
87
+ * @returns Routing decision optimized for reasoning
88
+ */
89
+ export declare function getReasoningModel(estimatedTokens?: number, maxCost?: number): Promise<RoutingDecision>;
90
+ /**
91
+ * Record model usage for learning and analytics
92
+ *
93
+ * @param modelId - Model that was used
94
+ * @param cost - Actual cost incurred
95
+ * @param latencyMs - Response latency
96
+ * @param tokens - Actual tokens used
97
+ * @param success - Whether request succeeded
98
+ */
99
+ export declare function recordModelUsage(modelId: string, cost: number, latencyMs: number, tokens?: number, success?: boolean): Promise<void>;
100
+ /**
101
+ * Get cost savings report
102
+ *
103
+ * @returns Report with total costs and savings
104
+ */
105
+ export declare function getCostSavingsReport(): Promise<{
106
+ totalCost: number;
107
+ estimatedFullPriceCost: number;
108
+ savings: number;
109
+ savingsPercentage: number;
110
+ modelBreakdown: Array<{
111
+ modelId: string;
112
+ modelName: string;
113
+ calls: number;
114
+ cost: number;
115
+ avgLatency: number;
116
+ }>;
117
+ }>;
118
+ /**
119
+ * Get all available models
120
+ *
121
+ * @returns List of available models
122
+ */
123
+ export declare function getAvailableModels(): Promise<ModelInfo[]>;
124
+ /**
125
+ * Check if local models are available
126
+ *
127
+ * @returns True if local models are available
128
+ */
129
+ export declare function hasLocalModels(): Promise<boolean>;
130
+ export type { RoutingDecision, TaskRequirements, ModelRouterConfig, ModelInfo, } from '../integrations/agentic-flow/adapters/model-router-adapter.js';
131
+ //# sourceMappingURL=model-selection.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-selection.d.ts","sourceRoot":"","sources":["../../src/inference/model-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,kBAAkB,EAElB,KAAK,eAAe,EAEpB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACf,MAAM,+DAA+D,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAQ/C;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,OAAO,CAAC,kBAAkB,CAAC,CAK7B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,SAAS,EACpB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE;IACZ,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,OAAO,CAAC,eAAe,CAAC,CAoB1B;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,GAAE,MAAY,GACvB,OAAO,CAAC,eAAe,CAAC,CAU1B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,MAAa,GACrB,OAAO,CAAC,eAAe,CAAC,CAU1B;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,eAAe,GAAE,MAAa,EAC9B,OAAO,GAAE,MAAa,GACrB,OAAO,CAAC,eAAe,CAAC,CAU1B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,eAAe,GAAE,MAAa,EAC9B,OAAO,GAAE,MAAa,GACrB,OAAO,CAAC,eAAe,CAAC,CAU1B;AAMD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,KAAK,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ,CAAC,CAGD;AAMD;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAG/D;AAED;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAIvD;AAMD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,GACV,MAAM,+DAA+D,CAAC"}
@@ -0,0 +1,265 @@
1
+ /**
2
+ * Agent Booster Adapter
3
+ *
4
+ * Integrates Agent Booster for 352x faster code transformations.
5
+ * Provides template matching, similarity matching, and batch processing
6
+ * capabilities for the OptimizerAgent.
7
+ *
8
+ * @module integrations/agentic-flow/adapters/agent-booster-adapter
9
+ */
10
+ import { BaseAdapter } from './base-adapter.js';
11
+ /**
12
+ * Configuration for Agent Booster adapter
13
+ */
14
+ export interface AgentBoosterConfig {
15
+ /** Enable template-based transformations */
16
+ enableTemplates: boolean;
17
+ /** Enable similarity-based matching */
18
+ enableSimilarityMatching: boolean;
19
+ /** Minimum confidence threshold for accepting transforms */
20
+ confidenceThreshold: number;
21
+ /** Maximum code chunk size in characters */
22
+ maxChunkSize: number;
23
+ }
24
+ /**
25
+ * Supported programming languages for transformation
26
+ */
27
+ export type SupportedLanguage = 'javascript' | 'typescript' | 'python' | 'rust' | 'go' | 'java' | 'c' | 'cpp';
28
+ /**
29
+ * Request for a single code transformation
30
+ */
31
+ export interface TransformRequest {
32
+ /** Source code to transform */
33
+ code: string;
34
+ /** Natural language instruction for transformation */
35
+ instruction: string;
36
+ /** Programming language of the code */
37
+ language: SupportedLanguage;
38
+ }
39
+ /**
40
+ * Result of a code transformation
41
+ */
42
+ export interface TransformResult {
43
+ /** Whether the transformation succeeded */
44
+ success: boolean;
45
+ /** Original code before transformation */
46
+ originalCode: string;
47
+ /** Transformed code (same as original if failed) */
48
+ transformedCode: string;
49
+ /** Confidence score (0-1) */
50
+ confidence: number;
51
+ /** Latency in milliseconds */
52
+ latencyMs: number;
53
+ /** Type of transformation applied */
54
+ transformType: 'template' | 'similarity' | 'failed';
55
+ /** List of changes made */
56
+ changes: Array<{
57
+ type: string;
58
+ line: number;
59
+ description: string;
60
+ }>;
61
+ }
62
+ /**
63
+ * Request for batch transformation of multiple files
64
+ */
65
+ export interface BatchTransformRequest {
66
+ /** File path */
67
+ path: string;
68
+ /** Source code content */
69
+ code: string;
70
+ /** List of transformation instructions to apply sequentially */
71
+ instructions: string[];
72
+ }
73
+ /**
74
+ * Result of batch transformation
75
+ */
76
+ export interface BatchTransformResult {
77
+ /** Total number of files processed */
78
+ totalFiles: number;
79
+ /** Number of successful transformations */
80
+ successCount: number;
81
+ /** Number of failed transformations */
82
+ failedCount: number;
83
+ /** Total processing time in milliseconds */
84
+ totalLatencyMs: number;
85
+ /** Results for each file */
86
+ results: Array<{
87
+ path: string;
88
+ success: boolean;
89
+ transformedCode?: string;
90
+ error?: string;
91
+ }>;
92
+ }
93
+ /**
94
+ * Interface for the external agent-booster module
95
+ */
96
+ interface AgentBoosterModule {
97
+ AgentBooster: new (config: {
98
+ enableTemplates: boolean;
99
+ enableSimilarityMatching: boolean;
100
+ }) => {
101
+ transform(req: {
102
+ code: string;
103
+ instruction: string;
104
+ language: string;
105
+ }): Promise<{
106
+ success: boolean;
107
+ code?: string;
108
+ confidence?: number;
109
+ changes?: Array<{
110
+ type: string;
111
+ line: number;
112
+ description: string;
113
+ }>;
114
+ }>;
115
+ };
116
+ version?: string;
117
+ }
118
+ /**
119
+ * Agent Booster Adapter
120
+ *
121
+ * Provides integration with the agent-booster library for high-speed
122
+ * code transformations. Falls back to a no-op implementation when
123
+ * the library is not available.
124
+ *
125
+ * Key Features:
126
+ * - Template matching for instant transformations (~0-1ms)
127
+ * - Similarity matching for complex transformations (~1-13ms)
128
+ * - Batch processing (~1000 files/second)
129
+ * - Graceful fallback when agent-booster is unavailable
130
+ *
131
+ * @example
132
+ * ```typescript
133
+ * const adapter = await createAgentBoosterAdapter();
134
+ *
135
+ * const result = await adapter.transform({
136
+ * code: 'const x = data.value',
137
+ * instruction: 'Add null checks',
138
+ * language: 'typescript',
139
+ * });
140
+ *
141
+ * console.log(`Latency: ${result.latencyMs}ms`); // ~1ms
142
+ * ```
143
+ */
144
+ export declare class AgentBoosterAdapter extends BaseAdapter<AgentBoosterModule> {
145
+ private config;
146
+ private booster;
147
+ private templatePatterns;
148
+ private adapterVersion?;
149
+ constructor(config?: Partial<AgentBoosterConfig>);
150
+ /**
151
+ * Get the feature name for this adapter
152
+ */
153
+ getFeatureName(): string;
154
+ /**
155
+ * Check if the adapter is available and initialized
156
+ */
157
+ isAvailable(): boolean;
158
+ /**
159
+ * Check if in fallback mode (initialized but module not available)
160
+ */
161
+ isFallbackMode(): boolean;
162
+ /**
163
+ * Get the version of the underlying module
164
+ */
165
+ getVersion(): string | undefined;
166
+ /**
167
+ * Initialize the adapter
168
+ */
169
+ initialize(): Promise<void>;
170
+ /**
171
+ * Transform code using Agent Booster
172
+ *
173
+ * Average latency: 1ms (vs 352ms with LLM-based transformation)
174
+ *
175
+ * @param request - Transformation request
176
+ * @returns Transformation result with timing
177
+ */
178
+ transform(request: TransformRequest): Promise<TransformResult>;
179
+ /**
180
+ * Batch transform multiple files
181
+ *
182
+ * Processes approximately 1000 files per second using parallel execution.
183
+ *
184
+ * @param requests - Array of batch transform requests
185
+ * @returns Batch transformation results
186
+ */
187
+ batchTransform(requests: BatchTransformRequest[]): Promise<BatchTransformResult>;
188
+ /**
189
+ * Apply a specific optimization type to code
190
+ *
191
+ * @param code - Source code to optimize
192
+ * @param optimizationType - Type of optimization to apply
193
+ * @param language - Programming language
194
+ * @returns Transformation result
195
+ */
196
+ applyOptimization(code: string, optimizationType: 'loop' | 'async' | 'memory' | 'general', language?: SupportedLanguage): Promise<TransformResult>;
197
+ /**
198
+ * Get current configuration
199
+ */
200
+ getConfig(): Readonly<AgentBoosterConfig>;
201
+ /**
202
+ * Try to match a known template pattern for instant transformation
203
+ */
204
+ private tryTemplateMatch;
205
+ /**
206
+ * Wrap code with try-catch block
207
+ */
208
+ private wrapWithTryCatch;
209
+ /**
210
+ * Add null checks using optional chaining
211
+ */
212
+ private addNullChecks;
213
+ /**
214
+ * Convert promise .then() to async/await
215
+ */
216
+ private convertToAsync;
217
+ /**
218
+ * Add error handling to functions
219
+ */
220
+ private addErrorHandling;
221
+ /**
222
+ * Add type annotations to TypeScript code
223
+ */
224
+ private addTypeAnnotations;
225
+ /**
226
+ * Detect language from file path
227
+ */
228
+ private detectLanguage;
229
+ /**
230
+ * Create a failed result
231
+ */
232
+ private createFailedResult;
233
+ /**
234
+ * Initialize template patterns for quick matching
235
+ */
236
+ private initializeTemplates;
237
+ /**
238
+ * Create fallback booster for when agent-booster module is not available
239
+ */
240
+ private createFallbackBooster;
241
+ }
242
+ /**
243
+ * Create and initialize an Agent Booster adapter
244
+ *
245
+ * @param config - Optional configuration overrides
246
+ * @returns Initialized adapter instance
247
+ *
248
+ * @example
249
+ * ```typescript
250
+ * const adapter = await createAgentBoosterAdapter({
251
+ * confidenceThreshold: 0.8,
252
+ * });
253
+ *
254
+ * if (adapter.isAvailable()) {
255
+ * const result = await adapter.transform({
256
+ * code: 'const x = obj.value',
257
+ * instruction: 'Add null checks',
258
+ * language: 'typescript',
259
+ * });
260
+ * }
261
+ * ```
262
+ */
263
+ export declare function createAgentBoosterAdapter(config?: Partial<AgentBoosterConfig>): Promise<AgentBoosterAdapter>;
264
+ export {};
265
+ //# sourceMappingURL=agent-booster-adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-booster-adapter.d.ts","sourceRoot":"","sources":["../../../../src/integrations/agentic-flow/adapters/agent-booster-adapter.ts"],"names":[],"mappings":"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"}