@supernal/interface 1.0.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 (519) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +165 -0
  3. package/dist/cjs/names/API.js +104 -0
  4. package/dist/cjs/names/API.js.map +1 -0
  5. package/dist/cjs/names/Components.js +104 -0
  6. package/dist/cjs/names/Components.js.map +1 -0
  7. package/dist/cjs/names/Containers.js +99 -0
  8. package/dist/cjs/names/Containers.js.map +1 -0
  9. package/dist/cjs/names/Functions.js +114 -0
  10. package/dist/cjs/names/Functions.js.map +1 -0
  11. package/dist/cjs/names/index.js +118 -0
  12. package/dist/cjs/names/index.js.map +1 -0
  13. package/dist/cjs/src/adapters/ChatUIProvider.js +176 -0
  14. package/dist/cjs/src/adapters/ChatUIProvider.js.map +1 -0
  15. package/dist/cjs/src/adapters/bridge.js +225 -0
  16. package/dist/cjs/src/adapters/bridge.js.map +1 -0
  17. package/dist/cjs/src/adapters/copilotkit/CopilotKitAdapter.js +289 -0
  18. package/dist/cjs/src/adapters/copilotkit/CopilotKitAdapter.js.map +1 -0
  19. package/dist/cjs/src/adapters/copilotkit/index.js +10 -0
  20. package/dist/cjs/src/adapters/copilotkit/index.js.map +1 -0
  21. package/dist/cjs/src/adapters/index.js +63 -0
  22. package/dist/cjs/src/adapters/index.js.map +1 -0
  23. package/dist/cjs/src/adapters/native/NativeAdapter.js +268 -0
  24. package/dist/cjs/src/adapters/native/NativeAdapter.js.map +1 -0
  25. package/dist/cjs/src/adapters/native/index.js +10 -0
  26. package/dist/cjs/src/adapters/native/index.js.map +1 -0
  27. package/dist/cjs/src/adapters/types/index.js +9 -0
  28. package/dist/cjs/src/adapters/types/index.js.map +1 -0
  29. package/dist/cjs/src/ai/ToolExecutor.js +211 -0
  30. package/dist/cjs/src/ai/ToolExecutor.js.map +1 -0
  31. package/dist/cjs/src/ai/ToolMatcher.js +202 -0
  32. package/dist/cjs/src/ai/ToolMatcher.js.map +1 -0
  33. package/dist/cjs/src/ai/index.js +29 -0
  34. package/dist/cjs/src/ai/index.js.map +1 -0
  35. package/dist/cjs/src/architecture/createContainer.js +106 -0
  36. package/dist/cjs/src/architecture/createContainer.js.map +1 -0
  37. package/dist/cjs/src/architecture/initialize.js +125 -0
  38. package/dist/cjs/src/architecture/initialize.js.map +1 -0
  39. package/dist/cjs/src/architecture/registry.js +111 -0
  40. package/dist/cjs/src/architecture/registry.js.map +1 -0
  41. package/dist/cjs/src/background/architecture/ArchitectureInitializer.js +174 -0
  42. package/dist/cjs/src/background/architecture/ArchitectureInitializer.js.map +1 -0
  43. package/dist/cjs/src/background/architecture/Containers.js +46 -0
  44. package/dist/cjs/src/background/architecture/Containers.js.map +1 -0
  45. package/dist/cjs/src/background/architecture/DataContractTypes.js +28 -0
  46. package/dist/cjs/src/background/architecture/DataContractTypes.js.map +1 -0
  47. package/dist/cjs/src/background/architecture/index.js +24 -0
  48. package/dist/cjs/src/background/architecture/index.js.map +1 -0
  49. package/dist/cjs/src/background/navigation/NavigationGraph.js +71 -0
  50. package/dist/cjs/src/background/navigation/NavigationGraph.js.map +1 -0
  51. package/dist/cjs/src/background/navigation/RuntimeTreeBuilder.js +66 -0
  52. package/dist/cjs/src/background/navigation/RuntimeTreeBuilder.js.map +1 -0
  53. package/dist/cjs/src/background/navigation/useComponentTracking.js +20 -0
  54. package/dist/cjs/src/background/navigation/useComponentTracking.js.map +1 -0
  55. package/dist/cjs/src/background/registry/ComponentRegistry.js +340 -0
  56. package/dist/cjs/src/background/registry/ComponentRegistry.js.map +1 -0
  57. package/dist/cjs/src/background/registry/ToolRegistry.js +668 -0
  58. package/dist/cjs/src/background/registry/ToolRegistry.js.map +1 -0
  59. package/dist/cjs/src/browser.js +70 -0
  60. package/dist/cjs/src/browser.js.map +1 -0
  61. package/dist/cjs/src/components/ComponentScanner.js +362 -0
  62. package/dist/cjs/src/components/ComponentScanner.js.map +1 -0
  63. package/dist/cjs/src/components/index.js +24 -0
  64. package/dist/cjs/src/components/index.js.map +1 -0
  65. package/dist/cjs/src/data/TestDataManager.js +187 -0
  66. package/dist/cjs/src/data/TestDataManager.js.map +1 -0
  67. package/dist/cjs/src/data/index.js +23 -0
  68. package/dist/cjs/src/data/index.js.map +1 -0
  69. package/dist/cjs/src/decorators/Component.js +108 -0
  70. package/dist/cjs/src/decorators/Component.js.map +1 -0
  71. package/dist/cjs/src/decorators/ContainerHelpers.js +45 -0
  72. package/dist/cjs/src/decorators/ContainerHelpers.js.map +1 -0
  73. package/dist/cjs/src/decorators/SpecializedTools.js +386 -0
  74. package/dist/cjs/src/decorators/SpecializedTools.js.map +1 -0
  75. package/dist/cjs/src/decorators/Tool.js +700 -0
  76. package/dist/cjs/src/decorators/Tool.js.map +1 -0
  77. package/dist/cjs/src/decorators/ToolHelpers.js +261 -0
  78. package/dist/cjs/src/decorators/ToolHelpers.js.map +1 -0
  79. package/dist/cjs/src/decorators/ToolPreset.js +270 -0
  80. package/dist/cjs/src/decorators/ToolPreset.js.map +1 -0
  81. package/dist/cjs/src/decorators/ToolProvider.js +86 -0
  82. package/dist/cjs/src/decorators/ToolProvider.js.map +1 -0
  83. package/dist/cjs/src/decorators/index.js +44 -0
  84. package/dist/cjs/src/decorators/index.js.map +1 -0
  85. package/dist/cjs/src/execution/DOMExecutor.js +233 -0
  86. package/dist/cjs/src/execution/DOMExecutor.js.map +1 -0
  87. package/dist/cjs/src/execution/PlaywrightExecutor.js +196 -0
  88. package/dist/cjs/src/execution/PlaywrightExecutor.js.map +1 -0
  89. package/dist/cjs/src/exposure/ExposureCollector.js +358 -0
  90. package/dist/cjs/src/exposure/ExposureCollector.js.map +1 -0
  91. package/dist/cjs/src/exposure/index.js +26 -0
  92. package/dist/cjs/src/exposure/index.js.map +1 -0
  93. package/dist/cjs/src/index.js +187 -0
  94. package/dist/cjs/src/index.js.map +1 -0
  95. package/dist/cjs/src/interfaces/StatefulComponent.js +50 -0
  96. package/dist/cjs/src/interfaces/StatefulComponent.js.map +1 -0
  97. package/dist/cjs/src/name-contracts/ContractScanner.js +15 -0
  98. package/dist/cjs/src/name-contracts/ContractScanner.js.map +1 -0
  99. package/dist/cjs/src/name-contracts/RouteContractScanner.js +225 -0
  100. package/dist/cjs/src/name-contracts/RouteContractScanner.js.map +1 -0
  101. package/dist/cjs/src/name-contracts/index.js +15 -0
  102. package/dist/cjs/src/name-contracts/index.js.map +1 -0
  103. package/dist/cjs/src/names/createNames.js +86 -0
  104. package/dist/cjs/src/names/createNames.js.map +1 -0
  105. package/dist/cjs/src/react/hooks/useChatWithContext.js +221 -0
  106. package/dist/cjs/src/react/hooks/useChatWithContext.js.map +1 -0
  107. package/dist/cjs/src/react/index.js +28 -0
  108. package/dist/cjs/src/react/index.js.map +1 -0
  109. package/dist/cjs/src/react/useNavigationHandler.js +88 -0
  110. package/dist/cjs/src/react/useNavigationHandler.js.map +1 -0
  111. package/dist/cjs/src/react/usePersistedState.js +72 -0
  112. package/dist/cjs/src/react/usePersistedState.js.map +1 -0
  113. package/dist/cjs/src/react/useToolBinding.js +110 -0
  114. package/dist/cjs/src/react/useToolBinding.js.map +1 -0
  115. package/dist/cjs/src/routes/RouteContractGenerator.js +119 -0
  116. package/dist/cjs/src/routes/RouteContractGenerator.js.map +1 -0
  117. package/dist/cjs/src/routes/RouteContractsConfig.js +39 -0
  118. package/dist/cjs/src/routes/RouteContractsConfig.js.map +1 -0
  119. package/dist/cjs/src/routes/index.js +20 -0
  120. package/dist/cjs/src/routes/index.js.map +1 -0
  121. package/dist/cjs/src/routes/scanners/NameExtractor.js +193 -0
  122. package/dist/cjs/src/routes/scanners/NameExtractor.js.map +1 -0
  123. package/dist/cjs/src/routes/scanners/NextjsDynamicScanner.js +102 -0
  124. package/dist/cjs/src/routes/scanners/NextjsDynamicScanner.js.map +1 -0
  125. package/dist/cjs/src/routes/scanners/RouteScanner.js +13 -0
  126. package/dist/cjs/src/routes/scanners/RouteScanner.js.map +1 -0
  127. package/dist/cjs/src/storage/LocalStorageAdapter.js +87 -0
  128. package/dist/cjs/src/storage/LocalStorageAdapter.js.map +1 -0
  129. package/dist/cjs/src/storage/StateManager.js +299 -0
  130. package/dist/cjs/src/storage/StateManager.js.map +1 -0
  131. package/dist/cjs/src/storage/StorageAdapter.js +164 -0
  132. package/dist/cjs/src/storage/StorageAdapter.js.map +1 -0
  133. package/dist/cjs/src/storage/index.js +37 -0
  134. package/dist/cjs/src/storage/index.js.map +1 -0
  135. package/dist/cjs/src/testing/BrowserStateInjection.js +130 -0
  136. package/dist/cjs/src/testing/BrowserStateInjection.js.map +1 -0
  137. package/dist/cjs/src/testing/ComponentStateHelpers.js +200 -0
  138. package/dist/cjs/src/testing/ComponentStateHelpers.js.map +1 -0
  139. package/dist/cjs/src/testing/GherkinParser.js +252 -0
  140. package/dist/cjs/src/testing/GherkinParser.js.map +1 -0
  141. package/dist/cjs/src/testing/PlaywrightStateHelpers.js +254 -0
  142. package/dist/cjs/src/testing/PlaywrightStateHelpers.js.map +1 -0
  143. package/dist/cjs/src/testing/TestRunner.js +158 -0
  144. package/dist/cjs/src/testing/TestRunner.js.map +1 -0
  145. package/dist/cjs/src/testing/index.js +46 -0
  146. package/dist/cjs/src/testing/index.js.map +1 -0
  147. package/dist/cjs/src/testing/selectors.js +84 -0
  148. package/dist/cjs/src/testing/selectors.js.map +1 -0
  149. package/dist/cjs/src/tools/SystemTools.js +262 -0
  150. package/dist/cjs/src/tools/SystemTools.js.map +1 -0
  151. package/dist/cjs/src/types/ClassifiedTool.js +50 -0
  152. package/dist/cjs/src/types/ClassifiedTool.js.map +1 -0
  153. package/dist/cjs/src/types/ComponentState.js +30 -0
  154. package/dist/cjs/src/types/ComponentState.js.map +1 -0
  155. package/dist/cjs/src/types/DiscoverableToolProvider.js +9 -0
  156. package/dist/cjs/src/types/DiscoverableToolProvider.js.map +1 -0
  157. package/dist/cjs/src/types/ExposureState.js +25 -0
  158. package/dist/cjs/src/types/ExposureState.js.map +1 -0
  159. package/dist/cjs/src/types/NavigationGraph.js +8 -0
  160. package/dist/cjs/src/types/NavigationGraph.js.map +1 -0
  161. package/dist/cjs/src/types/OperationType.js +49 -0
  162. package/dist/cjs/src/types/OperationType.js.map +1 -0
  163. package/dist/cjs/src/types/StateManagers.js +39 -0
  164. package/dist/cjs/src/types/StateManagers.js.map +1 -0
  165. package/dist/cjs/src/types/Tool.js +41 -0
  166. package/dist/cjs/src/types/Tool.js.map +1 -0
  167. package/dist/cjs/src/types/ToolPermissions.js +54 -0
  168. package/dist/cjs/src/types/ToolPermissions.js.map +1 -0
  169. package/dist/cjs/src/types/ToolResult.js +25 -0
  170. package/dist/cjs/src/types/ToolResult.js.map +1 -0
  171. package/dist/cjs/src/types/index.js +59 -0
  172. package/dist/cjs/src/types/index.js.map +1 -0
  173. package/dist/cjs/src/ui/react/chat/ChatBubble.js +221 -0
  174. package/dist/cjs/src/ui/react/chat/ChatBubble.js.map +1 -0
  175. package/dist/esm/names/API.d.ts +77 -0
  176. package/dist/esm/names/API.d.ts.map +1 -0
  177. package/dist/esm/names/API.js +99 -0
  178. package/dist/esm/names/API.js.map +1 -0
  179. package/dist/esm/names/Components.d.ts +77 -0
  180. package/dist/esm/names/Components.d.ts.map +1 -0
  181. package/dist/esm/names/Components.js +99 -0
  182. package/dist/esm/names/Components.js.map +1 -0
  183. package/dist/esm/names/Containers.d.ts +84 -0
  184. package/dist/esm/names/Containers.d.ts.map +1 -0
  185. package/dist/esm/names/Containers.js +94 -0
  186. package/dist/esm/names/Containers.js.map +1 -0
  187. package/dist/esm/names/Functions.d.ts +87 -0
  188. package/dist/esm/names/Functions.d.ts.map +1 -0
  189. package/dist/esm/names/Functions.js +109 -0
  190. package/dist/esm/names/Functions.js.map +1 -0
  191. package/dist/esm/names/index.d.ts +187 -0
  192. package/dist/esm/names/index.d.ts.map +1 -0
  193. package/dist/esm/names/index.js +99 -0
  194. package/dist/esm/names/index.js.map +1 -0
  195. package/dist/esm/src/adapters/ChatUIProvider.d.ts +76 -0
  196. package/dist/esm/src/adapters/ChatUIProvider.d.ts.map +1 -0
  197. package/dist/esm/src/adapters/ChatUIProvider.js +136 -0
  198. package/dist/esm/src/adapters/ChatUIProvider.js.map +1 -0
  199. package/dist/esm/src/adapters/bridge.d.ts +145 -0
  200. package/dist/esm/src/adapters/bridge.d.ts.map +1 -0
  201. package/dist/esm/src/adapters/bridge.js +218 -0
  202. package/dist/esm/src/adapters/bridge.js.map +1 -0
  203. package/dist/esm/src/adapters/copilotkit/CopilotKitAdapter.d.ts +49 -0
  204. package/dist/esm/src/adapters/copilotkit/CopilotKitAdapter.d.ts.map +1 -0
  205. package/dist/esm/src/adapters/copilotkit/CopilotKitAdapter.js +251 -0
  206. package/dist/esm/src/adapters/copilotkit/CopilotKitAdapter.js.map +1 -0
  207. package/dist/esm/src/adapters/copilotkit/index.d.ts +6 -0
  208. package/dist/esm/src/adapters/copilotkit/index.d.ts.map +1 -0
  209. package/dist/esm/src/adapters/copilotkit/index.js +5 -0
  210. package/dist/esm/src/adapters/copilotkit/index.js.map +1 -0
  211. package/dist/esm/src/adapters/index.d.ts +31 -0
  212. package/dist/esm/src/adapters/index.d.ts.map +1 -0
  213. package/dist/esm/src/adapters/index.js +32 -0
  214. package/dist/esm/src/adapters/index.js.map +1 -0
  215. package/dist/esm/src/adapters/native/NativeAdapter.d.ts +47 -0
  216. package/dist/esm/src/adapters/native/NativeAdapter.d.ts.map +1 -0
  217. package/dist/esm/src/adapters/native/NativeAdapter.js +230 -0
  218. package/dist/esm/src/adapters/native/NativeAdapter.js.map +1 -0
  219. package/dist/esm/src/adapters/native/index.d.ts +6 -0
  220. package/dist/esm/src/adapters/native/index.d.ts.map +1 -0
  221. package/dist/esm/src/adapters/native/index.js +5 -0
  222. package/dist/esm/src/adapters/native/index.js.map +1 -0
  223. package/dist/esm/src/adapters/types/index.d.ts +155 -0
  224. package/dist/esm/src/adapters/types/index.d.ts.map +1 -0
  225. package/dist/esm/src/adapters/types/index.js +8 -0
  226. package/dist/esm/src/adapters/types/index.js.map +1 -0
  227. package/dist/esm/src/ai/ToolExecutor.d.ts +49 -0
  228. package/dist/esm/src/ai/ToolExecutor.d.ts.map +1 -0
  229. package/dist/esm/src/ai/ToolExecutor.js +174 -0
  230. package/dist/esm/src/ai/ToolExecutor.js.map +1 -0
  231. package/dist/esm/src/ai/ToolMatcher.d.ts +61 -0
  232. package/dist/esm/src/ai/ToolMatcher.d.ts.map +1 -0
  233. package/dist/esm/src/ai/ToolMatcher.js +198 -0
  234. package/dist/esm/src/ai/ToolMatcher.js.map +1 -0
  235. package/dist/esm/src/ai/index.d.ts +9 -0
  236. package/dist/esm/src/ai/index.d.ts.map +1 -0
  237. package/dist/esm/src/ai/index.js +13 -0
  238. package/dist/esm/src/ai/index.js.map +1 -0
  239. package/dist/esm/src/architecture/createContainer.d.ts +60 -0
  240. package/dist/esm/src/architecture/createContainer.d.ts.map +1 -0
  241. package/dist/esm/src/architecture/createContainer.js +102 -0
  242. package/dist/esm/src/architecture/createContainer.js.map +1 -0
  243. package/dist/esm/src/architecture/initialize.d.ts +81 -0
  244. package/dist/esm/src/architecture/initialize.d.ts.map +1 -0
  245. package/dist/esm/src/architecture/initialize.js +121 -0
  246. package/dist/esm/src/architecture/initialize.js.map +1 -0
  247. package/dist/esm/src/architecture/registry.d.ts +61 -0
  248. package/dist/esm/src/architecture/registry.d.ts.map +1 -0
  249. package/dist/esm/src/architecture/registry.js +107 -0
  250. package/dist/esm/src/architecture/registry.js.map +1 -0
  251. package/dist/esm/src/background/architecture/ArchitectureInitializer.d.ts +95 -0
  252. package/dist/esm/src/background/architecture/ArchitectureInitializer.d.ts.map +1 -0
  253. package/dist/esm/src/background/architecture/ArchitectureInitializer.js +170 -0
  254. package/dist/esm/src/background/architecture/ArchitectureInitializer.js.map +1 -0
  255. package/dist/esm/src/background/architecture/Containers.d.ts +52 -0
  256. package/dist/esm/src/background/architecture/Containers.d.ts.map +1 -0
  257. package/dist/esm/src/background/architecture/Containers.js +40 -0
  258. package/dist/esm/src/background/architecture/Containers.js.map +1 -0
  259. package/dist/esm/src/background/architecture/DataContractTypes.d.ts +33 -0
  260. package/dist/esm/src/background/architecture/DataContractTypes.d.ts.map +1 -0
  261. package/dist/esm/src/background/architecture/DataContractTypes.js +22 -0
  262. package/dist/esm/src/background/architecture/DataContractTypes.js.map +1 -0
  263. package/dist/esm/src/background/architecture/index.d.ts +12 -0
  264. package/dist/esm/src/background/architecture/index.d.ts.map +1 -0
  265. package/dist/esm/src/background/architecture/index.js +13 -0
  266. package/dist/esm/src/background/architecture/index.js.map +1 -0
  267. package/dist/esm/src/background/navigation/NavigationGraph.d.ts +48 -0
  268. package/dist/esm/src/background/navigation/NavigationGraph.d.ts.map +1 -0
  269. package/dist/esm/src/background/navigation/NavigationGraph.js +67 -0
  270. package/dist/esm/src/background/navigation/NavigationGraph.js.map +1 -0
  271. package/dist/esm/src/background/navigation/RuntimeTreeBuilder.d.ts +30 -0
  272. package/dist/esm/src/background/navigation/RuntimeTreeBuilder.d.ts.map +1 -0
  273. package/dist/esm/src/background/navigation/RuntimeTreeBuilder.js +60 -0
  274. package/dist/esm/src/background/navigation/RuntimeTreeBuilder.js.map +1 -0
  275. package/dist/esm/src/background/navigation/useComponentTracking.d.ts +10 -0
  276. package/dist/esm/src/background/navigation/useComponentTracking.d.ts.map +1 -0
  277. package/dist/esm/src/background/navigation/useComponentTracking.js +17 -0
  278. package/dist/esm/src/background/navigation/useComponentTracking.js.map +1 -0
  279. package/dist/esm/src/background/registry/ComponentRegistry.d.ts +192 -0
  280. package/dist/esm/src/background/registry/ComponentRegistry.d.ts.map +1 -0
  281. package/dist/esm/src/background/registry/ComponentRegistry.js +336 -0
  282. package/dist/esm/src/background/registry/ComponentRegistry.js.map +1 -0
  283. package/dist/esm/src/background/registry/ToolRegistry.d.ts +232 -0
  284. package/dist/esm/src/background/registry/ToolRegistry.d.ts.map +1 -0
  285. package/dist/esm/src/background/registry/ToolRegistry.js +664 -0
  286. package/dist/esm/src/background/registry/ToolRegistry.js.map +1 -0
  287. package/dist/esm/src/browser.d.ts +21 -0
  288. package/dist/esm/src/browser.d.ts.map +1 -0
  289. package/dist/esm/src/browser.js +31 -0
  290. package/dist/esm/src/browser.js.map +1 -0
  291. package/dist/esm/src/components/ComponentScanner.d.ts +99 -0
  292. package/dist/esm/src/components/ComponentScanner.d.ts.map +1 -0
  293. package/dist/esm/src/components/ComponentScanner.js +325 -0
  294. package/dist/esm/src/components/ComponentScanner.js.map +1 -0
  295. package/dist/esm/src/components/index.d.ts +9 -0
  296. package/dist/esm/src/components/index.d.ts.map +1 -0
  297. package/dist/esm/src/components/index.js +8 -0
  298. package/dist/esm/src/components/index.js.map +1 -0
  299. package/dist/esm/src/data/TestDataManager.d.ts +125 -0
  300. package/dist/esm/src/data/TestDataManager.d.ts.map +1 -0
  301. package/dist/esm/src/data/TestDataManager.js +183 -0
  302. package/dist/esm/src/data/TestDataManager.js.map +1 -0
  303. package/dist/esm/src/data/index.d.ts +7 -0
  304. package/dist/esm/src/data/index.d.ts.map +1 -0
  305. package/dist/esm/src/data/index.js +7 -0
  306. package/dist/esm/src/data/index.js.map +1 -0
  307. package/dist/esm/src/decorators/Component.d.ts +59 -0
  308. package/dist/esm/src/decorators/Component.d.ts.map +1 -0
  309. package/dist/esm/src/decorators/Component.js +103 -0
  310. package/dist/esm/src/decorators/Component.js.map +1 -0
  311. package/dist/esm/src/decorators/ContainerHelpers.d.ts +26 -0
  312. package/dist/esm/src/decorators/ContainerHelpers.d.ts.map +1 -0
  313. package/dist/esm/src/decorators/ContainerHelpers.js +42 -0
  314. package/dist/esm/src/decorators/ContainerHelpers.js.map +1 -0
  315. package/dist/esm/src/decorators/SpecializedTools.d.ts +218 -0
  316. package/dist/esm/src/decorators/SpecializedTools.d.ts.map +1 -0
  317. package/dist/esm/src/decorators/SpecializedTools.js +383 -0
  318. package/dist/esm/src/decorators/SpecializedTools.js.map +1 -0
  319. package/dist/esm/src/decorators/Tool.d.ts +210 -0
  320. package/dist/esm/src/decorators/Tool.d.ts.map +1 -0
  321. package/dist/esm/src/decorators/Tool.js +694 -0
  322. package/dist/esm/src/decorators/Tool.js.map +1 -0
  323. package/dist/esm/src/decorators/ToolHelpers.d.ts +74 -0
  324. package/dist/esm/src/decorators/ToolHelpers.d.ts.map +1 -0
  325. package/dist/esm/src/decorators/ToolHelpers.js +219 -0
  326. package/dist/esm/src/decorators/ToolHelpers.js.map +1 -0
  327. package/dist/esm/src/decorators/ToolPreset.d.ts +138 -0
  328. package/dist/esm/src/decorators/ToolPreset.d.ts.map +1 -0
  329. package/dist/esm/src/decorators/ToolPreset.js +259 -0
  330. package/dist/esm/src/decorators/ToolPreset.js.map +1 -0
  331. package/dist/esm/src/decorators/ToolProvider.d.ts +65 -0
  332. package/dist/esm/src/decorators/ToolProvider.d.ts.map +1 -0
  333. package/dist/esm/src/decorators/ToolProvider.js +81 -0
  334. package/dist/esm/src/decorators/ToolProvider.js.map +1 -0
  335. package/dist/esm/src/decorators/index.d.ts +13 -0
  336. package/dist/esm/src/decorators/index.d.ts.map +1 -0
  337. package/dist/esm/src/decorators/index.js +14 -0
  338. package/dist/esm/src/decorators/index.js.map +1 -0
  339. package/dist/esm/src/execution/DOMExecutor.d.ts +43 -0
  340. package/dist/esm/src/execution/DOMExecutor.d.ts.map +1 -0
  341. package/dist/esm/src/execution/DOMExecutor.js +229 -0
  342. package/dist/esm/src/execution/DOMExecutor.js.map +1 -0
  343. package/dist/esm/src/execution/PlaywrightExecutor.d.ts +38 -0
  344. package/dist/esm/src/execution/PlaywrightExecutor.d.ts.map +1 -0
  345. package/dist/esm/src/execution/PlaywrightExecutor.js +192 -0
  346. package/dist/esm/src/execution/PlaywrightExecutor.js.map +1 -0
  347. package/dist/esm/src/exposure/ExposureCollector.d.ts +88 -0
  348. package/dist/esm/src/exposure/ExposureCollector.d.ts.map +1 -0
  349. package/dist/esm/src/exposure/ExposureCollector.js +354 -0
  350. package/dist/esm/src/exposure/ExposureCollector.js.map +1 -0
  351. package/dist/esm/src/exposure/index.d.ts +8 -0
  352. package/dist/esm/src/exposure/index.d.ts.map +1 -0
  353. package/dist/esm/src/exposure/index.js +10 -0
  354. package/dist/esm/src/exposure/index.js.map +1 -0
  355. package/dist/esm/src/index.d.ts +49 -0
  356. package/dist/esm/src/index.d.ts.map +1 -0
  357. package/dist/esm/src/index.js +79 -0
  358. package/dist/esm/src/index.js.map +1 -0
  359. package/dist/esm/src/interfaces/StatefulComponent.d.ts +72 -0
  360. package/dist/esm/src/interfaces/StatefulComponent.d.ts.map +1 -0
  361. package/dist/esm/src/interfaces/StatefulComponent.js +47 -0
  362. package/dist/esm/src/interfaces/StatefulComponent.js.map +1 -0
  363. package/dist/esm/src/name-contracts/ContractScanner.d.ts +61 -0
  364. package/dist/esm/src/name-contracts/ContractScanner.d.ts.map +1 -0
  365. package/dist/esm/src/name-contracts/ContractScanner.js +11 -0
  366. package/dist/esm/src/name-contracts/ContractScanner.js.map +1 -0
  367. package/dist/esm/src/name-contracts/RouteContractScanner.d.ts +30 -0
  368. package/dist/esm/src/name-contracts/RouteContractScanner.d.ts.map +1 -0
  369. package/dist/esm/src/name-contracts/RouteContractScanner.js +188 -0
  370. package/dist/esm/src/name-contracts/RouteContractScanner.js.map +1 -0
  371. package/dist/esm/src/name-contracts/index.d.ts +10 -0
  372. package/dist/esm/src/name-contracts/index.d.ts.map +1 -0
  373. package/dist/esm/src/name-contracts/index.js +10 -0
  374. package/dist/esm/src/name-contracts/index.js.map +1 -0
  375. package/dist/esm/src/names/createNames.d.ts +49 -0
  376. package/dist/esm/src/names/createNames.d.ts.map +1 -0
  377. package/dist/esm/src/names/createNames.js +81 -0
  378. package/dist/esm/src/names/createNames.js.map +1 -0
  379. package/dist/esm/src/react/hooks/useChatWithContext.d.ts +68 -0
  380. package/dist/esm/src/react/hooks/useChatWithContext.d.ts.map +1 -0
  381. package/dist/esm/src/react/hooks/useChatWithContext.js +218 -0
  382. package/dist/esm/src/react/hooks/useChatWithContext.js.map +1 -0
  383. package/dist/esm/src/react/index.d.ts +12 -0
  384. package/dist/esm/src/react/index.d.ts.map +1 -0
  385. package/dist/esm/src/react/index.js +21 -0
  386. package/dist/esm/src/react/index.js.map +1 -0
  387. package/dist/esm/src/react/useNavigationHandler.d.ts +42 -0
  388. package/dist/esm/src/react/useNavigationHandler.d.ts.map +1 -0
  389. package/dist/esm/src/react/useNavigationHandler.js +85 -0
  390. package/dist/esm/src/react/useNavigationHandler.js.map +1 -0
  391. package/dist/esm/src/react/usePersistedState.d.ts +13 -0
  392. package/dist/esm/src/react/usePersistedState.d.ts.map +1 -0
  393. package/dist/esm/src/react/usePersistedState.js +69 -0
  394. package/dist/esm/src/react/usePersistedState.js.map +1 -0
  395. package/dist/esm/src/react/useToolBinding.d.ts +8 -0
  396. package/dist/esm/src/react/useToolBinding.d.ts.map +1 -0
  397. package/dist/esm/src/react/useToolBinding.js +107 -0
  398. package/dist/esm/src/react/useToolBinding.js.map +1 -0
  399. package/dist/esm/src/routes/RouteContractGenerator.d.ts +37 -0
  400. package/dist/esm/src/routes/RouteContractGenerator.d.ts.map +1 -0
  401. package/dist/esm/src/routes/RouteContractGenerator.js +115 -0
  402. package/dist/esm/src/routes/RouteContractGenerator.js.map +1 -0
  403. package/dist/esm/src/routes/RouteContractsConfig.d.ts +93 -0
  404. package/dist/esm/src/routes/RouteContractsConfig.d.ts.map +1 -0
  405. package/dist/esm/src/routes/RouteContractsConfig.js +36 -0
  406. package/dist/esm/src/routes/RouteContractsConfig.js.map +1 -0
  407. package/dist/esm/src/routes/index.d.ts +13 -0
  408. package/dist/esm/src/routes/index.d.ts.map +1 -0
  409. package/dist/esm/src/routes/index.js +13 -0
  410. package/dist/esm/src/routes/index.js.map +1 -0
  411. package/dist/esm/src/routes/scanners/NameExtractor.d.ts +36 -0
  412. package/dist/esm/src/routes/scanners/NameExtractor.d.ts.map +1 -0
  413. package/dist/esm/src/routes/scanners/NameExtractor.js +156 -0
  414. package/dist/esm/src/routes/scanners/NameExtractor.js.map +1 -0
  415. package/dist/esm/src/routes/scanners/NextjsDynamicScanner.d.ts +35 -0
  416. package/dist/esm/src/routes/scanners/NextjsDynamicScanner.d.ts.map +1 -0
  417. package/dist/esm/src/routes/scanners/NextjsDynamicScanner.js +98 -0
  418. package/dist/esm/src/routes/scanners/NextjsDynamicScanner.js.map +1 -0
  419. package/dist/esm/src/routes/scanners/RouteScanner.d.ts +64 -0
  420. package/dist/esm/src/routes/scanners/RouteScanner.d.ts.map +1 -0
  421. package/dist/esm/src/routes/scanners/RouteScanner.js +9 -0
  422. package/dist/esm/src/routes/scanners/RouteScanner.js.map +1 -0
  423. package/dist/esm/src/storage/LocalStorageAdapter.d.ts +29 -0
  424. package/dist/esm/src/storage/LocalStorageAdapter.d.ts.map +1 -0
  425. package/dist/esm/src/storage/LocalStorageAdapter.js +83 -0
  426. package/dist/esm/src/storage/LocalStorageAdapter.js.map +1 -0
  427. package/dist/esm/src/storage/StateManager.d.ts +175 -0
  428. package/dist/esm/src/storage/StateManager.d.ts.map +1 -0
  429. package/dist/esm/src/storage/StateManager.js +295 -0
  430. package/dist/esm/src/storage/StateManager.js.map +1 -0
  431. package/dist/esm/src/storage/StorageAdapter.d.ts +94 -0
  432. package/dist/esm/src/storage/StorageAdapter.d.ts.map +1 -0
  433. package/dist/esm/src/storage/StorageAdapter.js +158 -0
  434. package/dist/esm/src/storage/StorageAdapter.js.map +1 -0
  435. package/dist/esm/src/storage/index.d.ts +12 -0
  436. package/dist/esm/src/storage/index.d.ts.map +1 -0
  437. package/dist/esm/src/storage/index.js +17 -0
  438. package/dist/esm/src/storage/index.js.map +1 -0
  439. package/dist/esm/src/testing/BrowserStateInjection.d.ts +74 -0
  440. package/dist/esm/src/testing/BrowserStateInjection.d.ts.map +1 -0
  441. package/dist/esm/src/testing/BrowserStateInjection.js +126 -0
  442. package/dist/esm/src/testing/BrowserStateInjection.js.map +1 -0
  443. package/dist/esm/src/testing/ComponentStateHelpers.d.ts +121 -0
  444. package/dist/esm/src/testing/ComponentStateHelpers.d.ts.map +1 -0
  445. package/dist/esm/src/testing/ComponentStateHelpers.js +190 -0
  446. package/dist/esm/src/testing/ComponentStateHelpers.js.map +1 -0
  447. package/dist/esm/src/testing/GherkinParser.d.ts +87 -0
  448. package/dist/esm/src/testing/GherkinParser.d.ts.map +1 -0
  449. package/dist/esm/src/testing/GherkinParser.js +248 -0
  450. package/dist/esm/src/testing/GherkinParser.js.map +1 -0
  451. package/dist/esm/src/testing/PlaywrightStateHelpers.d.ts +163 -0
  452. package/dist/esm/src/testing/PlaywrightStateHelpers.d.ts.map +1 -0
  453. package/dist/esm/src/testing/PlaywrightStateHelpers.js +242 -0
  454. package/dist/esm/src/testing/PlaywrightStateHelpers.js.map +1 -0
  455. package/dist/esm/src/testing/TestRunner.d.ts +50 -0
  456. package/dist/esm/src/testing/TestRunner.d.ts.map +1 -0
  457. package/dist/esm/src/testing/TestRunner.js +121 -0
  458. package/dist/esm/src/testing/TestRunner.js.map +1 -0
  459. package/dist/esm/src/testing/index.d.ts +12 -0
  460. package/dist/esm/src/testing/index.d.ts.map +1 -0
  461. package/dist/esm/src/testing/index.js +25 -0
  462. package/dist/esm/src/testing/index.js.map +1 -0
  463. package/dist/esm/src/testing/selectors.d.ts +65 -0
  464. package/dist/esm/src/testing/selectors.d.ts.map +1 -0
  465. package/dist/esm/src/testing/selectors.js +76 -0
  466. package/dist/esm/src/testing/selectors.js.map +1 -0
  467. package/dist/esm/src/tools/SystemTools.d.ts +139 -0
  468. package/dist/esm/src/tools/SystemTools.d.ts.map +1 -0
  469. package/dist/esm/src/tools/SystemTools.js +258 -0
  470. package/dist/esm/src/tools/SystemTools.js.map +1 -0
  471. package/dist/esm/src/types/ClassifiedTool.d.ts +61 -0
  472. package/dist/esm/src/types/ClassifiedTool.d.ts.map +1 -0
  473. package/dist/esm/src/types/ClassifiedTool.js +47 -0
  474. package/dist/esm/src/types/ClassifiedTool.js.map +1 -0
  475. package/dist/esm/src/types/ComponentState.d.ts +207 -0
  476. package/dist/esm/src/types/ComponentState.d.ts.map +1 -0
  477. package/dist/esm/src/types/ComponentState.js +25 -0
  478. package/dist/esm/src/types/ComponentState.js.map +1 -0
  479. package/dist/esm/src/types/DiscoverableToolProvider.d.ts +59 -0
  480. package/dist/esm/src/types/DiscoverableToolProvider.d.ts.map +1 -0
  481. package/dist/esm/src/types/DiscoverableToolProvider.js +8 -0
  482. package/dist/esm/src/types/DiscoverableToolProvider.js.map +1 -0
  483. package/dist/esm/src/types/ExposureState.d.ts +75 -0
  484. package/dist/esm/src/types/ExposureState.d.ts.map +1 -0
  485. package/dist/esm/src/types/ExposureState.js +22 -0
  486. package/dist/esm/src/types/ExposureState.js.map +1 -0
  487. package/dist/esm/src/types/NavigationGraph.d.ts +98 -0
  488. package/dist/esm/src/types/NavigationGraph.d.ts.map +1 -0
  489. package/dist/esm/src/types/NavigationGraph.js +7 -0
  490. package/dist/esm/src/types/NavigationGraph.js.map +1 -0
  491. package/dist/esm/src/types/OperationType.d.ts +45 -0
  492. package/dist/esm/src/types/OperationType.d.ts.map +1 -0
  493. package/dist/esm/src/types/OperationType.js +46 -0
  494. package/dist/esm/src/types/OperationType.js.map +1 -0
  495. package/dist/esm/src/types/StateManagers.d.ts +35 -0
  496. package/dist/esm/src/types/StateManagers.d.ts.map +1 -0
  497. package/dist/esm/src/types/StateManagers.js +36 -0
  498. package/dist/esm/src/types/StateManagers.js.map +1 -0
  499. package/dist/esm/src/types/Tool.d.ts +162 -0
  500. package/dist/esm/src/types/Tool.d.ts.map +1 -0
  501. package/dist/esm/src/types/Tool.js +38 -0
  502. package/dist/esm/src/types/Tool.js.map +1 -0
  503. package/dist/esm/src/types/ToolPermissions.d.ts +73 -0
  504. package/dist/esm/src/types/ToolPermissions.d.ts.map +1 -0
  505. package/dist/esm/src/types/ToolPermissions.js +51 -0
  506. package/dist/esm/src/types/ToolPermissions.js.map +1 -0
  507. package/dist/esm/src/types/ToolResult.d.ts +129 -0
  508. package/dist/esm/src/types/ToolResult.d.ts.map +1 -0
  509. package/dist/esm/src/types/ToolResult.js +22 -0
  510. package/dist/esm/src/types/ToolResult.js.map +1 -0
  511. package/dist/esm/src/types/index.d.ts +47 -0
  512. package/dist/esm/src/types/index.d.ts.map +1 -0
  513. package/dist/esm/src/types/index.js +42 -0
  514. package/dist/esm/src/types/index.js.map +1 -0
  515. package/dist/esm/src/ui/react/chat/ChatBubble.d.ts +23 -0
  516. package/dist/esm/src/ui/react/chat/ChatBubble.d.ts.map +1 -0
  517. package/dist/esm/src/ui/react/chat/ChatBubble.js +184 -0
  518. package/dist/esm/src/ui/react/chat/ChatBubble.js.map +1 -0
  519. package/package.json +118 -0
