nolo-cli 0.1.40 → 0.1.42

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 (482) hide show
  1. package/README.md +27 -12
  2. package/agent-runtime/agentThread.ts +222 -0
  3. package/agent-runtime/agentThreadAdmission.ts +74 -0
  4. package/agent-runtime/dialogWritePlan.ts +42 -0
  5. package/agent-runtime/hostAdapter.ts +1 -0
  6. package/agent-runtime/hybridRecordStore.ts +5 -3
  7. package/agent-runtime/index.ts +43 -0
  8. package/agent-runtime/localLoop.ts +31 -2
  9. package/agent-runtime/localToolPolicy.ts +1 -0
  10. package/agent-runtime/localWorkspaceTools.ts +1258 -78
  11. package/agent-runtime/noloWorkspaceTools.ts +20 -1
  12. package/agent-runtime/runtimeToolPolicy.ts +1 -5
  13. package/agent-runtime/runtimeToolSurface.ts +1 -0
  14. package/agentAliases.ts +29 -9
  15. package/agentInternalCommandEntries.ts +11 -3
  16. package/agentMachineCommands.ts +1 -0
  17. package/agentRecordCommands.ts +2 -2
  18. package/agentRecordHelpers.ts +59 -6
  19. package/agentRunCommand.ts +84 -19
  20. package/ai/agent/_executeModel.ts +146 -0
  21. package/ai/agent/agentSlice.ts +556 -1
  22. package/ai/agent/appWorkingMemory.ts +126 -0
  23. package/ai/agent/buildEditingContext.ts +378 -0
  24. package/ai/agent/buildSystemPrompt.ts +599 -0
  25. package/ai/agent/canvasEditingContext.ts +49 -0
  26. package/ai/agent/cleanAgentMessages.ts +140 -0
  27. package/ai/agent/cliChatClient.ts +153 -0
  28. package/ai/agent/cliExecutor.ts +264 -46
  29. package/ai/agent/contextCompiler.ts +107 -0
  30. package/ai/agent/contextLayerContract.ts +44 -0
  31. package/ai/agent/createAgentSchema.ts +272 -0
  32. package/ai/agent/currentTimeContext.ts +65 -0
  33. package/ai/agent/executeToolCall.ts +58 -0
  34. package/ai/agent/fetchAgentContexts.ts +42 -0
  35. package/ai/agent/generatePrompt.ts +3 -0
  36. package/ai/agent/getFullChatContextKeys.ts +168 -0
  37. package/ai/agent/guidedCreation/capabilities.ts +84 -0
  38. package/ai/agent/guidedCreation/types.ts +38 -0
  39. package/ai/agent/isLiveAudioOnlyAgent.ts +26 -0
  40. package/ai/agent/liveAudioModel.ts +2 -0
  41. package/ai/agent/pageBuilderHandoffRules.ts +75 -0
  42. package/ai/agent/persistMessageWithFixedId.ts +37 -0
  43. package/ai/agent/planSlice.ts +259 -0
  44. package/ai/agent/referenceUtils.ts +229 -0
  45. package/ai/agent/runAgentBackground.ts +310 -0
  46. package/ai/agent/runAgentClientLoop.ts +164 -0
  47. package/ai/agent/runtimeGuidance.ts +116 -0
  48. package/ai/agent/serverOrigin.ts +7 -0
  49. package/ai/agent/startParallelAgentStreams.ts +424 -0
  50. package/ai/agent/startupProtocol.ts +53 -0
  51. package/ai/agent/streamAgentChatTurn.ts +2135 -0
  52. package/ai/agent/streamAgentChatTurnUtils.ts +923 -0
  53. package/ai/agent/toolFailureGuard.ts +99 -0
  54. package/ai/agent/types.ts +73 -0
  55. package/ai/agent/utils/imageOutput.ts +37 -0
  56. package/ai/agent/utils/publicImageAgentMode.ts +26 -0
  57. package/ai/ai.locale.ts +1165 -0
  58. package/ai/chat/accumulateToolCallChunks.ts +126 -0
  59. package/ai/chat/fetchUtils.ts +143 -0
  60. package/ai/chat/inlineImageUrlsForCustomProvider.ts +122 -0
  61. package/ai/chat/parseApiError.ts +67 -0
  62. package/ai/chat/parseMultilineSSE.ts +95 -0
  63. package/ai/chat/sendOpenAICompletionsRequest.ts +921 -0
  64. package/ai/chat/sendOpenAIResponseRequest.ts +720 -0
  65. package/ai/chat/serverProxyRetry.ts +102 -0
  66. package/ai/chat/shouldUseServerProxy.ts +18 -0
  67. package/ai/chat/streamRetry.ts +46 -0
  68. package/ai/chat/updateTotalUsage.ts +89 -0
  69. package/ai/context/buildReferenceContext.ts +437 -0
  70. package/ai/context/retention.ts +165 -0
  71. package/ai/context/tokenUtils.ts +78 -0
  72. package/ai/llm/agentCapabilities.ts +74 -0
  73. package/ai/llm/deepinfra.ts +79 -0
  74. package/ai/llm/fireworks.ts +68 -0
  75. package/ai/llm/generateRequestBody.ts +165 -0
  76. package/ai/llm/getModelContextWindow.ts +93 -0
  77. package/ai/llm/getPricing.ts +252 -0
  78. package/ai/llm/imagePricing.ts +66 -0
  79. package/ai/llm/isResponseAPIModel.ts +13 -0
  80. package/ai/llm/kimi.ts +22 -0
  81. package/ai/llm/mimo.ts +99 -0
  82. package/ai/llm/mistral.ts +21 -0
  83. package/ai/llm/models.ts +45 -0
  84. package/ai/llm/openrouterModels.ts +31 -0
  85. package/ai/llm/providers.ts +313 -0
  86. package/ai/llm/reasoningModels.ts +27 -0
  87. package/ai/llm/types.ts +82 -0
  88. package/ai/llm/usageRequestOptions.ts +59 -0
  89. package/ai/memory/policy.ts +49 -0
  90. package/ai/memory/queryShared.ts +167 -0
  91. package/ai/memory/recentRelationshipRecap.ts +251 -0
  92. package/ai/memory/remember.ts +111 -0
  93. package/ai/memory/scope.ts +74 -0
  94. package/ai/memory/store.ts +20 -0
  95. package/ai/memory/storeShared.ts +76 -0
  96. package/ai/memory/types.ts +52 -0
  97. package/ai/memory/understanding.ts +341 -0
  98. package/ai/memory/understandingGreeting.ts +264 -0
  99. package/ai/policy/personalizationDialog.ts +333 -0
  100. package/ai/policy/runtimePolicy.ts +526 -0
  101. package/ai/policy/selfUpdateFields.ts +48 -0
  102. package/ai/policy/types.ts +64 -0
  103. package/ai/skills/referenceRuntime.ts +274 -0
  104. package/ai/skills/skillDiagnostics.ts +251 -0
  105. package/ai/skills/skillDocBuilder.ts +139 -0
  106. package/ai/skills/skillSummaryMarker.ts +26 -0
  107. package/ai/token/calculatePrice.ts +576 -0
  108. package/ai/token/missingUsageEstimate.ts +42 -0
  109. package/ai/token/normalizeUsage.ts +124 -0
  110. package/ai/token/openaiImageGenerationUsage.ts +56 -0
  111. package/ai/token/prepareTokenUsageData.ts +93 -0
  112. package/ai/token/resolveBillingTarget.ts +52 -0
  113. package/ai/token/saveTokenRecord.ts +53 -0
  114. package/ai/token/types.ts +103 -0
  115. package/ai/tools/agent/agentTools.ts +214 -0
  116. package/ai/tools/agent/agentUpdateShared.ts +311 -0
  117. package/ai/tools/agent/callAgentTool.ts +139 -0
  118. package/ai/tools/agent/createAgentTool.ts +512 -0
  119. package/ai/tools/agent/createDialogTool.ts +69 -0
  120. package/ai/tools/agent/createSkillAgentTool.ts +62 -0
  121. package/ai/tools/agent/parallelBudget.ts +221 -0
  122. package/ai/tools/agent/prepareAgentDraftTool.ts +159 -0
  123. package/ai/tools/agent/presets/appBuilderPreset.ts +154 -0
  124. package/ai/tools/agent/runLlmTool.ts +96 -0
  125. package/ai/tools/agent/runStreamingAgentTool.ts +73 -0
  126. package/ai/tools/agent/skillAgentArgs.ts +106 -0
  127. package/ai/tools/agent/startAgentDialogTool.ts +54 -0
  128. package/ai/tools/agent/streamParallelAgentsTool.ts +123 -0
  129. package/ai/tools/agent/updateAgentTool.ts +96 -0
  130. package/ai/tools/agent/updateSelfTool.ts +113 -0
  131. package/ai/tools/amazonProductScraperTool.ts +86 -0
  132. package/ai/tools/apifyActorClient.ts +45 -0
  133. package/ai/tools/appEditGuard.ts +372 -0
  134. package/ai/tools/appReadSnapshot.ts +153 -0
  135. package/ai/tools/appTools.ts +1549 -0
  136. package/ai/tools/applyEditTool.ts +259 -0
  137. package/ai/tools/applyLineEditsTool.ts +315 -0
  138. package/ai/tools/browserTools/click.ts +33 -0
  139. package/ai/tools/browserTools/closeSession.ts +29 -0
  140. package/ai/tools/browserTools/common.ts +27 -0
  141. package/ai/tools/browserTools/openSession.ts +48 -0
  142. package/ai/tools/browserTools/readContent.ts +38 -0
  143. package/ai/tools/browserTools/selectOption.ts +46 -0
  144. package/ai/tools/browserTools/typeText.ts +42 -0
  145. package/ai/tools/category/createCategoryTool.ts +66 -0
  146. package/ai/tools/category/queryContentsByCategoryTool.ts +69 -0
  147. package/ai/tools/category/updateContentCategoryTool.ts +75 -0
  148. package/ai/tools/cfBrowserTools.ts +319 -0
  149. package/ai/tools/cfSpeechToTextTool.ts +49 -0
  150. package/ai/tools/checkEnvTool.ts +102 -0
  151. package/ai/tools/cloudflareCrawlTool.ts +289 -0
  152. package/ai/tools/codeSearchTool.ts +123 -0
  153. package/ai/tools/codeTools.ts +101 -0
  154. package/ai/tools/convertMarxistsBookTool.ts +103 -0
  155. package/ai/tools/createDocTool.ts +132 -0
  156. package/ai/tools/createSkillDocTool.ts +155 -0
  157. package/ai/tools/createWorkflowTool.ts +154 -0
  158. package/ai/tools/delayTool.ts +31 -0
  159. package/ai/tools/deleteSpacesTool.ts +325 -0
  160. package/ai/tools/deleteSpacesToolModel.ts +159 -0
  161. package/ai/tools/devReloadUtils.ts +29 -0
  162. package/ai/tools/dialogMessageSearch.ts +137 -0
  163. package/ai/tools/doctorSkillTool.ts +72 -0
  164. package/ai/tools/ecommerceScraperTool.ts +86 -0
  165. package/ai/tools/emailTools.ts +549 -0
  166. package/ai/tools/evalSkillTool.ts +92 -0
  167. package/ai/tools/exaSearchTool.ts +63 -0
  168. package/ai/tools/execShellTool.ts +266 -0
  169. package/ai/tools/executeSqlTool.ts +192 -0
  170. package/ai/tools/fetchWebpageSupport.ts +333 -0
  171. package/ai/tools/fetchWebpageTool.ts +97 -0
  172. package/ai/tools/geminiImagePreviewTool.ts +386 -0
  173. package/ai/tools/generateDocxTool.ts +215 -0
  174. package/ai/tools/googleSearchScraperTool.ts +106 -0
  175. package/ai/tools/importDataTool.ts +133 -0
  176. package/ai/tools/importSkillTool.ts +162 -0
  177. package/ai/tools/index.ts +2290 -0
  178. package/ai/tools/jdProductScraperTool.ts +821 -0
  179. package/ai/tools/listUserSpacesTool.ts +113 -0
  180. package/ai/tools/localFilesTool.ts +276 -0
  181. package/ai/tools/marxistsOfflineBook.ts +253 -0
  182. package/ai/tools/modelUsageTools.ts +206 -0
  183. package/ai/tools/noloWorkspaceReadTools.ts +467 -0
  184. package/ai/tools/olmOcrTool.ts +33 -0
  185. package/ai/tools/openaiImageTool.ts +267 -0
  186. package/ai/tools/prepareTools.ts +193 -0
  187. package/ai/tools/readDocTool.ts +88 -0
  188. package/ai/tools/readFileTool.ts +214 -0
  189. package/ai/tools/readTool.ts +194 -0
  190. package/ai/tools/readXPostTool.ts +229 -0
  191. package/ai/tools/readXhsProfileTool.ts +638 -0
  192. package/ai/tools/rememberMemoryTool.ts +84 -0
  193. package/ai/tools/remotionVideoTool.ts +151 -0
  194. package/ai/tools/searchDialogMessagesTool.ts +222 -0
  195. package/ai/tools/searchWorkspaceTool.ts +259 -0
  196. package/ai/tools/skillFollowup.ts +86 -0
  197. package/ai/tools/surfWeatherTool.ts +169 -0
  198. package/ai/tools/table/addTableRowTool.ts +217 -0
  199. package/ai/tools/table/createTableTool.ts +326 -0
  200. package/ai/tools/table/rowTools.ts +386 -0
  201. package/ai/tools/table/schemaTools.ts +244 -0
  202. package/ai/tools/table/shareTableTool.ts +148 -0
  203. package/ai/tools/table/toolShared.ts +129 -0
  204. package/ai/tools/taobaoTmallProductScraperTool.ts +49 -0
  205. package/ai/tools/toolApiClient.ts +279 -0
  206. package/ai/tools/toolPacks.ts +19 -0
  207. package/ai/tools/toolResultError.ts +42 -0
  208. package/ai/tools/toolRunSlice.ts +303 -0
  209. package/ai/tools/toolSchemaCompatibility.ts +53 -0
  210. package/ai/tools/uiAskChoiceTool.ts +104 -0
  211. package/ai/tools/updateContentTitleTool.ts +84 -0
  212. package/ai/tools/updateDocTool.ts +105 -0
  213. package/ai/tools/updateUserPreferenceProfileTool.ts +153 -0
  214. package/ai/tools/wereadGatewayTool.ts +152 -0
  215. package/ai/tools/whisperTool.ts +76 -0
  216. package/ai/tools/writeFileTool.ts +213 -0
  217. package/ai/tools/youtubeScraperTool.ts +116 -0
  218. package/ai/tools/ziweiChartTool.ts +678 -0
  219. package/ai/types.ts +58 -0
  220. package/ai/workflow/workflowExecutor.ts +323 -0
  221. package/ai/workflow/workflowSlice.ts +73 -0
  222. package/ai/workflow/workflowTypes.ts +106 -0
  223. package/app/actions/syncAppRecord.ts +73 -0
  224. package/app/constants/animationSets.ts +21 -0
  225. package/app/constants/appEditor.ts +99 -0
  226. package/app/favorite/deletedFavoriteProjection.ts +31 -0
  227. package/app/favorite/favoriteSlice.ts +690 -0
  228. package/app/favorite/type.ts +43 -0
  229. package/app/hooks/deleteDbKey.ts +254 -0
  230. package/app/i18n/client.ts +13 -0
  231. package/app/i18n/i18n.base.ts +14 -0
  232. package/app/i18n/i18n.config.ts +77 -0
  233. package/app/i18n/index.ts +15 -0
  234. package/app/i18n/mapLanguage.ts +11 -0
  235. package/app/i18n/translations/appBuilder.locale.ts +453 -0
  236. package/app/i18n/translations/error.locale.ts +246 -0
  237. package/app/i18n/translations/interface.locale.ts +2206 -0
  238. package/app/i18n/translations/pricing.locale.ts +397 -0
  239. package/app/i18n/translations/privacy.locale.ts +168 -0
  240. package/app/i18n/translations/seo.locale.ts +129 -0
  241. package/app/i18n/translations/terms.locale.ts +124 -0
  242. package/app/i18n/types.ts +6 -0
  243. package/app/notifications/model.ts +77 -0
  244. package/app/notifications/notificationSlice.ts +141 -0
  245. package/app/reducer.ts +36 -0
  246. package/app/settings/dbActionThunks.ts +34 -0
  247. package/app/settings/defaultSpacePreference.ts +87 -0
  248. package/app/settings/settingSlice.tsx +1212 -0
  249. package/app/settings/settingsRecord.ts +8 -0
  250. package/app/stateViews/runtime.ts +90 -0
  251. package/app/store.ts +55 -0
  252. package/app/theme/colors.ts +280 -0
  253. package/app/theme/fontPreference.ts +77 -0
  254. package/app/theme/theme.config.ts +120 -0
  255. package/app/theme/themeModeBootstrap.ts +123 -0
  256. package/app/types/appSummary.ts +118 -0
  257. package/app/types.ts +358 -0
  258. package/app/utils/appKeys.ts +55 -0
  259. package/app/utils/async.ts +28 -0
  260. package/app/utils/desktopAgentRuntimeTurnClient.ts +75 -0
  261. package/app/utils/env.ts +17 -0
  262. package/app/utils/fileUtils.ts +229 -0
  263. package/app/utils/imageUtils.ts +274 -0
  264. package/app/utils/myContentItems.ts +289 -0
  265. package/app/utils/retryAfter.ts +36 -0
  266. package/app/utils/retryFetch.ts +61 -0
  267. package/app/utils/toast.ts +3 -0
  268. package/auth/action/signUpAction.ts +227 -0
  269. package/auth/adminPermissions.ts +78 -0
  270. package/auth/authSlice.ts +531 -0
  271. package/auth/client/loginRequest.ts +14 -0
  272. package/auth/resetAuthScopedClientState.ts +27 -0
  273. package/auth/routes.ts +183 -0
  274. package/auth/token.ts +63 -0
  275. package/auth/types.ts +40 -0
  276. package/chat/chat.locale.ts +817 -0
  277. package/chat/dialog/actions/addCybotAction.ts +52 -0
  278. package/chat/dialog/actions/addReferenceKeysAction.ts +62 -0
  279. package/chat/dialog/actions/builtinDialogLlm.ts +35 -0
  280. package/chat/dialog/actions/cleanupCliSession.ts +40 -0
  281. package/chat/dialog/actions/createDialogAction.ts +379 -0
  282. package/chat/dialog/actions/createScheduledTaskAction.ts +78 -0
  283. package/chat/dialog/actions/handleSendMessageAction.ts +202 -0
  284. package/chat/dialog/actions/handleSendMessageResolver.ts +27 -0
  285. package/chat/dialog/actions/removeCybotAction.ts +6 -0
  286. package/chat/dialog/actions/removeDialogAgentAction.ts +44 -0
  287. package/chat/dialog/actions/replacePrimaryCybotAction.ts +6 -0
  288. package/chat/dialog/actions/setPrimaryDialogAgentAction.ts +52 -0
  289. package/chat/dialog/actions/updateDialogSummaryAction.ts +430 -0
  290. package/chat/dialog/actions/updateDialogTitleAction.ts +151 -0
  291. package/chat/dialog/actions/updateDialogTitlePolicy.ts +30 -0
  292. package/chat/dialog/actions/updateTokensAction.ts +233 -0
  293. package/chat/dialog/dialogAgents.ts +72 -0
  294. package/chat/dialog/dialogAttachmentCleanup.ts +135 -0
  295. package/chat/dialog/dialogSlice.ts +985 -0
  296. package/chat/dialog/dialogTitle.ts +81 -0
  297. package/chat/dialog/dialogTokenStats.ts +12 -0
  298. package/chat/dialog/dialogUrl.ts +6 -0
  299. package/chat/dialog/goal.ts +108 -0
  300. package/chat/dialog/objectAssistantRegistry.ts +286 -0
  301. package/chat/dialog/schedule.ts +17 -0
  302. package/chat/messages/activityCompletion.ts +97 -0
  303. package/chat/messages/fetchAndCacheMessages.ts +119 -0
  304. package/chat/messages/fetchConvMsgs.ts +51 -0
  305. package/chat/messages/fileUrl.ts +13 -0
  306. package/chat/messages/imagePayloadPersistence.ts +22 -0
  307. package/chat/messages/messageAgent.ts +8 -0
  308. package/chat/messages/messageContent.ts +203 -0
  309. package/chat/messages/messageContract.ts +88 -0
  310. package/chat/messages/messageSlice.ts +1386 -0
  311. package/chat/messages/toolThunks.ts +646 -0
  312. package/chat/messages/types.ts +8 -1
  313. package/chat/messages/web/toolDisplayName.ts +686 -0
  314. package/cli/agentAliases.ts +29 -9
  315. package/cli/agentInternalCommandEntries.ts +11 -3
  316. package/cli/agentMachineCommands.ts +1 -0
  317. package/cli/agentRecordCommands.ts +2 -2
  318. package/cli/agentRecordHelpers.ts +59 -6
  319. package/cli/agentRunCommand.ts +84 -19
  320. package/cli/client/agentRun.ts +92 -261
  321. package/cli/client/localRuntimeAdapter.ts +292 -50
  322. package/cli/commandRegistry.ts +7 -4
  323. package/cli/dialogAttachmentCleanup.ts +151 -0
  324. package/cli/dialogCommands.ts +163 -61
  325. package/cli/dialogInternalCommandEntries.ts +1 -1
  326. package/cli/docCreateCommands.ts +345 -0
  327. package/cli/docInternalCommandEntries.ts +11 -0
  328. package/cli/docPageHelpers.ts +80 -0
  329. package/cli/docSkillHelpers.ts +67 -0
  330. package/cli/docSpaceHelpers.ts +46 -0
  331. package/cli/internalCommandEntries.ts +4 -0
  332. package/cli/machineCommands.ts +18 -34
  333. package/cli/memoryCommands.ts +253 -0
  334. package/cli/memoryInternalCommandEntries.ts +9 -0
  335. package/cli/qoderUsageProbe.ts +252 -0
  336. package/cli/scriptCommandEntries.ts +0 -3
  337. package/cli/secretScan.ts +31 -0
  338. package/cli/tableCommands.ts +248 -13
  339. package/cli/workflowInternalCommandEntries.ts +2 -3
  340. package/client/agentRun.test.ts +119 -83
  341. package/client/agentRun.ts +92 -261
  342. package/client/localRuntimeAdapter.test.ts +894 -32
  343. package/client/localRuntimeAdapter.ts +292 -50
  344. package/commandRegistry.ts +7 -4
  345. package/connector-experimental/capabilities.ts +10 -9
  346. package/core/builtinAgents.ts +209 -0
  347. package/core/config.ts +15 -0
  348. package/core/crypto.ts +51 -0
  349. package/core/generateKeyPairFromSeedV1.ts +15 -0
  350. package/core/generateMainKey.ts +22 -0
  351. package/core/init.ts +41 -0
  352. package/core/localOrigins.ts +8 -0
  353. package/core/password.ts +13 -0
  354. package/core/prefix.ts +23 -0
  355. package/create/editor/transforms/fromMarkdown/index.ts +260 -0
  356. package/create/editor/transforms/fromMarkdown/inline.ts +285 -0
  357. package/create/editor/transforms/fromMarkdown/table.ts +130 -0
  358. package/create/editor/transforms/markdownToSlate.ts +24 -0
  359. package/create/editor/transforms/slateToRenderMarkdown.ts +218 -0
  360. package/create/editor/transforms/slateToSimplifiedMarkdown.ts +224 -0
  361. package/create/editor/transforms/slateToText.ts +33 -0
  362. package/create/editor/utils/slateUtils.ts +233 -0
  363. package/create/space/addSpaceAction.ts +193 -0
  364. package/create/space/category/categoryActions.ts +427 -0
  365. package/create/space/changeSpaceAction.ts +36 -0
  366. package/create/space/constants.ts +8 -0
  367. package/create/space/content/addContentAction.ts +116 -0
  368. package/create/space/content/contentThunks.ts +90 -0
  369. package/create/space/content/deleteContentFromSpaceAction.ts +187 -0
  370. package/create/space/content/deleteMultipleContentAction.ts +112 -0
  371. package/create/space/content/moveContentAction.ts +285 -0
  372. package/create/space/content/updateContentCategoryAction.ts +154 -0
  373. package/create/space/content/updateContentTitleAction.ts +151 -0
  374. package/create/space/content/uploadAndAddFileToSpaceAction.ts +98 -0
  375. package/create/space/contentKeyUtils.ts +117 -0
  376. package/create/space/deleteSpaceAction.ts +276 -0
  377. package/create/space/fetchSpaceAction.ts +70 -0
  378. package/create/space/fetchSpaceSidebarStateAction.ts +26 -0
  379. package/create/space/loadDefaultSpaceAction.ts +57 -0
  380. package/create/space/member/addMemberAction.ts +79 -0
  381. package/create/space/member/fetchUserSpaceMembershipsAction.ts +386 -0
  382. package/create/space/member/memberThunks.ts +47 -0
  383. package/create/space/member/removeMemberAction.ts +67 -0
  384. package/create/space/resolvePreferredSpaceId.ts +113 -0
  385. package/create/space/sidebarVisibleTypes.ts +260 -0
  386. package/create/space/space.locale.ts +1087 -0
  387. package/create/space/spaceAccess.ts +182 -0
  388. package/create/space/spaceCollapsedState.ts +54 -0
  389. package/create/space/spaceKeys.ts +65 -0
  390. package/create/space/spaceSlice.ts +328 -0
  391. package/create/space/spaceThunks.ts +410 -0
  392. package/create/space/types.ts +27 -0
  393. package/create/space/updateSpaceAction.ts +107 -0
  394. package/create/space/utils/permissions.ts +47 -0
  395. package/create/types.ts +21 -0
  396. package/database/actions/agentReadResolution.ts +33 -0
  397. package/database/actions/common.ts +243 -0
  398. package/database/actions/deleteFile.ts +40 -0
  399. package/database/actions/fileContent.ts +125 -0
  400. package/database/actions/patch.ts +155 -0
  401. package/database/actions/read.ts +358 -0
  402. package/database/actions/readAndWait.ts +260 -0
  403. package/database/actions/readRequestManager.ts +120 -0
  404. package/database/actions/readResolution.ts +125 -0
  405. package/database/actions/remove.ts +94 -0
  406. package/database/actions/replication.ts +477 -0
  407. package/database/actions/upload.ts +186 -0
  408. package/database/actions/upsert.ts +56 -0
  409. package/database/actions/write.ts +146 -0
  410. package/database/authority/ownerKey.ts +80 -0
  411. package/database/authority/recordAuthority.ts +67 -0
  412. package/database/authority/userAuthorityRegistry.ts +54 -0
  413. package/database/client/fetchUserData.ts +61 -0
  414. package/database/dbActionThunks.ts +1 -0
  415. package/database/dbSlice.ts +149 -0
  416. package/database/fileRing.ts +51 -0
  417. package/database/fileStorage.ts +232 -0
  418. package/database/fileUrl.ts +34 -0
  419. package/database/keys.ts +767 -0
  420. package/database/queryPrefixes.ts +14 -0
  421. package/database/requests.ts +443 -0
  422. package/database/runtimeServerContext.ts +54 -0
  423. package/database/tenantPlacement.ts +57 -0
  424. package/database/userPreferenceRegister.ts +131 -0
  425. package/database/utils/ulid.ts +1 -0
  426. package/dialogAttachmentCleanup.ts +151 -0
  427. package/dialogCommands.ts +163 -61
  428. package/dialogInternalCommandEntries.ts +1 -1
  429. package/docCreateCommands.ts +345 -0
  430. package/docInternalCommandEntries.ts +11 -0
  431. package/docPageHelpers.ts +80 -0
  432. package/docSkillHelpers.ts +67 -0
  433. package/docSpaceHelpers.ts +46 -0
  434. package/integrations/anthropic/anthropicModels.ts +47 -0
  435. package/integrations/deepseek/models.ts +37 -0
  436. package/integrations/google/models.ts +341 -0
  437. package/integrations/openai/chatCompletionStreamMode.ts +10 -0
  438. package/integrations/openai/filterAndCleanMessages.ts +284 -0
  439. package/integrations/openai/flexTier.ts +102 -0
  440. package/integrations/openai/generateOpenAIRequestBody.ts +271 -0
  441. package/integrations/openai/generateResponseRequestBody.ts +77 -0
  442. package/integrations/openai/models.ts +271 -0
  443. package/integrations/openai/providerBodyCompatibility.ts +23 -0
  444. package/integrations/openai/responsesHelpers.ts +297 -0
  445. package/integrations/x-reader/types.ts +109 -0
  446. package/integrations/xai/models.ts +13 -0
  447. package/integrations/xhs-reader/redaction.ts +68 -0
  448. package/integrations/xhs-reader/types.ts +277 -0
  449. package/integrations/xhs-reader/url.ts +80 -0
  450. package/internalCommandEntries.ts +4 -0
  451. package/machineCommands.ts +18 -34
  452. package/memoryCommands.ts +253 -0
  453. package/memoryInternalCommandEntries.ts +9 -0
  454. package/package.json +454 -9
  455. package/qoderUsageProbe.ts +252 -0
  456. package/render/contentIcon/types.ts +167 -0
  457. package/render/page/createPageAction.ts +183 -0
  458. package/render/page/docSlice.ts +495 -0
  459. package/render/page/types.ts +19 -0
  460. package/render/table/createTableAction.ts +274 -0
  461. package/render/table/deleteTableAction.ts +193 -0
  462. package/render/table/fetchAndCacheTableRows.ts +174 -0
  463. package/render/table/tableSlice.ts +1167 -0
  464. package/render/table/toolValueUtils.ts +363 -0
  465. package/render/table/types.ts +262 -0
  466. package/render/table/utils/tableSerialization.ts +50 -0
  467. package/scriptCommandEntries.ts +0 -3
  468. package/secretScan.ts +31 -0
  469. package/server/handlers/agentRun/types.ts +105 -0
  470. package/share/action.ts +225 -0
  471. package/share/helpers.ts +302 -0
  472. package/share/keys.ts +243 -0
  473. package/share/publicSharePolicy.ts +27 -0
  474. package/share/shareSlice.ts +53 -0
  475. package/share/types.ts +100 -0
  476. package/tableCommands.ts +248 -13
  477. package/workflowInternalCommandEntries.ts +2 -3
  478. package/ai/tools/agent/taskRunTool.ts +0 -112
  479. package/cli/client/taskRunPrompt.ts +0 -27
  480. package/cli/taskRunCommand.ts +0 -265
  481. package/client/taskRunPrompt.ts +0 -27
  482. package/taskRunCommand.ts +0 -265