@@ -0,0 +1,262 @@
1
+ "use strict";
2
+ /**
3
+ * System Tools - AI Discovery & Help System
4
+ *
5
+ * Provides mandatory tools for AI agents to discover and understand
6
+ * available capabilities without hardcoding tool names.
7
+ *
8
+ * Features:
9
+ * - help(): Get usage information and available tools
10
+ * - listCapabilities(): Query and filter available tools
11
+ * - describe(): Get detailed information about specific tools
12
+ * - Smart suggestions using Levenshtein distance for typos
13
+ *
14
+ * @example
15
+ * ```typescript
16
+ * // AI discovers tools
17
+ * const tools = await SystemTools.listCapabilities({ category: ToolCategory.DEMO });
18
+ *
19
+ * // AI gets help on a specific tool
20
+ * const info = await SystemTools.describe('sendMessage');
21
+ *
22
+ * // AI gets suggestions on typos
23
+ * try {
24
+ * await someAPI.setPriorty('high'); // Typo!
25
+ * } catch (err) {
26
+ * // "setPriorty not found. Did you mean: setPriority, setStatus?"
27
+ * }
28
+ * ```
29
+ */
30
+ Object.defineProperty(exports, "__esModule", { value: true });
31
+ exports.SystemTools = void 0;
32
+ const ToolRegistry_1 = require("../background/registry/ToolRegistry");
33
+ /**
34
+ * Levenshtein distance calculation for string similarity
35
+ */
36
+ function levenshteinDistance(a, b) {
37
+ const matrix = [];
38
+ for (let i = 0; i <= b.length; i++) {
39
+ matrix[i] = [i];
40
+ }
41
+ for (let j = 0; j <= a.length; j++) {
42
+ matrix[0][j] = j;
43
+ }
44
+ for (let i = 1; i <= b.length; i++) {
45
+ for (let j = 1; j <= a.length; j++) {
46
+ if (b.charAt(i - 1) === a.charAt(j - 1)) {
47
+ matrix[i][j] = matrix[i - 1][j - 1];
48
+ }
49
+ else {
50
+ matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
51
+ matrix[i][j - 1] + 1, // insertion
52
+ matrix[i - 1][j] + 1 // deletion
53
+ );
54
+ }
55
+ }
56
+ }
57
+ return matrix[b.length][a.length];
58
+ }
59
+ /**
60
+ * Calculate similarity score (0-1, higher is more similar)
61
+ */
62
+ function similarityScore(a, b) {
63
+ const distance = levenshteinDistance(a.toLowerCase(), b.toLowerCase());
64
+ const maxLength = Math.max(a.length, b.length);
65
+ return 1 - (distance / maxLength);
66
+ }
67
+ /**
68
+ * System Tools for AI Discovery
69
+ */
70
+ class SystemTools {
71
+ /**
72
+ * Get general help and overview
73
+ */
74
+ static async help() {
75
+ const allTools = ToolRegistry_1.ToolRegistry.getTools();
76
+ const categories = new Set();
77
+ allTools.forEach(tool => {
78
+ if (tool.category) {
79
+ categories.add(tool.category);
80
+ }
81
+ });
82
+ return {
83
+ message: [
84
+ 'Welcome to the Supernal AI Interface!',
85
+ '',
86
+ 'Available Commands:',
87
+ '- SystemTools.help(): Get this help message',
88
+ '- SystemTools.listCapabilities(query): Query available tools',
89
+ '- SystemTools.describe(toolId): Get detailed tool information',
90
+ '',
91
+ `Total Tools: ${allTools.length}`,
92
+ `Categories: ${Array.from(categories).join(', ')}`,
93
+ ].join('\n'),
94
+ categories: Array.from(categories),
95
+ toolCount: allTools.length,
96
+ systemTools: ['help', 'listCapabilities', 'describe'],
97
+ examples: [
98
+ 'SystemTools.listCapabilities({ category: ToolCategory.USER_INTERACTION })',
99
+ 'SystemTools.listCapabilities({ keyword: "button" })',
100
+ 'SystemTools.describe("sendMessage")',
101
+ ],
102
+ };
103
+ }
104
+ /**
105
+ * List available capabilities with optional filtering
106
+ */
107
+ static async listCapabilities(query = {}) {
108
+ let tools = ToolRegistry_1.ToolRegistry.getTools();
109
+ // Filter by category
110
+ if (query.category) {
111
+ tools = tools.filter(t => t.category === query.category);
112
+ }
113
+ // Filter by keyword (searches name, description, keywords, useCases)
114
+ if (query.keyword) {
115
+ const keyword = query.keyword.toLowerCase();
116
+ tools = tools.filter(t => {
117
+ const searchText = [
118
+ t.name,
119
+ t.description,
120
+ ...(t.keywords || []),
121
+ ...(t.useCases || []),
122
+ ].join(' ').toLowerCase();
123
+ return searchText.includes(keyword);
124
+ });
125
+ }
126
+ // Note: ToolMetadata doesn't have platformSupport or enabled,
127
+ // so we skip those filters for now
128
+ // Limit results
129
+ if (query.limit && query.limit > 0) {
130
+ tools = tools.slice(0, query.limit);
131
+ }
132
+ // Map to summaries
133
+ return tools.map(t => ({
134
+ toolId: t.toolId,
135
+ name: t.name,
136
+ description: t.description,
137
+ category: t.category,
138
+ aiEnabled: t.aiEnabled,
139
+ }));
140
+ }
141
+ /**
142
+ * Get detailed information about a specific tool
143
+ */
144
+ static async describe(toolId) {
145
+ const tool = ToolRegistry_1.ToolRegistry.getTool(toolId);
146
+ if (!tool) {
147
+ // Try to find by name instead of full ID
148
+ const allTools = ToolRegistry_1.ToolRegistry.getTools();
149
+ const byName = allTools.find(t => t.name === toolId);
150
+ if (byName) {
151
+ return byName;
152
+ }
153
+ // Provide suggestions
154
+ const suggestions = this.suggestTools(toolId);
155
+ const suggestText = suggestions.length > 0
156
+ ? `Did you mean: ${suggestions.join(', ')}?`
157
+ : '';
158
+ throw new Error(`Tool "${toolId}" not found. ${suggestText}`);
159
+ }
160
+ return tool;
161
+ }
162
+ /**
163
+ * Suggest similar tool names (for error messages)
164
+ */
165
+ static suggestTools(invalidName) {
166
+ const allTools = ToolRegistry_1.ToolRegistry.getTools();
167
+ // Calculate similarity scores
168
+ const scored = allTools
169
+ .map(tool => ({
170
+ name: tool.name,
171
+ toolId: tool.toolId,
172
+ score: Math.max(similarityScore(invalidName, tool.name), similarityScore(invalidName, tool.toolId)),
173
+ }))
174
+ .filter(item => item.score >= this.SIMILARITY_THRESHOLD)
175
+ .sort((a, b) => b.score - a.score)
176
+ .slice(0, this.MAX_SUGGESTIONS);
177
+ return scored.map(item => item.name);
178
+ }
179
+ /**
180
+ * Search tools by natural language query
181
+ */
182
+ static async search(query) {
183
+ const keywords = query.toLowerCase().split(/\s+/);
184
+ const allTools = ToolRegistry_1.ToolRegistry.getTools();
185
+ // Score each tool based on keyword matches
186
+ const scored = allTools.map(tool => {
187
+ const searchText = [
188
+ tool.name,
189
+ tool.description,
190
+ ...(tool.keywords || []),
191
+ ...(tool.useCases || []),
192
+ ].join(' ').toLowerCase();
193
+ // Count keyword matches
194
+ const matches = keywords.filter(kw => searchText.includes(kw)).length;
195
+ const score = matches / keywords.length;
196
+ return { tool, score };
197
+ });
198
+ // Filter and sort by score
199
+ return scored
200
+ .filter(item => item.score > 0)
201
+ .sort((a, b) => b.score - a.score)
202
+ .map(item => ({
203
+ toolId: item.tool.toolId,
204
+ name: item.tool.name,
205
+ description: item.tool.description,
206
+ category: item.tool.category,
207
+ aiEnabled: item.tool.aiEnabled,
208
+ }));
209
+ }
210
+ /**
211
+ * Get tool suggestions based on current context
212
+ */
213
+ static async suggestByContext(context) {
214
+ const allTools = ToolRegistry_1.ToolRegistry.getTools();
215
+ let suggestions = allTools;
216
+ // Note: ToolMetadata doesn't have prerequisites, so we skip that filter
217
+ // Filter by category if provided
218
+ if (context.currentCategory) {
219
+ suggestions = suggestions.filter(t => t.category === context.currentCategory);
220
+ }
221
+ // Exclude recently used tools
222
+ if (context.recentTools && context.recentTools.length > 0) {
223
+ suggestions = suggestions.filter(t => !context.recentTools.includes(t.toolId));
224
+ }
225
+ // Limit to top suggestions
226
+ return suggestions.slice(0, 10).map(t => ({
227
+ toolId: t.toolId,
228
+ name: t.name,
229
+ description: t.description,
230
+ category: t.category,
231
+ aiEnabled: t.aiEnabled,
232
+ }));
233
+ }
234
+ /**
235
+ * Wrap tool execution with suggestion on error
236
+ */
237
+ static async executeWithSuggestions(toolId, executor) {
238
+ try {
239
+ return await executor();
240
+ }
241
+ catch (err) {
242
+ // If tool not found, add suggestions
243
+ if (err.message?.includes('not found')) {
244
+ const suggestions = this.suggestTools(toolId);
245
+ if (suggestions.length > 0) {
246
+ err.message += `\n\nDid you mean: ${suggestions.join(', ')}?`;
247
+ }
248
+ }
249
+ throw err;
250
+ }
251
+ }
252
+ }
253
+ exports.SystemTools = SystemTools;
254
+ /**
255
+ * Similarity threshold for suggestions
256
+ */
257
+ SystemTools.SIMILARITY_THRESHOLD = 0.6;
258
+ /**
259
+ * Maximum suggestions to return
260
+ */
261
+ SystemTools.MAX_SUGGESTIONS = 5;
262
+ //# sourceMappingURL=SystemTools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SystemTools.js","sourceRoot":"","sources":["../../../../src/tools/SystemTools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ "use strict";
2
+ /**
3
+ * Classified Tool Interface
4
+ *
5
+ * Extends the base Tool interface with classification metadata for
6
+ * intelligent discovery, organization, and context-aware selection.
7
+ */
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.ToolComplexity = exports.ToolFrequency = exports.ToolPermissionTier = exports.ToolAccessLevel = void 0;
10
+ /**
11
+ * Access levels for tool execution
12
+ */
13
+ var ToolAccessLevel;
14
+ (function (ToolAccessLevel) {
15
+ ToolAccessLevel["INTERNAL"] = "internal";
16
+ ToolAccessLevel["EXTERNAL"] = "external";
17
+ ToolAccessLevel["HYBRID"] = "hybrid";
18
+ })(ToolAccessLevel || (exports.ToolAccessLevel = ToolAccessLevel = {}));
19
+ /**
20
+ * Permission tiers for safety classification
21
+ */
22
+ var ToolPermissionTier;
23
+ (function (ToolPermissionTier) {
24
+ ToolPermissionTier["SAFE"] = "safe";
25
+ ToolPermissionTier["MODERATE"] = "moderate";
26
+ ToolPermissionTier["SENSITIVE"] = "sensitive";
27
+ ToolPermissionTier["SYSTEM"] = "system";
28
+ })(ToolPermissionTier || (exports.ToolPermissionTier = ToolPermissionTier = {}));
29
+ /**
30
+ * Tool usage frequency for optimization
31
+ */
32
+ var ToolFrequency;
33
+ (function (ToolFrequency) {
34
+ ToolFrequency["VERY_HIGH"] = "very-high";
35
+ ToolFrequency["HIGH"] = "high";
36
+ ToolFrequency["MEDIUM"] = "medium";
37
+ ToolFrequency["LOW"] = "low";
38
+ ToolFrequency["SPECIALIZED"] = "specialized";
39
+ })(ToolFrequency || (exports.ToolFrequency = ToolFrequency = {}));
40
+ /**
41
+ * Tool complexity levels
42
+ */
43
+ var ToolComplexity;
44
+ (function (ToolComplexity) {
45
+ ToolComplexity["SIMPLE"] = "simple";
46
+ ToolComplexity["MODERATE"] = "moderate";
47
+ ToolComplexity["COMPLEX"] = "complex";
48
+ ToolComplexity["ADVANCED"] = "advanced";
49
+ })(ToolComplexity || (exports.ToolComplexity = ToolComplexity = {}));
50
+ //# sourceMappingURL=ClassifiedTool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ClassifiedTool.js","sourceRoot":"","sources":["../../../../src/types/ClassifiedTool.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH;;GAEG;AACH,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,wCAAqB,CAAA;IACrB,wCAAqB,CAAA;IACrB,oCAAiB,CAAA;AACnB,CAAC,EAJW,eAAe,+BAAf,eAAe,QAI1B;AAED;;GAEG;AACH,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,2CAAqB,CAAA;IACrB,6CAAuB,CAAA;IACvB,uCAAiB,CAAA;AACnB,CAAC,EALW,kBAAkB,kCAAlB,kBAAkB,QAK7B;AAED;;GAEG;AACH,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,wCAAuB,CAAA;IACvB,8BAAa,CAAA;IACb,kCAAiB,CAAA;IACjB,4BAAW,CAAA;IACX,4CAA2B,CAAA;AAC7B,CAAC,EANW,aAAa,6BAAb,aAAa,QAMxB;AAED;;GAEG;AACH,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,mCAAiB,CAAA;IACjB,uCAAqB,CAAA;IACrB,qCAAmB,CAAA;IACnB,uCAAqB,CAAA;AACvB,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB"}
@@ -0,0 +1,30 @@
1
+ "use strict";
2
+ /**
3
+ * Component State Types
4
+ *
5
+ * Type-safe definitions for component state including UI widgets and function tools.
6
+ * Uses discriminated unions for type safety.
7
+ */
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.isUIComponentState = isUIComponentState;
10
+ exports.isFunctionToolState = isFunctionToolState;
11
+ exports.isApplicationState = isApplicationState;
12
+ /**
13
+ * Type guard for UI components
14
+ */
15
+ function isUIComponentState(state) {
16
+ return state.kind === 'ui-component';
17
+ }
18
+ /**
19
+ * Type guard for function tools
20
+ */
21
+ function isFunctionToolState(state) {
22
+ return state.kind === 'function-tool';
23
+ }
24
+ /**
25
+ * Type guard for application state
26
+ */
27
+ function isApplicationState(state) {
28
+ return state.kind === 'application';
29
+ }
30
+ //# sourceMappingURL=ComponentState.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ComponentState.js","sourceRoot":"","sources":["../../../../src/types/ComponentState.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA2TH,gDAEC;AAKD,kDAEC;AAKD,gDAEC;AAnBD;;GAEG;AACH,SAAgB,kBAAkB,CAAC,KAAqB;IACtD,OAAO,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,KAAqB;IACvD,OAAO,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,KAAqB;IACtD,OAAO,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC;AACtC,CAAC"}
@@ -0,0 +1,9 @@
1
+ "use strict";
2
+ /**
3
+ * Discoverable Tool Provider Interface
4
+ *
5
+ * Extends the base ToolProvider with classification and discovery capabilities.
6
+ * Provides methods for intelligent tool discovery and metadata management.
7
+ */
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ //# sourceMappingURL=DiscoverableToolProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"DiscoverableToolProvider.js","sourceRoot":"","sources":["../../../../src/types/DiscoverableToolProvider.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}
@@ -0,0 +1,25 @@
1
+ "use strict";
2
+ /**
3
+ * Tool Exposure State Types (REQ-004)
4
+ *
5
+ * Production-quality types for state-dependent tool exposure detection.
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.ExposureState = void 0;
9
+ /**
10
+ * Represents the current exposure state of a tool in the UI
11
+ */
12
+ var ExposureState;
13
+ (function (ExposureState) {
14
+ /** Tool's DOM element does not exist in the document */
15
+ ExposureState[ExposureState["NOT_PRESENT"] = 0] = "NOT_PRESENT";
16
+ /** Tool exists in DOM but may not be visible (display:none, hidden, etc) */
17
+ ExposureState[ExposureState["PRESENT"] = 1] = "PRESENT";
18
+ /** Tool is visible (not hidden, has non-zero dimensions) */
19
+ ExposureState[ExposureState["VISIBLE"] = 2] = "VISIBLE";
20
+ /** Tool is visible AND currently in viewport (IntersectionObserver) */
21
+ ExposureState[ExposureState["EXPOSED"] = 3] = "EXPOSED";
22
+ /** Tool is exposed AND enabled (not disabled, not aria-disabled) */
23
+ ExposureState[ExposureState["INTERACTABLE"] = 4] = "INTERACTABLE";
24
+ })(ExposureState || (exports.ExposureState = ExposureState = {}));
25
+ //# sourceMappingURL=ExposureState.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ExposureState.js","sourceRoot":"","sources":["../../../../src/types/ExposureState.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH;;GAEG;AACH,IAAY,aAeX;AAfD,WAAY,aAAa;IACvB,wDAAwD;IACxD,+DAAe,CAAA;IAEf,4EAA4E;IAC5E,uDAAW,CAAA;IAEX,4DAA4D;IAC5D,uDAAW,CAAA;IAEX,uEAAuE;IACvE,uDAAW,CAAA;IAEX,oEAAoE;IACpE,iEAAgB,CAAA;AAClB,CAAC,EAfW,aAAa,6BAAb,aAAa,QAexB"}
@@ -0,0 +1,8 @@
1
+ "use strict";
2
+ /**
3
+ * Navigation Graph Types (REQ-005)
4
+ *
5
+ * Production-quality types for context-aware tool discovery and navigation.
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ //# sourceMappingURL=NavigationGraph.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"NavigationGraph.js","sourceRoot":"","sources":["../../../../src/types/NavigationGraph.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}
@@ -0,0 +1,49 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.OperationType = void 0;
4
+ /**
5
+ * Operation Type Classifications
6
+ *
7
+ * Defines the type of operation a function tool performs.
8
+ * Used for function tools (not UI components).
9
+ */
10
+ var OperationType;
11
+ (function (OperationType) {
12
+ /**
13
+ * Reads data without side effects
14
+ */
15
+ OperationType["READ"] = "read";
16
+ /**
17
+ * Modifies existing data
18
+ */
19
+ OperationType["WRITE"] = "write";
20
+ /**
21
+ * Creates new data
22
+ */
23
+ OperationType["CREATE"] = "create";
24
+ /**
25
+ * Removes data
26
+ */
27
+ OperationType["DELETE"] = "delete";
28
+ /**
29
+ * Searches/queries data
30
+ */
31
+ OperationType["SEARCH"] = "search";
32
+ /**
33
+ * Validates data
34
+ */
35
+ OperationType["VALIDATE"] = "validate";
36
+ /**
37
+ * Transforms/processes data
38
+ */
39
+ OperationType["TRANSFORM"] = "transform";
40
+ /**
41
+ * Navigates between contexts
42
+ */
43
+ OperationType["NAVIGATE"] = "navigate";
44
+ /**
45
+ * Manages subscriptions/events
46
+ */
47
+ OperationType["SUBSCRIBE"] = "subscribe";
48
+ })(OperationType || (exports.OperationType = OperationType = {}));
49
+ //# sourceMappingURL=OperationType.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"OperationType.js","sourceRoot":"","sources":["../../../../src/types/OperationType.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,aA6CX;AA7CD,WAAY,aAAa;IACvB;;OAEG;IACH,8BAAa,CAAA;IAEb;;OAEG;IACH,gCAAe,CAAA;IAEf;;OAEG;IACH,kCAAiB,CAAA;IAEjB;;OAEG;IACH,kCAAiB,CAAA;IAEjB;;OAEG;IACH,kCAAiB,CAAA;IAEjB;;OAEG;IACH,sCAAqB,CAAA;IAErB;;OAEG;IACH,wCAAuB,CAAA;IAEvB;;OAEG;IACH,sCAAqB,CAAA;IAErB;;OAEG;IACH,wCAAuB,CAAA;AACzB,CAAC,EA7CW,aAAa,6BAAb,aAAa,QA6CxB"}
@@ -0,0 +1,39 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.StateManagers = void 0;
4
+ /**
5
+ * State Manager Names
6
+ *
7
+ * Enum defining named StateManager instances for multi-context support.
8
+ * Each name represents an isolated state tree for specific use cases.
9
+ *
10
+ * @example
11
+ * ```typescript
12
+ * const coreState = StateManager.getInstance(StateManagers.SupernalCoreV1, adapter);
13
+ * const userState = StateManager.getInstance(StateManagers.UserSession, adapter);
14
+ * ```
15
+ */
16
+ var StateManagers;
17
+ (function (StateManagers) {
18
+ /**
19
+ * Core application state manager (v1)
20
+ * Used for fundamental system state
21
+ */
22
+ StateManagers["SupernalCoreV1"] = "supernal_core_v1";
23
+ /**
24
+ * User session state manager
25
+ * Isolated user-specific data
26
+ */
27
+ StateManagers["UserSession"] = "user_session";
28
+ /**
29
+ * Testing state manager
30
+ * Used for test isolation
31
+ */
32
+ StateManagers["Testing"] = "testing";
33
+ /**
34
+ * Demo state manager
35
+ * For demo/example scenarios
36
+ */
37
+ StateManagers["Demo"] = "demo";
38
+ })(StateManagers || (exports.StateManagers = StateManagers = {}));
39
+ //# sourceMappingURL=StateManagers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StateManagers.js","sourceRoot":"","sources":["../../../../src/types/StateManagers.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;GAWG;AACH,IAAY,aAwBX;AAxBD,WAAY,aAAa;IACvB;;;OAGG;IACH,oDAAmC,CAAA;IAEnC;;;OAGG;IACH,6CAA4B,CAAA;IAE5B;;;OAGG;IACH,oCAAmB,CAAA;IAEnB;;;OAGG;IACH,8BAAa,CAAA;AACf,CAAC,EAxBW,aAAa,6BAAb,aAAa,QAwBxB"}
@@ -0,0 +1,41 @@
1
+ "use strict";
2
+ /**
3
+ * Tool Interface
4
+ *
5
+ * This interface defines the structure for callable tools that can be used by LLMs.
6
+ * Tools are exposed by ToolProviders and follow industry standards for compatibility
7
+ * with OpenAI, Anthropic, and LangChain.
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.ToolCategory = void 0;
11
+ /**
12
+ * Category of tool functionality
13
+ */
14
+ var ToolCategory;
15
+ (function (ToolCategory) {
16
+ // Original categories
17
+ ToolCategory["CONTENT_CREATION"] = "content_creation";
18
+ ToolCategory["CONTENT_RETRIEVAL"] = "content_retrieval";
19
+ ToolCategory["DATA_MANIPULATION"] = "data_manipulation";
20
+ ToolCategory["EXTERNAL_SERVICE"] = "external_service";
21
+ ToolCategory["SYSTEM"] = "system";
22
+ ToolCategory["USER_INTERACTION"] = "user_interaction";
23
+ // Extended categories from ClassifiedTool
24
+ ToolCategory["MEMORY"] = "memory";
25
+ ToolCategory["DATA"] = "data";
26
+ ToolCategory["SEARCH"] = "search";
27
+ ToolCategory["UTILITY"] = "utility";
28
+ ToolCategory["TIME"] = "time";
29
+ ToolCategory["DOM"] = "dom";
30
+ ToolCategory["API"] = "api";
31
+ ToolCategory["FILE"] = "file";
32
+ ToolCategory["COMMUNICATION"] = "communication";
33
+ ToolCategory["CONTEXT_APP"] = "context-app";
34
+ ToolCategory["WORKFLOW"] = "workflow";
35
+ // New categories for specialized tools
36
+ ToolCategory["CHAT"] = "chat";
37
+ ToolCategory["SETTINGS"] = "settings";
38
+ ToolCategory["NAVIGATION"] = "navigation";
39
+ ToolCategory["ONBOARDING"] = "onboarding";
40
+ })(ToolCategory || (exports.ToolCategory = ToolCategory = {}));
41
+ //# sourceMappingURL=Tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Tool.js","sourceRoot":"","sources":["../../../../src/types/Tool.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAIH;;GAEG;AACH,IAAY,YA2BX;AA3BD,WAAY,YAAY;IACtB,sBAAsB;IACtB,qDAAqC,CAAA;IACrC,uDAAuC,CAAA;IACvC,uDAAuC,CAAA;IACvC,qDAAqC,CAAA;IACrC,iCAAiB,CAAA;IACjB,qDAAqC,CAAA;IAErC,0CAA0C;IAC1C,iCAAiB,CAAA;IACjB,6BAAa,CAAA;IACb,iCAAiB,CAAA;IACjB,mCAAmB,CAAA;IACnB,6BAAa,CAAA;IACb,2BAAW,CAAA;IACX,2BAAW,CAAA;IACX,6BAAa,CAAA;IACb,+CAA+B,CAAA;IAC/B,2CAA2B,CAAA;IAC3B,qCAAqB,CAAA;IAErB,uCAAuC;IACvC,6BAAa,CAAA;IACb,qCAAqB,CAAA;IACrB,yCAAyB,CAAA;IACzB,yCAAyB,CAAA;AAC3B,CAAC,EA3BW,YAAY,4BAAZ,YAAY,QA2BvB"}
@@ -0,0 +1,54 @@
1
+ "use strict";
2
+ /**
3
+ * Tool Permissions Interface
4
+ *
5
+ * This interface defines the permission model for tools that can be called by LLMs.
6
+ * It follows a standardized approach to tool access control and security.
7
+ */
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.ToolPermissionScope = exports.ToolPermissionLevel = void 0;
10
+ /**
11
+ * Permission level for tool execution
12
+ */
13
+ var ToolPermissionLevel;
14
+ (function (ToolPermissionLevel) {
15
+ /**
16
+ * User must approve each tool execution
17
+ */
18
+ ToolPermissionLevel["ALWAYS_REQUIRE_APPROVAL"] = "always_require_approval";
19
+ /**
20
+ * User approves once, then allowed for session
21
+ */
22
+ ToolPermissionLevel["APPROVE_ONCE"] = "approve_once";
23
+ /**
24
+ * Automatically approved for non-sensitive tools
25
+ */
26
+ ToolPermissionLevel["AUTO_APPROVE"] = "auto_approve";
27
+ /**
28
+ * Can only be called by system components, not LLMs
29
+ */
30
+ ToolPermissionLevel["SYSTEM_ONLY"] = "system_only";
31
+ })(ToolPermissionLevel || (exports.ToolPermissionLevel = ToolPermissionLevel = {}));
32
+ /**
33
+ * Permission scope for tools
34
+ */
35
+ var ToolPermissionScope;
36
+ (function (ToolPermissionScope) {
37
+ // Data access scopes
38
+ ToolPermissionScope["DATA_READ"] = "data:read";
39
+ ToolPermissionScope["DATA_WRITE"] = "data:write";
40
+ ToolPermissionScope["DATA_DELETE"] = "data:delete";
41
+ // Content scopes
42
+ ToolPermissionScope["CONTENT_READ"] = "content:read";
43
+ ToolPermissionScope["CONTENT_WRITE"] = "content:write";
44
+ ToolPermissionScope["CONTENT_DELETE"] = "content:delete";
45
+ // External service scopes
46
+ ToolPermissionScope["EXTERNAL_SERVICE"] = "external:service";
47
+ ToolPermissionScope["NETWORK_ACCESS"] = "network:access";
48
+ // User interaction scopes
49
+ ToolPermissionScope["USER_INTERACTION"] = "user:interaction";
50
+ ToolPermissionScope["USER_NOTIFICATION"] = "user:notification";
51
+ // System scopes
52
+ ToolPermissionScope["SYSTEM_ACCESS"] = "system:access";
53
+ })(ToolPermissionScope || (exports.ToolPermissionScope = ToolPermissionScope = {}));
54
+ //# sourceMappingURL=ToolPermissions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ToolPermissions.js","sourceRoot":"","sources":["../../../../src/types/ToolPermissions.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;GAEG;AACH,IAAY,mBAoBX;AApBD,WAAY,mBAAmB;IAC7B;;OAEG;IACH,0EAAmD,CAAA;IAEnD;;OAEG;IACH,oDAA6B,CAAA;IAE7B;;OAEG;IACH,oDAA6B,CAAA;IAE7B;;OAEG;IACH,kDAA2B,CAAA;AAC7B,CAAC,EApBW,mBAAmB,mCAAnB,mBAAmB,QAoB9B;AAED;;GAEG;AACH,IAAY,mBAqBX;AArBD,WAAY,mBAAmB;IAC7B,qBAAqB;IACrB,8CAAuB,CAAA;IACvB,gDAAyB,CAAA;IACzB,kDAA2B,CAAA;IAE3B,iBAAiB;IACjB,oDAA6B,CAAA;IAC7B,sDAA+B,CAAA;IAC/B,wDAAiC,CAAA;IAEjC,0BAA0B;IAC1B,4DAAqC,CAAA;IACrC,wDAAiC,CAAA;IAEjC,0BAA0B;IAC1B,4DAAqC,CAAA;IACrC,8DAAuC,CAAA;IAEvC,gBAAgB;IAChB,sDAA+B,CAAA;AACjC,CAAC,EArBW,mBAAmB,mCAAnB,mBAAmB,QAqB9B"}
@@ -0,0 +1,25 @@
1
+ "use strict";
2
+ /**
3
+ * Tool Result Interface
4
+ *
5
+ * This interface defines the structure for results returned from tool executions.
6
+ * It is designed to be compatible with various LLM providers while maintaining
7
+ * a standardized structure across our platform.
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.ToolExecutionStatus = void 0;
11
+ /**
12
+ * Status of a tool execution
13
+ */
14
+ var ToolExecutionStatus;
15
+ (function (ToolExecutionStatus) {
16
+ ToolExecutionStatus["SUCCESS"] = "success";
17
+ ToolExecutionStatus["ERROR"] = "error";
18
+ ToolExecutionStatus["PARTIAL"] = "partial";
19
+ ToolExecutionStatus["CANCELLED"] = "cancelled";
20
+ ToolExecutionStatus["TIMEOUT"] = "timeout";
21
+ ToolExecutionStatus["PERMISSION_DENIED"] = "permission_denied";
22
+ ToolExecutionStatus["PENDING"] = "pending";
23
+ ToolExecutionStatus["RUNNING"] = "running";
24
+ })(ToolExecutionStatus || (exports.ToolExecutionStatus = ToolExecutionStatus = {}));
25
+ //# sourceMappingURL=ToolResult.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ToolResult.js","sourceRoot":"","sources":["../../../../src/types/ToolResult.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;GAEG;AACH,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B,0CAAmB,CAAA;IACnB,sCAAe,CAAA;IACf,0CAAmB,CAAA;IACnB,8CAAuB,CAAA;IACvB,0CAAmB,CAAA;IACnB,8DAAuC,CAAA;IACvC,0CAAmB,CAAA;IACnB,0CAAmB,CAAA;AACrB,CAAC,EATW,mBAAmB,mCAAnB,mBAAmB,QAS9B"}