package/secretScan.ts ADDED
@@ -0,0 +1,31 @@
1
+ export type SecretFinding = {
2
+ label: string;
3
+ line: number;
4
+ preview: string;
5
+ };
6
+
7
+ const SECRET_PATTERNS: Array<{ label: string; pattern: RegExp }> = [
8
+ { label: "password", pattern: /\bpassword\s*[:=]\s*["']?[^"',\s#]{8,}/i },
9
+ { label: "psk", pattern: /\bpsk\s*[:=]\s*["']?[^"',\s#]{8,}/i },
10
+ { label: "api key", pattern: /\b(api[_-]?key|apikey)\s*[:=]\s*["']?[^"',\s#]{12,}/i },
11
+ { label: "token", pattern: /\b(token|secret)\s*[:=]\s*["']?[^"',\s#]{12,}/i },
12
+ { label: "private key", pattern: /-----BEGIN [A-Z ]*PRIVATE KEY-----/ },
13
+ ];
14
+
15
+ export function findPotentialSecrets(text: string): SecretFinding[] {
16
+ return text
17
+ .split(/\r?\n/)
18
+ .flatMap((line, index) =>
19
+ SECRET_PATTERNS.filter(({ pattern }) => pattern.test(line)).map(({ label }) => ({
20
+ label,
21
+ line: index + 1,
22
+ preview: line.length > 120 ? `${line.slice(0, 117)}...` : line,
23
+ }))
24
+ );
25
+ }
26
+
27
+ export function formatSecretFindings(findings: SecretFinding[]) {
28
+ return findings
29
+ .map((finding) => ` line ${finding.line} (${finding.label}): ${finding.preview}`)
30
+ .join("\n");
31
+ }
@@ -0,0 +1,105 @@
1
+ // packages/server/handlers/agentRun/types.ts
2
+
3
+ import type {
4
+ DialogPolicyState,
5
+ } from "../../../ai/policy/types";
6
+ import type { ResolvedRuntimePolicy } from "../../../ai/policy/runtimePolicy";
7
+ import type { DialogRuntimeProfile } from "../../../app/types";
8
+ import type { DialogSubjectRef } from "../../../app/types";
9
+ import type {
10
+ AgentRuntimeChatMessage,
11
+ AgentRuntimeResult,
12
+ AgentRuntimeToolCall,
13
+ } from "../../../agent-runtime/types";
14
+ import type { AgentRuntimeOptions } from "../../../ai/agent/types";
15
+
16
+ export type ChatMessage = AgentRuntimeChatMessage;
17
+
18
+ export type AssistantToolCall = AgentRuntimeToolCall;
19
+
20
+ export type AgentRunUserInputReferencePart = {
21
+ type: string;
22
+ name?: string;
23
+ pageKey?: string;
24
+ dialogKey?: string;
25
+ };
26
+
27
+ export type AgentRunUserInputPart =
28
+ | { type: "text"; text: string }
29
+ | {
30
+ type: "image_url";
31
+ image_url: { url: string };
32
+ google_native?: {
33
+ inlineData?: {
34
+ mimeType: string;
35
+ data: string;
36
+ };
37
+ thoughtSignature?: string;
38
+ };
39
+ }
40
+ | AgentRunUserInputReferencePart;
41
+
42
+ export interface AgentRunRequest {
43
+ agentKey: string;
44
+ userInput: string | AgentRunUserInputPart[];
45
+ messages?: ChatMessage[]; // 历史对话,调用方自行管理(不持久化)
46
+ runtimeContext?: AgentRunRuntimeContext;
47
+ stream?: boolean;
48
+ timeoutMs?: number; // 可选:调用方为本次 agent run 传入的任务级超时预算
49
+ background?: boolean;
50
+ spaceId?: string;
51
+ category?: string;
52
+ inheritedFromDialogKey?: string;
53
+ parentDialogId?: string;
54
+ runtimeProfile?: DialogRuntimeProfile;
55
+ runtimeOptions?: AgentRuntimeOptions;
56
+ debugContextLayers?: boolean;
57
+ /** 传入已有 dialogId 时,新消息追加到该对话而不是新建 */
58
+ continueDialogId?: string;
59
+ /** UI 已自行管理消息持久化时,设为 false 避免 agent/run 额外创建运行对话 */
60
+ persistDialog?: boolean;
61
+ /** persistDialog=false 时用于工具上下文和计费归属的已有 UI dialogId */
62
+ clientDialogId?: string;
63
+ }
64
+
65
+ export interface AgentRunRuntimeContext {
66
+ surface?: "web" | "electron" | "electron-bun" | "cli" | "server-script" | "backend-script" | "react-native" | string;
67
+ host?: string;
68
+ runtime?: string;
69
+ entrypoint?: string;
70
+ capabilities?: string[];
71
+ subjectRefs?: DialogSubjectRef[];
72
+ }
73
+
74
+ export interface LoopResult extends Omit<AgentRuntimeResult, "policyState"> {
75
+ policyState?: DialogPolicyState;
76
+ artifacts?: unknown;
77
+ activeAgentKey?: string;
78
+ threadMetadata?: {
79
+ threadKind?: AgentRunRuntimeContext["threadKind"];
80
+ presentationIntent?: AgentRunRuntimeContext["presentationIntent"];
81
+ };
82
+ }
83
+
84
+ export interface ToolPolicyRuntimeState {
85
+ autoKnowledgeCaptureCountThisRun: number;
86
+ autoSpaceReadCountThisRun: number;
87
+ }
88
+
89
+ export interface ToolExecutionContext {
90
+ policy?: ResolvedRuntimePolicy;
91
+ runtimeState?: ToolPolicyRuntimeState;
92
+ runtimeToolSurface?: {
93
+ finalToolNames?: unknown;
94
+ explicitToolNames?: unknown;
95
+ injectedToolNames?: unknown;
96
+ auditReason?: unknown;
97
+ } | null;
98
+ runtimeContext?: AgentRunRuntimeContext | null;
99
+ userId?: string | null;
100
+ agentKey?: string | null;
101
+ dialogId?: string | null;
102
+ currentSpaceId?: string | null;
103
+ userInput?: string | null;
104
+ imageUrls?: string[];
105
+ }
@@ -0,0 +1,225 @@
1
+ import type { AppThunkApi } from "../app/store";
2
+ import { selectCurrentUser, selectUserId } from "../auth/authSlice";
3
+ import {
4
+ selectCurrentServer,
5
+ selectRemoteServers,
6
+ } from "../app/settings/settingSlice";
7
+ import { normalizeTimeFields } from "../database/actions/common";
8
+ import { createUserKey } from "../database/keys";
9
+ import { noloDeleteRequest, noloWriteRequest } from "../database/requests";
10
+
11
+ import type { SharedObject, ShareType } from "./types";
12
+ import { shareKey } from "./keys";
13
+ import {
14
+ toNonEmptyString,
15
+ sanitizeShareData,
16
+ extractCoverImage,
17
+ extractAgentInfo,
18
+ resolveShareAuthorIdentity,
19
+ } from "./helpers";
20
+
21
+ const generateToken = (): string => {
22
+ const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
23
+ const charsLen = chars.length; // 36
24
+ const maxValid = 252; // 252 = 36 * 7, largest multiple of 36 ≤ 255
25
+ let token = "";
26
+ while (token.length < 10) {
27
+ const bytes = new Uint8Array(16);
28
+ crypto.getRandomValues(bytes);
29
+ for (let i = 0; i < bytes.length && token.length < 10; i++) {
30
+ if (bytes[i] < maxValid) {
31
+ token += chars.charAt(bytes[i] % charsLen);
32
+ }
33
+ }
34
+ }
35
+ return token;
36
+ };
37
+
38
+ export interface ShareActionConfig {
39
+ type: ShareType;
40
+ data: Record<string, unknown>;
41
+ title: string;
42
+ description?: string;
43
+ visibility?: "private" | "community";
44
+ }
45
+
46
+ const assertDialogShareMessagesPresent = (
47
+ type: ShareType,
48
+ data: Record<string, unknown>
49
+ ) => {
50
+ if (type !== "dialog") return;
51
+ const messages = Array.isArray(data.messages)
52
+ ? data.messages
53
+ : Array.isArray(data.history)
54
+ ? data.history
55
+ : [];
56
+ if (messages.length > 0) return;
57
+ throw new Error("Cannot share dialog without persisted messages.");
58
+ };
59
+
60
+ const resolveTableSharePayload = (
61
+ type: ShareType,
62
+ data: Record<string, unknown>,
63
+ userId: string,
64
+ originServer: string
65
+ ): Record<string, unknown> => {
66
+ if (type !== "table") return sanitizeShareData(data);
67
+
68
+ const tableDbKey =
69
+ typeof data.dbKey === "string" && data.dbKey.trim().length > 0
70
+ ? data.dbKey
71
+ : undefined;
72
+ const tableOwnerId =
73
+ typeof data.tenantId === "string" && data.tenantId.trim().length > 0
74
+ ? data.tenantId
75
+ : userId;
76
+
77
+ if (!tableDbKey) {
78
+ throw new Error("Table share requires a dbKey.");
79
+ }
80
+
81
+ return {
82
+ mode: "live",
83
+ tableDbKey,
84
+ tableOwnerId,
85
+ originServer,
86
+ };
87
+ };
88
+
89
+ export const shareResourceAction = async (
90
+ config: ShareActionConfig,
91
+ thunkApi: AppThunkApi
92
+ ): Promise<{ token: string; key: string }> => {
93
+ const state = thunkApi.getState();
94
+ const userId = selectUserId(state);
95
+ const currentUser = selectCurrentUser(state);
96
+
97
+ if (!userId) {
98
+ throw new Error("User must be logged in to share resources.");
99
+ }
100
+
101
+ const token = generateToken();
102
+ const key = shareKey.create(token);
103
+
104
+ const currentServer = selectCurrentServer(state);
105
+ assertDialogShareMessagesPresent(config.type, config.data);
106
+ const snapshotData = resolveTableSharePayload(
107
+ config.type,
108
+ config.data,
109
+ userId,
110
+ currentServer
111
+ );
112
+ const coverImage = extractCoverImage(config.type, snapshotData);
113
+ const agentInfo = extractAgentInfo(config.type, snapshotData);
114
+ const createdAt = Date.now();
115
+ const { db: clientDb } = thunkApi.extra;
116
+ let authorProfile: Record<string, unknown> | null = null;
117
+
118
+ if (clientDb) {
119
+ try {
120
+ authorProfile = await clientDb.get(createUserKey.profile(userId));
121
+ } catch {
122
+ authorProfile = null;
123
+ }
124
+ }
125
+
126
+ const { authorName, authorAvatar } = resolveShareAuthorIdentity({
127
+ user: currentUser as Record<string, unknown> | null,
128
+ profile: authorProfile,
129
+ });
130
+
131
+ // Resolve agent name from local DB if we have a key but no name
132
+ if (agentInfo.sourceAgentKey && !agentInfo.sourceAgentName) {
133
+ if (clientDb) {
134
+ try {
135
+ const agentData = await clientDb.get(agentInfo.sourceAgentKey);
136
+ const name = toNonEmptyString(agentData?.name);
137
+ if (name) agentInfo.sourceAgentName = name;
138
+ } catch { /* agent lookup is best-effort */ }
139
+ }
140
+ }
141
+
142
+ const sharedObject: SharedObject = {
143
+ type: config.type,
144
+ version: 1,
145
+ data: snapshotData,
146
+ meta: {
147
+ authorId: userId,
148
+ ...(authorName ? { authorName } : {}),
149
+ ...(authorAvatar ? { authorAvatar } : {}),
150
+ createdAt,
151
+ visibility: config.visibility ?? "private",
152
+ title: config.title,
153
+ description: config.description,
154
+ originalId: (config.data.dbKey ?? config.data.id) as string | undefined,
155
+ coverImage,
156
+ ...agentInfo,
157
+ },
158
+ };
159
+
160
+ const servers = [
161
+ currentServer,
162
+ ...selectRemoteServers(state).filter((server) => server !== currentServer),
163
+ ].filter(Boolean);
164
+ const replicaServers = servers.filter((server) => server !== currentServer);
165
+
166
+ if (servers.length === 0) {
167
+ throw new Error("No available server to publish share.");
168
+ }
169
+
170
+ if (config.type === "table" && sharedObject.data.mode === "live") {
171
+ sharedObject.data = {
172
+ ...sharedObject.data,
173
+ originServer: currentServer,
174
+ };
175
+ sharedObject.meta = {
176
+ ...sharedObject.meta,
177
+ mode: "live",
178
+ tableDbKey:
179
+ typeof sharedObject.data.tableDbKey === "string"
180
+ ? sharedObject.data.tableDbKey
181
+ : undefined,
182
+ tableOwnerId:
183
+ typeof sharedObject.data.tableOwnerId === "string"
184
+ ? sharedObject.data.tableOwnerId
185
+ : undefined,
186
+ originServer: currentServer,
187
+ replicaServers,
188
+ };
189
+ }
190
+
191
+ const persistedSharedObject = normalizeTimeFields({
192
+ ...sharedObject,
193
+ dbKey: key,
194
+ userId,
195
+ });
196
+
197
+ // Compute index keys on the frontend — server just stores them
198
+ const indexKeys = shareKey.allIndexKeysFromShare(key, persistedSharedObject);
199
+
200
+ const results = await Promise.all(
201
+ servers.map((server) =>
202
+ noloWriteRequest(server, { data: persistedSharedObject, customKey: key, userId, indexKeys }, state)
203
+ )
204
+ );
205
+ const [originPublished, ...replicaPublishResults] = results;
206
+
207
+ if (!originPublished) {
208
+ const successfulReplicaServers = replicaServers.filter(
209
+ (_, index) => replicaPublishResults[index]
210
+ );
211
+ await Promise.all(
212
+ successfulReplicaServers.map((server) =>
213
+ noloDeleteRequest(server, key, { type: "single" }, state)
214
+ )
215
+ );
216
+ throw new Error("Failed to publish share to origin server.");
217
+ }
218
+
219
+ if (!clientDb) {
220
+ throw new Error("Client database instance is required in shareResourceAction");
221
+ }
222
+ await clientDb.put(key, persistedSharedObject);
223
+
224
+ return { token, key };
225
+ };
@@ -0,0 +1,302 @@
1
+ import {
2
+ createAgentKey,
3
+ createCybotKey,
4
+ isAgentKey,
5
+ splitKey,
6
+ } from "../database/keys";
7
+ import { DataType } from "../create/types";
8
+ import type { ShareType } from "./types";
9
+
10
+ // ── String normalization ────────────────────────────────────────────
11
+
12
+ export const toSafeString = (value: unknown): string =>
13
+ typeof value === "string" ? value.trim() : "";
14
+
15
+ export const toNonEmptyString = (value: unknown): string | undefined => {
16
+ const text = toSafeString(value);
17
+ return text || undefined;
18
+ };
19
+
20
+ export const normalizeUserId = (value: unknown): string => {
21
+ const text = toSafeString(value);
22
+ return text.startsWith("user:") ? text.slice(5) : text;
23
+ };
24
+
25
+ export const normalizeAuthorName = (value: unknown): string => {
26
+ const text = toSafeString(value);
27
+ if (!text) return "";
28
+ const lower = text.toLowerCase();
29
+ if (lower === "unknown" || lower === "unknown user") return "";
30
+ return text;
31
+ };
32
+
33
+ export const toSafeAgentKey = (value: unknown): string => {
34
+ const text = toSafeString(value);
35
+ return text && isAgentKey(text) ? text : "";
36
+ };
37
+
38
+ // ── Time helpers ────────────────────────────────────────────────────
39
+
40
+ export const toSafeTimestamp = (value: unknown): number => {
41
+ const num = Number(value);
42
+ if (Number.isFinite(num) && num > 0) return num;
43
+ if (typeof value !== "string") return 0;
44
+ const parsed = Date.parse(value);
45
+ return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
46
+ };
47
+
48
+ const SHARE_TIME_FORMATTER = new Intl.DateTimeFormat("zh-CN", {
49
+ timeZone: "Asia/Shanghai",
50
+ year: "numeric",
51
+ month: "2-digit",
52
+ day: "2-digit",
53
+ hour: "2-digit",
54
+ minute: "2-digit",
55
+ second: "2-digit",
56
+ hour12: false,
57
+ });
58
+
59
+ export const formatShareTime = (timestamp: number): string => {
60
+ if (!timestamp) return "时间未知";
61
+ const date = new Date(timestamp);
62
+ return Number.isFinite(date.getTime()) ? SHARE_TIME_FORMATTER.format(date) : "时间未知";
63
+ };
64
+
65
+ // ── Agent extraction ────────────────────────────────────────────────
66
+
67
+ const findAgentKeyInMessages = (messages: unknown[]): string => {
68
+ for (const raw of messages) {
69
+ if (!raw || typeof raw !== "object") continue;
70
+ const key = toSafeAgentKey((raw as Record<string, unknown>).cybotKey);
71
+ if (key) return key;
72
+ }
73
+ return "";
74
+ };
75
+
76
+ const findAgentKeyInArray = (items: unknown[]): string => {
77
+ for (const raw of items) {
78
+ const direct = toSafeAgentKey(raw);
79
+ if (direct) return direct;
80
+ if (!raw || typeof raw !== "object") continue;
81
+ const item = raw as Record<string, unknown>;
82
+ const key = toSafeAgentKey(item.dbKey) || toSafeAgentKey(item.id);
83
+ if (key) return key;
84
+ }
85
+ return "";
86
+ };
87
+
88
+ const findAgentNameInMessages = (messages: unknown[]): string => {
89
+ for (const raw of messages) {
90
+ if (!raw || typeof raw !== "object") continue;
91
+ const msg = raw as Record<string, unknown>;
92
+ const name =
93
+ toSafeString(msg.agentName) ||
94
+ toSafeString(msg.cybotName) ||
95
+ toSafeString(msg.sourceAgentName);
96
+ if (name) return name;
97
+ }
98
+ return "";
99
+ };
100
+
101
+ const findAgentNameInArray = (items: unknown[]): string => {
102
+ for (const raw of items) {
103
+ if (!raw || typeof raw !== "object") continue;
104
+ const item = raw as Record<string, unknown>;
105
+ const name =
106
+ toSafeString(item.name) ||
107
+ toSafeString(item.agentName) ||
108
+ toSafeString(item.cybotName) ||
109
+ toSafeString(item.sourceAgentName);
110
+ if (name) return name;
111
+ }
112
+ return "";
113
+ };
114
+
115
+ export const extractAgentInfo = (
116
+ type: ShareType,
117
+ data: Record<string, unknown>
118
+ ): { sourceAgentKey?: string; sourceAgentName?: string } => {
119
+ const meta = data.meta as Record<string, unknown> | undefined;
120
+
121
+ // Candidate keys in priority order
122
+ const keyCandidates: unknown[] = [
123
+ meta?.sourceAgentKey,
124
+ meta?.agentKey,
125
+ data.sourceAgentKey,
126
+ data.agentKey,
127
+ data.cybotKey,
128
+ type === DataType.CYBOT ? (data.dbKey ?? data.id) : undefined,
129
+ ];
130
+
131
+ let agentKey = "";
132
+ for (const candidate of keyCandidates) {
133
+ agentKey = toSafeAgentKey(candidate);
134
+ if (agentKey) break;
135
+ }
136
+
137
+ // Fallback: search in arrays
138
+ if (!agentKey && Array.isArray(data.cybots)) {
139
+ agentKey = findAgentKeyInArray(data.cybots);
140
+ }
141
+ if (!agentKey && Array.isArray(data.messages)) {
142
+ agentKey = findAgentKeyInMessages(data.messages as unknown[]);
143
+ }
144
+ if (!agentKey && Array.isArray(data.history)) {
145
+ agentKey = findAgentKeyInMessages(data.history as unknown[]);
146
+ }
147
+
148
+ // Agent name
149
+ const nameCandidates: unknown[] = [
150
+ meta?.sourceAgentName,
151
+ meta?.agentName,
152
+ meta?.cybotName,
153
+ data.sourceAgentName,
154
+ data.agentName,
155
+ data.cybotName,
156
+ type === DataType.CYBOT ? data.name : undefined,
157
+ ];
158
+
159
+ let agentName = "";
160
+ for (const candidate of nameCandidates) {
161
+ agentName = toSafeString(candidate);
162
+ if (agentName) break;
163
+ }
164
+ if (!agentName && Array.isArray(data.cybots)) {
165
+ agentName = findAgentNameInArray(data.cybots);
166
+ }
167
+ if (!agentName && Array.isArray(data.messages)) {
168
+ agentName = findAgentNameInMessages(data.messages as unknown[]);
169
+ }
170
+ if (!agentName && Array.isArray(data.history)) {
171
+ agentName = findAgentNameInMessages(data.history as unknown[]);
172
+ }
173
+
174
+ return {
175
+ ...(agentKey ? { sourceAgentKey: agentKey } : {}),
176
+ ...(agentName ? { sourceAgentName: agentName } : {}),
177
+ };
178
+ };
179
+
180
+ // ── Cover image extraction ──────────────────────────────────────────
181
+
182
+ const extractImageFromContent = (content: unknown): string | undefined => {
183
+ if (Array.isArray(content)) {
184
+ const part = content.find(
185
+ (p: any) => p?.type === "image_url" && typeof p?.image_url?.url === "string"
186
+ );
187
+ if (part?.image_url?.url) return part.image_url.url;
188
+ }
189
+ if (typeof content === "string") {
190
+ const match = content.match(/!\[.*?\]\((.*?)\)/);
191
+ if (match?.[1]) return match[1];
192
+ }
193
+ return undefined;
194
+ };
195
+
196
+ export const extractCoverImage = (
197
+ type: ShareType,
198
+ data: Record<string, unknown>
199
+ ): string | undefined => {
200
+ if (type === DataType.IMAGE) {
201
+ return toNonEmptyString(data.url);
202
+ }
203
+ if (type === DataType.APP) {
204
+ return toNonEmptyString(data.coverImage);
205
+ }
206
+ if (type !== DataType.DIALOG) return undefined;
207
+
208
+ const messages = (Array.isArray(data.messages)
209
+ ? data.messages
210
+ : Array.isArray(data.history)
211
+ ? data.history
212
+ : []) as Record<string, unknown>[];
213
+
214
+ for (const msg of messages) {
215
+ const fromContent = extractImageFromContent(msg.content);
216
+ if (fromContent) return fromContent;
217
+
218
+ const image = toNonEmptyString(msg.image);
219
+ if (image) return image;
220
+
221
+ if (Array.isArray(msg.images)) {
222
+ const first = (msg.images as unknown[]).find(
223
+ (u) => typeof u === "string" && u.trim().length > 0
224
+ );
225
+ if (first) return first as string;
226
+ }
227
+ }
228
+ return undefined;
229
+ };
230
+
231
+ // ── Author extraction ────────────────────────────────────────────────
232
+
233
+ export const toPublicAgentKey = (value: unknown): string => {
234
+ const key = toSafeAgentKey(value);
235
+ if (!key) return "";
236
+
237
+ const parts = splitKey(key);
238
+ if (parts.length < 3) return "";
239
+
240
+ const [type, owner] = parts;
241
+ const agentId = parts[parts.length - 1];
242
+ if (!agentId) return "";
243
+ if (owner === "pub") return key;
244
+
245
+ if (type === DataType.AGENT) {
246
+ return createAgentKey.public(agentId);
247
+ }
248
+ if (type === DataType.CYBOT) {
249
+ return createCybotKey.public(agentId);
250
+ }
251
+ return "";
252
+ };
253
+
254
+ export const resolveShareAuthorIdentity = (args: {
255
+ user?: Record<string, unknown> | null;
256
+ profile?: Record<string, unknown> | null;
257
+ fallbackName?: unknown;
258
+ fallbackAvatar?: unknown;
259
+ }): { authorName?: string; authorAvatar?: string } => {
260
+ const authorName =
261
+ toNonEmptyString(args.profile?.nickname) ??
262
+ toNonEmptyString(args.user?.name) ??
263
+ toNonEmptyString(args.user?.nickname) ??
264
+ toNonEmptyString(args.user?.username) ??
265
+ toNonEmptyString(args.fallbackName);
266
+ const authorAvatar =
267
+ toNonEmptyString(args.profile?.avatar) ??
268
+ toNonEmptyString(args.user?.avatar) ??
269
+ toNonEmptyString(args.fallbackAvatar);
270
+
271
+ return {
272
+ ...(authorName ? { authorName } : {}),
273
+ ...(authorAvatar ? { authorAvatar } : {}),
274
+ };
275
+ };
276
+
277
+ // ── Error helpers ───────────────────────────────────────────────────
278
+
279
+ export const isLevelNotFoundError = (error: unknown): boolean => {
280
+ if (!error || typeof error !== "object") return false;
281
+ const e = error as Record<string, unknown>;
282
+ return (
283
+ e.notFound === true ||
284
+ e.name === "NotFoundError" ||
285
+ e.code === "LEVEL_NOT_FOUND" ||
286
+ e.code === "LEVEL_NOT_FOUND_ERROR"
287
+ );
288
+ };
289
+
290
+ // ── Sanitization ────────────────────────────────────────────────────
291
+
292
+ const SENSITIVE_FIELDS = ["apiKey", "secret", "password"] as const;
293
+
294
+ export const sanitizeShareData = (
295
+ data: Record<string, unknown>
296
+ ): Record<string, unknown> => {
297
+ const snapshot = { ...data };
298
+ for (const field of SENSITIVE_FIELDS) {
299
+ delete snapshot[field];
300
+ }
301
+ return snapshot;
302
+ };