collavre 0.24.0 → 0.25.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 (440) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +0 -1
  3. data/app/assets/stylesheets/collavre/comments_popup.css +165 -99
  4. data/app/assets/stylesheets/collavre/creatives.css +346 -37
  5. data/app/assets/stylesheets/collavre/desktop_setup.css +246 -0
  6. data/app/assets/stylesheets/collavre/gnb.css +64 -3
  7. data/app/assets/stylesheets/collavre/landing.css +108 -3
  8. data/app/assets/stylesheets/collavre/mention_menu.css +32 -0
  9. data/app/assets/stylesheets/collavre/popup.css +14 -0
  10. data/app/assets/stylesheets/collavre/print.css +0 -1
  11. data/app/assets/stylesheets/collavre/search_popup.css +1 -1
  12. data/app/assets/stylesheets/collavre/secret_fields.css +3 -0
  13. data/app/assets/stylesheets/collavre/workspace.css +307 -0
  14. data/app/channels/collavre/agent_channel.rb +14 -21
  15. data/app/channels/collavre/comments_presence_channel.rb +181 -21
  16. data/app/channels/collavre/inbox_badge_channel.rb +7 -1
  17. data/app/components/collavre/inbox/badge_component.rb +6 -13
  18. data/app/components/collavre/progress_filter_component.html.erb +2 -2
  19. data/app/components/collavre/progress_filter_component.rb +20 -0
  20. data/app/controllers/collavre/admin/settings_controller.rb +4 -1
  21. data/app/controllers/collavre/agent_connections_controller.rb +165 -0
  22. data/app/controllers/collavre/agent_gateways_controller.rb +132 -0
  23. data/app/controllers/collavre/agent_provisioning_controller.rb +79 -0
  24. data/app/controllers/collavre/api/v1/agents_controller.rb +45 -97
  25. data/app/controllers/collavre/application_controller.rb +13 -2
  26. data/app/controllers/collavre/comment_read_pointers_controller.rb +69 -40
  27. data/app/controllers/collavre/comments_controller.rb +45 -131
  28. data/app/controllers/collavre/concerns/shareable.rb +9 -3
  29. data/app/controllers/collavre/creatives_controller.rb +144 -11
  30. data/app/controllers/collavre/desktop_gateway_registrations_controller.rb +173 -0
  31. data/app/controllers/collavre/desktop_setup_controller.rb +119 -0
  32. data/app/controllers/collavre/desktop_sidecar_health_controller.rb +35 -0
  33. data/app/controllers/collavre/features_controller.rb +57 -0
  34. data/app/controllers/collavre/invites_controller.rb +12 -1
  35. data/app/controllers/collavre/llm_models_controller.rb +8 -0
  36. data/app/controllers/collavre/notices_controller.rb +20 -0
  37. data/app/controllers/collavre/tasks_controller.rb +40 -6
  38. data/app/controllers/collavre/topics_controller.rb +130 -53
  39. data/app/controllers/collavre/user_creative_preferences_controller.rb +214 -30
  40. data/app/controllers/concerns/collavre/comments/batch_operations.rb +15 -3
  41. data/app/controllers/concerns/collavre/comments/conversion.rb +1 -1
  42. data/app/controllers/concerns/collavre/users_controller/ai_user_management.rb +118 -8
  43. data/app/controllers/concerns/collavre/users_controller/profile_and_settings.rb +1 -15
  44. data/app/controllers/concerns/collavre/users_controller/registration.rb +2 -2
  45. data/app/errors/collavre/turn_deadline_error.rb +20 -0
  46. data/app/helpers/collavre/application_helper.rb +38 -0
  47. data/app/helpers/collavre/creatives_helper.rb +56 -22
  48. data/app/helpers/collavre/navigation_helper.rb +12 -0
  49. data/app/javascript/collavre.js +1 -2
  50. data/app/javascript/components/InlineLexicalEditor.jsx +30 -21
  51. data/app/javascript/components/__tests__/creative_tree_row_parent_id.test.js +32 -2
  52. data/app/javascript/components/__tests__/creative_tree_row_progress_toggle.test.js +185 -0
  53. data/app/javascript/components/creative_tree_row.js +62 -22
  54. data/app/javascript/controllers/__tests__/agent_connection_controller.test.js +195 -0
  55. data/app/javascript/controllers/__tests__/desktop_proxy_setup_controller.test.js +96 -0
  56. data/app/javascript/controllers/__tests__/index.test.js +42 -0
  57. data/app/javascript/controllers/__tests__/last_visited_creative_controller.test.js +103 -0
  58. data/app/javascript/controllers/__tests__/link_creative_controller.test.js +253 -2
  59. data/app/javascript/controllers/__tests__/progress_filter_controller.test.js +134 -0
  60. data/app/javascript/controllers/__tests__/search_popup_controller.test.js +310 -0
  61. data/app/javascript/controllers/__tests__/topic_list_controller.test.js +111 -0
  62. data/app/javascript/controllers/__tests__/workspace_tree_controller.test.js +1011 -0
  63. data/app/javascript/controllers/agent_connection_controller.js +357 -0
  64. data/app/javascript/controllers/agent_vendor_controller.js +23 -0
  65. data/app/javascript/controllers/comment_controller.js +3 -1
  66. data/app/javascript/controllers/comments/__tests__/feature_cards_controller.test.js +223 -0
  67. data/app/javascript/controllers/comments/__tests__/form_controller_default_placeholder.test.js +83 -0
  68. data/app/javascript/controllers/comments/__tests__/form_controller_draft.test.js +2069 -0
  69. data/app/javascript/controllers/comments/__tests__/form_controller_ime_send.test.js +324 -0
  70. data/app/javascript/controllers/comments/__tests__/form_controller_review.test.js +28 -2
  71. data/app/javascript/controllers/comments/__tests__/form_controller_search_submit.test.js +106 -0
  72. data/app/javascript/controllers/comments/__tests__/form_controller_stashed_draft.test.js +134 -0
  73. data/app/javascript/controllers/comments/__tests__/form_controller_stashed_draft_creative_switch.test.js +166 -0
  74. data/app/javascript/controllers/comments/__tests__/form_controller_stashed_draft_failure.test.js +183 -0
  75. data/app/javascript/controllers/comments/__tests__/list_controller_deep_link_topic.test.js +467 -0
  76. data/app/javascript/controllers/comments/__tests__/list_controller_docked.test.js +115 -0
  77. data/app/javascript/controllers/comments/__tests__/list_controller_prev_message.test.js +245 -0
  78. data/app/javascript/controllers/comments/__tests__/list_controller_read_pointer.test.js +276 -0
  79. data/app/javascript/controllers/comments/__tests__/list_controller_stream_archived.test.js +221 -0
  80. data/app/javascript/controllers/comments/__tests__/list_controller_stream_search.test.js +104 -0
  81. data/app/javascript/controllers/comments/__tests__/placeholder_controller.test.js +79 -0
  82. data/app/javascript/controllers/comments/__tests__/popup_controller.test.js +754 -1
  83. data/app/javascript/controllers/comments/__tests__/presence_controller.test.js +717 -15
  84. data/app/javascript/controllers/comments/__tests__/prev_message_navigator.test.js +129 -0
  85. data/app/javascript/controllers/comments/__tests__/topics_controller_action_errors.test.js +184 -0
  86. data/app/javascript/controllers/comments/__tests__/topics_controller_archived.test.js +879 -0
  87. data/app/javascript/controllers/comments/__tests__/topics_controller_creation_container.test.js +154 -0
  88. data/app/javascript/controllers/comments/__tests__/topics_controller_creation_scroll.test.js +92 -0
  89. data/app/javascript/controllers/comments/__tests__/topics_controller_delete.test.js +130 -0
  90. data/app/javascript/controllers/comments/__tests__/topics_controller_docked.test.js +32 -0
  91. data/app/javascript/controllers/comments/__tests__/topics_controller_last_topic_echo.test.js +1938 -0
  92. data/app/javascript/controllers/comments/__tests__/topics_controller_primary_agent.test.js +256 -0
  93. data/app/javascript/controllers/comments/__tests__/topics_controller_scroll.test.js +182 -0
  94. data/app/javascript/controllers/comments/__tests__/topics_controller_selection_race.test.js +981 -0
  95. data/app/javascript/controllers/comments/__tests__/topics_controller_topic_list.test.js +313 -0
  96. data/app/javascript/controllers/comments/feature_cards_controller.js +83 -0
  97. data/app/javascript/controllers/comments/form_controller.js +795 -14
  98. data/app/javascript/controllers/comments/list_controller.js +338 -52
  99. data/app/javascript/controllers/comments/placeholder_controller.js +30 -0
  100. data/app/javascript/controllers/comments/popup_controller.js +425 -83
  101. data/app/javascript/controllers/comments/presence_controller.js +317 -55
  102. data/app/javascript/controllers/comments/prev_message_navigator.js +94 -0
  103. data/app/javascript/controllers/comments/topics_controller.js +1772 -100
  104. data/app/javascript/controllers/common_popup_controller.js +2 -2
  105. data/app/javascript/controllers/creatives/__tests__/select_mode_controller.test.js +139 -0
  106. data/app/javascript/controllers/creatives/__tests__/tree_controller.test.js +605 -0
  107. data/app/javascript/controllers/creatives/__tests__/write_access_request_controller.test.js +125 -0
  108. data/app/javascript/controllers/creatives/select_mode_controller.js +7 -2
  109. data/app/javascript/controllers/creatives/tree_controller.js +140 -31
  110. data/app/javascript/controllers/creatives/write_access_request_controller.js +58 -0
  111. data/app/javascript/controllers/desktop_proxy_setup_controller.js +51 -0
  112. data/app/javascript/controllers/gateway_check_controller.js +36 -0
  113. data/app/javascript/controllers/index.js +25 -1
  114. data/app/javascript/controllers/last_visited_creative_controller.js +58 -0
  115. data/app/javascript/controllers/link_creative_controller.js +89 -18
  116. data/app/javascript/controllers/progress_filter_controller.js +12 -22
  117. data/app/javascript/controllers/search_popup_controller.js +64 -46
  118. data/app/javascript/controllers/share_user_search_controller.js +2 -2
  119. data/app/javascript/controllers/topic_list_controller.js +44 -7
  120. data/app/javascript/controllers/workspace_tree_controller.js +662 -0
  121. data/app/javascript/creatives/__tests__/tree_renderer.test.js +80 -0
  122. data/app/javascript/creatives/drag_drop/__tests__/drop_completion_empty_state.test.js +98 -0
  123. data/app/javascript/creatives/drag_drop/__tests__/topic_move_released_agent.test.js +125 -0
  124. data/app/javascript/creatives/drag_drop/event_handlers.js +12 -0
  125. data/app/javascript/creatives/tree_renderer.js +65 -22
  126. data/app/javascript/lib/__tests__/chat_drafts.test.js +1458 -0
  127. data/app/javascript/lib/__tests__/common_popup_bounds.test.js +8 -3
  128. data/app/javascript/lib/__tests__/common_popup_placement.test.js +374 -0
  129. data/app/javascript/lib/__tests__/common_popup_reshow.test.js +131 -0
  130. data/app/javascript/lib/__tests__/creative_link_prefetch.test.js +46 -0
  131. data/app/javascript/lib/__tests__/last_visited_creative.test.js +87 -0
  132. data/app/javascript/lib/__tests__/skill_html_entities.test.js +23 -0
  133. data/app/javascript/lib/__tests__/turbo_stream_actions.test.js +190 -0
  134. data/app/javascript/lib/api/__tests__/creatives.test.js +68 -0
  135. data/app/javascript/lib/api/__tests__/csrf_fetch.test.js +27 -0
  136. data/app/javascript/lib/api/__tests__/topics_save_last_topic.test.js +112 -0
  137. data/app/javascript/lib/api/creatives.js +32 -13
  138. data/app/javascript/lib/api/csrf_fetch.js +6 -4
  139. data/app/javascript/lib/api/topics.js +63 -5
  140. data/app/javascript/lib/chat_drafts.js +786 -0
  141. data/app/javascript/lib/common_popup.js +164 -25
  142. data/app/javascript/lib/creative_link_prefetch.js +27 -0
  143. data/app/javascript/lib/last_visited_creative.js +97 -0
  144. data/app/javascript/lib/lexical/__tests__/creative_link_node.test.js +162 -0
  145. data/app/javascript/lib/lexical/__tests__/creative_link_trigger.test.js +133 -0
  146. data/app/javascript/lib/lexical/__tests__/link_toolbar.test.js +62 -0
  147. data/app/javascript/lib/lexical/creative_link_node.js +101 -0
  148. data/app/javascript/lib/lexical/creative_link_trigger.js +98 -0
  149. data/app/javascript/lib/lexical/link_toolbar.js +23 -0
  150. data/app/javascript/lib/turbo_stream_actions.js +23 -16
  151. data/app/javascript/lib/utils/__tests__/filter_navigation.test.js +210 -0
  152. data/app/javascript/lib/utils/__tests__/markdown.test.js +44 -0
  153. data/app/javascript/lib/utils/filter_navigation.js +100 -0
  154. data/app/javascript/modules/__tests__/command_menu_creative_picker.test.js +62 -0
  155. data/app/javascript/modules/__tests__/command_menu_typeahead.test.js +267 -0
  156. data/app/javascript/modules/__tests__/creative_link_picker.test.js +85 -0
  157. data/app/javascript/modules/__tests__/creative_row_editor_archive.test.js +391 -0
  158. data/app/javascript/modules/__tests__/creative_row_editor_delegated_clicks.test.js +158 -0
  159. data/app/javascript/modules/__tests__/creative_row_editor_empty_state_recovery.test.js +519 -0
  160. data/app/javascript/modules/__tests__/creative_row_editor_empty_state_removal.test.js +346 -0
  161. data/app/javascript/modules/__tests__/creative_row_editor_session.test.js +144 -0
  162. data/app/javascript/modules/__tests__/creative_tree_dom.test.js +30 -0
  163. data/app/javascript/modules/__tests__/creative_tree_empty_state.test.js +186 -0
  164. data/app/javascript/modules/__tests__/dom_listener_registry.test.js +67 -0
  165. data/app/javascript/modules/__tests__/support/inline_editor_dom.js +159 -0
  166. data/app/javascript/modules/command_args_form.js +0 -12
  167. data/app/javascript/modules/command_menu.js +80 -38
  168. data/app/javascript/modules/creative_link_picker.js +56 -0
  169. data/app/javascript/modules/creative_row_editor.js +446 -243
  170. data/app/javascript/modules/creative_row_editor_delegated_clicks.js +87 -0
  171. data/app/javascript/modules/creative_tree_dom.js +4 -0
  172. data/app/javascript/modules/creative_tree_empty_state.js +80 -0
  173. data/app/javascript/modules/dom_listener_registry.js +23 -0
  174. data/app/javascript/modules/mention_menu.js +2 -3
  175. data/app/javascript/utils/__tests__/caret_anchor.test.js +75 -0
  176. data/app/javascript/utils/__tests__/chevron_icons.test.js +15 -0
  177. data/app/javascript/utils/caret_position.js +10 -0
  178. data/app/javascript/utils/chevron_icons.js +7 -0
  179. data/app/jobs/collavre/ai_agent_job.rb +262 -72
  180. data/app/jobs/collavre/cancel_offline_delegated_tasks_job.rb +11 -36
  181. data/app/jobs/collavre/comment_badges_broadcast_job.rb +28 -0
  182. data/app/jobs/collavre/comment_link_preview_job.rb +33 -0
  183. data/app/jobs/collavre/comment_notification_job.rb +14 -0
  184. data/app/jobs/collavre/comment_push_delivery_sweep_job.rb +17 -0
  185. data/app/jobs/collavre/compress_job.rb +33 -22
  186. data/app/jobs/collavre/creative_broadcast_job.rb +161 -48
  187. data/app/jobs/collavre/cron_action_job.rb +36 -18
  188. data/app/jobs/collavre/drop_trigger_job.rb +23 -9
  189. data/app/jobs/collavre/merge_comments_job.rb +33 -16
  190. data/app/jobs/collavre/push_notification_job.rb +62 -18
  191. data/app/jobs/collavre/restore_dropped_dispatches_job.rb +17 -0
  192. data/app/jobs/collavre/stuck_detector_job.rb +1 -1
  193. data/app/jobs/collavre/touch_creative_subtree_job.rb +14 -0
  194. data/app/models/collavre/agent_gateway.rb +200 -0
  195. data/app/models/collavre/agent_subscription.rb +4 -4
  196. data/app/models/collavre/agent_workspace.rb +210 -0
  197. data/app/models/collavre/comment/broadcastable.rb +22 -52
  198. data/app/models/collavre/comment/notifiable.rb +154 -77
  199. data/app/models/collavre/comment/topic_membership.rb +41 -0
  200. data/app/models/collavre/comment.rb +336 -31
  201. data/app/models/collavre/comment_notification_delivery.rb +61 -0
  202. data/app/models/collavre/comment_presence_store/cache_batches.rb +64 -0
  203. data/app/models/collavre/comment_presence_store.rb +272 -12
  204. data/app/models/collavre/comment_read_pointer.rb +9 -15
  205. data/app/models/collavre/creative/describable.rb +8 -2
  206. data/app/models/collavre/creative/permissible.rb +11 -0
  207. data/app/models/collavre/creative.rb +29 -4
  208. data/app/models/collavre/creative_share.rb +109 -4
  209. data/app/models/collavre/current.rb +1 -0
  210. data/app/models/collavre/llm_model.rb +62 -0
  211. data/app/models/collavre/system_setting.rb +12 -1
  212. data/app/models/collavre/task.rb +121 -2
  213. data/app/models/collavre/topic.rb +51 -0
  214. data/app/models/collavre/user.rb +101 -41
  215. data/app/models/collavre/user_creative_preference.rb +3 -1
  216. data/app/services/collavre/agent_provisioning/archive.rb +108 -0
  217. data/app/services/collavre/ai_agent/a2a_dispatcher.rb +16 -3
  218. data/app/services/collavre/ai_agent/agent_lifecycle_manager.rb +63 -6
  219. data/app/services/collavre/ai_agent/approval_handler.rb +12 -4
  220. data/app/services/collavre/ai_agent/claude_channel_adapter.rb +10 -5
  221. data/app/services/collavre/ai_agent/merged_trigger_comments.rb +164 -0
  222. data/app/services/collavre/ai_agent/message_builder.rb +103 -16
  223. data/app/services/collavre/ai_agent/session_provisioner.rb +3 -7
  224. data/app/services/collavre/ai_agent/task_claim_service.rb +29 -15
  225. data/app/services/collavre/ai_agent/task_reply_service.rb +67 -0
  226. data/app/services/collavre/ai_agent_service.rb +108 -20
  227. data/app/services/collavre/ai_client.rb +211 -21
  228. data/app/services/collavre/cli_proxy/client.rb +147 -0
  229. data/app/services/collavre/cli_proxy/endpoint_policy.rb +81 -0
  230. data/app/services/collavre/cli_proxy/identity.rb +47 -0
  231. data/app/services/collavre/cli_proxy/safe_net_http_adapter.rb +19 -0
  232. data/app/services/collavre/command_menu_service.rb +0 -10
  233. data/app/services/collavre/comment_move_service.rb +96 -7
  234. data/app/services/collavre/comment_snapshot_restore_service.rb +11 -5
  235. data/app/services/collavre/comments/action_executor.rb +48 -20
  236. data/app/services/collavre/comments/command_processor.rb +0 -1
  237. data/app/services/collavre/comments/list_response.rb +133 -0
  238. data/app/services/collavre/comments/read_pointer_writer.rb +210 -0
  239. data/app/services/collavre/comments/read_receipt_broadcaster.rb +157 -0
  240. data/app/services/collavre/comments/read_receipt_index.rb +152 -0
  241. data/app/services/collavre/comments/topic_command.rb +72 -1
  242. data/app/services/collavre/comments/topic_mutation.rb +20 -0
  243. data/app/services/collavre/creatives/breadcrumb_resolver.rb +1 -1
  244. data/app/services/collavre/creatives/comment_badge_index.rb +299 -27
  245. data/app/services/collavre/creatives/reorderer.rb +15 -3
  246. data/app/services/collavre/creatives/tree_builder.rb +1 -1
  247. data/app/services/collavre/creatives/tree_formatter.rb +5 -6
  248. data/app/services/collavre/creatives/workspace_path_resolver.rb +50 -0
  249. data/app/services/collavre/creatives/workspace_tree_builder.rb +92 -0
  250. data/app/services/collavre/crons/recurring_topic_tasks.rb +23 -0
  251. data/app/services/collavre/home_page_path.rb +55 -0
  252. data/app/services/collavre/html_text.rb +64 -0
  253. data/app/services/collavre/http_client.rb +11 -2
  254. data/app/services/collavre/inbox_reply_service.rb +1 -1
  255. data/app/services/collavre/markdown_converter.rb +13 -1
  256. data/app/services/collavre/orchestration/agent_orchestrator.rb +776 -81
  257. data/app/services/collavre/orchestration/arbiter.rb +48 -5
  258. data/app/services/collavre/orchestration/deferred_trigger_scope.rb +53 -0
  259. data/app/services/collavre/orchestration/delivery_record.rb +792 -0
  260. data/app/services/collavre/orchestration/loop_breaker.rb +10 -4
  261. data/app/services/collavre/orchestration/matcher.rb +132 -17
  262. data/app/services/collavre/orchestration/policy_resolver.rb +58 -10
  263. data/app/services/collavre/orchestration/scheduler.rb +10 -4
  264. data/app/services/collavre/orchestration/scheduling_hooks.rb +10 -0
  265. data/app/services/collavre/orchestration/selection.rb +43 -0
  266. data/app/services/collavre/orchestration/stuck_detector.rb +25 -112
  267. data/app/services/collavre/orchestration/task_coalescer.rb +355 -0
  268. data/app/services/collavre/orchestration/topic_slot.rb +73 -0
  269. data/app/services/collavre/system_events/context_builder.rb +60 -11
  270. data/app/services/collavre/system_events/dispatcher.rb +58 -12
  271. data/app/services/collavre/system_events/envelope.rb +73 -0
  272. data/app/services/collavre/system_events/vocabulary.rb +45 -0
  273. data/app/services/collavre/tools/creative_retrieval_service.rb +1 -1
  274. data/app/services/collavre/tools/cron_create_service.rb +32 -18
  275. data/app/services/collavre/tools/id_list.rb +38 -0
  276. data/app/services/collavre/tools/topic_authorizer.rb +61 -7
  277. data/app/services/collavre/tools/topic_branch_service.rb +85 -0
  278. data/app/services/collavre/tools/topic_create_service.rb +117 -0
  279. data/app/services/collavre/tools/topic_list_service.rb +101 -0
  280. data/app/services/collavre/tools/topic_message_create_service.rb +192 -0
  281. data/app/services/collavre/tools/topic_messages_service.rb +346 -0
  282. data/app/services/collavre/tools/topic_move_service.rb +108 -0
  283. data/app/services/collavre/tools/topic_selection.rb +59 -0
  284. data/app/services/collavre/tools/topic_update_service.rb +165 -0
  285. data/app/services/collavre/topic_branch_service.rb +39 -10
  286. data/app/services/collavre/topics/agent_resolver.rb +87 -0
  287. data/app/services/collavre/topics/char_budget.rb +70 -0
  288. data/app/services/collavre/topics/last_topic_preference_payload.rb +18 -0
  289. data/app/services/collavre/topics/message_page.rb +380 -0
  290. data/app/services/collavre/topics/message_page_markdown.rb +102 -0
  291. data/app/services/collavre/topics/message_scope.rb +61 -0
  292. data/app/services/collavre/topics/message_stats.rb +92 -0
  293. data/app/services/collavre/topics/move_blocker.rb +47 -0
  294. data/app/services/collavre/topics/next_name.rb +35 -0
  295. data/app/services/collavre/topics/pin_rejection.rb +25 -0
  296. data/app/services/collavre/topics/read_pointer_relocator.rb +71 -0
  297. data/app/services/collavre/topics/reserved_name.rb +18 -0
  298. data/app/services/collavre/topics/serializer.rb +92 -0
  299. data/app/services/collavre/topics/topic_destroy.rb +30 -0
  300. data/app/services/collavre/topics/topic_move.rb +80 -0
  301. data/app/services/collavre/topics/topic_move_effects.rb +35 -0
  302. data/app/services/collavre/topics/topic_mutation.rb +27 -0
  303. data/app/views/collavre/admin/integrations/_setting_row.html.erb +5 -8
  304. data/app/views/collavre/admin/settings/_system_tab.html.erb +7 -0
  305. data/app/views/collavre/agent_connections/show.html.erb +77 -0
  306. data/app/views/collavre/agent_gateways/_form.html.erb +71 -0
  307. data/app/views/collavre/agent_gateways/edit.html.erb +2 -0
  308. data/app/views/collavre/agent_gateways/index.html.erb +54 -0
  309. data/app/views/collavre/agent_gateways/new.html.erb +2 -0
  310. data/app/views/collavre/comments/_comments_popup.html.erb +32 -17
  311. data/app/views/collavre/comments/_empty_state.html.erb +33 -0
  312. data/app/views/collavre/comments/_empty_state_minimal.html.erb +7 -0
  313. data/app/views/collavre/comments/_feature_card.html.erb +35 -0
  314. data/app/views/collavre/comments/_list.html.erb +3 -2
  315. data/app/views/collavre/comments/_no_search_results.html.erb +3 -0
  316. data/app/views/collavre/creatives/_add_button.html.erb +17 -19
  317. data/app/views/collavre/creatives/_empty_state.html.erb +109 -0
  318. data/app/views/collavre/creatives/_inline_edit_form.html.erb +5 -5
  319. data/app/views/collavre/creatives/_tree_loading_placeholder.html.erb +16 -0
  320. data/app/views/collavre/creatives/_workspace_tree.html.erb +33 -0
  321. data/app/views/collavre/creatives/index.html.erb +79 -18
  322. data/app/views/collavre/desktop_setup/show.html.erb +114 -0
  323. data/app/views/collavre/features/index.html.erb +42 -0
  324. data/app/views/collavre/features/show.html.erb +52 -0
  325. data/app/views/collavre/invitation_mailer/invite.html.erb +1 -1
  326. data/app/views/collavre/invitation_mailer/invite.text.erb +1 -1
  327. data/app/views/collavre/invites/show.html.erb +14 -1
  328. data/app/views/collavre/landing/show.html.erb +5 -1
  329. data/app/views/collavre/shared/_link_creative_modal.html.erb +4 -1
  330. data/app/views/collavre/shared/navigation/_help_button.html.erb +3 -1
  331. data/app/views/collavre/shared/navigation/_panels.html.erb +1 -8
  332. data/app/views/collavre/shared/navigation/_search_form.html.erb +13 -2
  333. data/app/views/collavre/user_themes/index.html.erb +1 -1
  334. data/app/views/collavre/users/_llm_fields.html.erb +65 -0
  335. data/app/views/collavre/users/_org_chart_node.html.erb +1 -1
  336. data/app/views/collavre/users/edit_ai.html.erb +33 -31
  337. data/app/views/collavre/users/new.html.erb +4 -2
  338. data/app/views/collavre/users/new_ai.html.erb +14 -32
  339. data/app/views/collavre/users/show.html.erb +13 -1
  340. data/app/views/layouts/collavre/landing.html.erb +9 -4
  341. data/config/initializers/ruby_llm_openai_reasoning_content.rb +77 -0
  342. data/config/locales/admin.en.yml +3 -1
  343. data/config/locales/admin.ko.yml +3 -1
  344. data/config/locales/agent_gateway.en.yml +217 -0
  345. data/config/locales/agent_gateway.ko.yml +217 -0
  346. data/config/locales/ai_agent.en.yml +0 -1
  347. data/config/locales/ai_agent.ko.yml +0 -1
  348. data/config/locales/comments.en.yml +72 -30
  349. data/config/locales/comments.ko.yml +72 -30
  350. data/config/locales/creatives.en.yml +32 -1
  351. data/config/locales/creatives.ko.yml +32 -1
  352. data/config/locales/features.en.yml +140 -0
  353. data/config/locales/features.ko.yml +140 -0
  354. data/config/locales/invites.en.yml +3 -0
  355. data/config/locales/invites.ko.yml +3 -0
  356. data/config/locales/landing.en.yml +2 -1
  357. data/config/locales/landing.ko.yml +2 -1
  358. data/config/locales/tools.en.yml +20 -0
  359. data/config/locales/tools.ko.yml +20 -0
  360. data/config/locales/users.en.yml +15 -14
  361. data/config/locales/users.ko.yml +14 -14
  362. data/config/routes.rb +45 -19
  363. data/db/migrate/20250911084338_backfill_creative_in_comment_inbox_items.rb +9 -1
  364. data/db/migrate/20260724000000_add_creative_id_index_to_comments.rb +34 -0
  365. data/db/migrate/20260724000001_add_creative_private_id_index_to_comments.rb +50 -0
  366. data/db/migrate/20260724090000_add_async_comment_notification_state.rb +64 -0
  367. data/db/migrate/20260727000000_add_waiting_notice_scope_to_comments.rb +30 -0
  368. data/db/migrate/20260727010000_add_waiting_notice_scope_to_tasks.rb +26 -0
  369. data/db/migrate/20260805000000_add_creative_workspace_enabled_to_users.rb +5 -0
  370. data/db/migrate/20260807050000_add_dismissed_notices_to_users.rb +5 -0
  371. data/db/migrate/20260809000000_change_creative_workspace_enabled_default_to_true.rb +18 -0
  372. data/db/migrate/20260809000001_create_llm_models.rb +64 -0
  373. data/db/migrate/20260809000002_create_agent_gateways_and_workspaces.rb +35 -0
  374. data/db/migrate/20260809000003_hash_agent_workspace_callback_tokens.rb +44 -0
  375. data/db/migrate/20260809000004_encrypt_agent_workspace_manifest_tokens.rb +59 -0
  376. data/db/migrate/20260810000000_split_agent_workspace_identity_axes.rb +58 -0
  377. data/db/migrate/20260810000001_seed_codex_custom_proxy_llm_models.rb +28 -0
  378. data/db/migrate/20260810010000_add_last_visited_creative_to_users.rb +8 -0
  379. data/db/migrate/20260810020000_add_last_visited_creative_at_to_users.rb +5 -0
  380. data/db/migrate/20260810030000_add_last_visited_creative_navigation_order_to_users.rb +6 -0
  381. data/db/migrate/20260810060000_add_last_visited_creative_issued_sequence_to_users.rb +5 -0
  382. data/db/migrate/20260810100000_add_desktop_managed_to_agent_gateways.rb +40 -0
  383. data/db/migrate/20260810100001_add_desktop_preset_adapter_to_users.rb +38 -0
  384. data/db/migrate/20260811000000_make_agent_gateway_completion_key_nullable.rb +7 -0
  385. data/db/migrate/20260812000000_remove_workflow_columns_from_tasks.rb +101 -0
  386. data/db/migrate/20260812000001_remove_android_devices.rb +24 -0
  387. data/db/migrate/20260812010000_drop_inbox_items.rb +22 -0
  388. data/db/migrate/20260813000000_clear_claude_channel_presence_routing_expressions.rb +16 -0
  389. data/db/migrate/20260813000001_add_last_topic_revision_to_user_creative_preferences.rb +5 -0
  390. data/db/migrate/20260813000002_add_last_topic_save_order_to_user_creative_preferences.rb +6 -0
  391. data/db/migrate/20260813000003_add_last_topic_save_sequences_to_user_creative_preferences.rb +5 -0
  392. data/db/migrate/20260813000004_add_last_topic_save_fences_to_user_creative_preferences.rb +6 -0
  393. data/db/migrate/20260814000000_add_topic_to_comment_read_pointers.rb +79 -0
  394. data/db/migrate/20260814000001_add_creative_topic_private_id_index_to_comments.rb +37 -0
  395. data/db/migrate/20260816000000_add_watermark_index_to_comment_read_pointers.rb +27 -0
  396. data/db/migrate/20260816000001_add_private_recipient_topic_index_to_comments.rb +48 -0
  397. data/db/migrate/20260820000000_add_topic_assigned_at_to_comments.rb +13 -0
  398. data/db/seeds.rb +1 -51
  399. data/lib/collavre/engine.rb +108 -1
  400. data/lib/collavre/feature_card_registry.rb +168 -0
  401. data/lib/collavre/hashed_access_token_lookup.rb +22 -0
  402. data/lib/collavre/sensitive_request_silencer.rb +23 -0
  403. data/lib/collavre/user_extensions.rb +0 -2
  404. data/lib/collavre/version.rb +1 -1
  405. data/lib/collavre.rb +1 -0
  406. data/skills/collavre/SKILL.md +165 -0
  407. data/skills/collavre/package.json +8 -0
  408. data/skills/collavre/references/tool-reference.md +347 -0
  409. data/skills/collavre/scripts/collavre +634 -0
  410. data/skills/collavre/scripts/html_entities.js +24 -0
  411. metadata +228 -30
  412. data/app/controllers/collavre/api/v1/mobile/agent_events_controller.rb +0 -224
  413. data/app/controllers/collavre/api/v1/mobile/base_controller.rb +0 -95
  414. data/app/controllers/collavre/api/v1/mobile/devices_controller.rb +0 -31
  415. data/app/controllers/collavre/api/v1/mobile/voice_commands_controller.rb +0 -25
  416. data/app/controllers/collavre/inbox_items_controller.rb +0 -70
  417. data/app/controllers/collavre/typo_corrections_controller.rb +0 -39
  418. data/app/javascript/lib/__tests__/typo_correction.test.js +0 -192
  419. data/app/javascript/lib/typo_correction.js +0 -146
  420. data/app/javascript/modules/__tests__/typo_corrector.test.js +0 -365
  421. data/app/javascript/modules/creative_guide.js +0 -67
  422. data/app/javascript/modules/typo_corrector.js +0 -534
  423. data/app/jobs/collavre/inbox_summary_job.rb +0 -24
  424. data/app/mailers/collavre/inbox_mailer.rb +0 -19
  425. data/app/models/collavre/inbox_item.rb +0 -89
  426. data/app/services/collavre/comments/concerns/workflow_support.rb +0 -115
  427. data/app/services/collavre/comments/work_command.rb +0 -161
  428. data/app/services/collavre/comments/workflow_executor.rb +0 -276
  429. data/app/services/collavre/gemini_parent_recommender.rb +0 -77
  430. data/app/services/collavre/mobile/event_summarizer.rb +0 -40
  431. data/app/services/collavre/typo_corrector.rb +0 -188
  432. data/app/views/collavre/inbox_items/_item.html.erb +0 -18
  433. data/app/views/collavre/inbox_items/_items.html.erb +0 -3
  434. data/app/views/collavre/inbox_items/_list.html.erb +0 -7
  435. data/app/views/collavre/inbox_items/index.html.erb +0 -1
  436. data/app/views/collavre/inbox_mailer/daily_summary.html.erb +0 -11
  437. data/app/views/collavre/inbox_mailer/daily_summary.text.erb +0 -8
  438. data/app/views/collavre/users/typo_correction.html.erb +0 -50
  439. data/config/locales/mobile.en.yml +0 -16
  440. data/config/locales/mobile.ko.yml +0 -16
@@ -0,0 +1,634 @@
1
+ #!/usr/bin/env node
2
+ // Collavre CLI — MCP SSE client for Creative management
3
+ // Usage: collavre <command> [options]
4
+
5
+ import fs from "node:fs";
6
+ import path from "node:path";
7
+ import https from "node:https";
8
+ import http from "node:http";
9
+ import os from "node:os";
10
+ import { randomBytes } from "node:crypto";
11
+ import { decodeHtmlEntities } from "./html_entities.js";
12
+
13
+ const CONFIG_DIR = path.join(
14
+ os.homedir(),
15
+ ".config",
16
+ "collavre"
17
+ );
18
+ const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
19
+
20
+ // --- Config ---
21
+ function loadConfig() {
22
+ try {
23
+ return JSON.parse(fs.readFileSync(CONFIG_FILE, "utf8"));
24
+ } catch {
25
+ return {};
26
+ }
27
+ }
28
+
29
+ function saveConfig(config) {
30
+ fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
31
+ fs.chmodSync(CONFIG_DIR, 0o700);
32
+
33
+ const temporaryFile = path.join(
34
+ CONFIG_DIR,
35
+ `.config.json.${process.pid}.${randomBytes(8).toString("hex")}.tmp`
36
+ );
37
+ let descriptor;
38
+ try {
39
+ descriptor = fs.openSync(temporaryFile, "wx", 0o600);
40
+ fs.fchmodSync(descriptor, 0o600);
41
+ fs.writeFileSync(descriptor, JSON.stringify(config, null, 2), "utf8");
42
+ fs.fsyncSync(descriptor);
43
+ fs.closeSync(descriptor);
44
+ descriptor = undefined;
45
+ fs.renameSync(temporaryFile, CONFIG_FILE);
46
+ } finally {
47
+ if (descriptor !== undefined) fs.closeSync(descriptor);
48
+ if (fs.existsSync(temporaryFile)) fs.unlinkSync(temporaryFile);
49
+ }
50
+ }
51
+
52
+ // --- MCP SSE Client ---
53
+ class McpClient {
54
+ constructor(url, token) {
55
+ this.baseUrl = url.replace(/\/+$/, "");
56
+ this.token = token;
57
+ this.sessionUrl = null;
58
+ this._pendingRequests = new Map();
59
+ this._sseBuffer = "";
60
+ }
61
+
62
+ async connect() {
63
+ const sseUrl = `${this.baseUrl}/mcp/sse`;
64
+ return new Promise((resolve, reject) => {
65
+ const timeout = setTimeout(
66
+ () => reject(new Error("SSE connection timeout")),
67
+ 10000
68
+ );
69
+ const req = this._request(sseUrl, { method: "GET" });
70
+
71
+ req.on("response", (res) => {
72
+ if (res.statusCode !== 200) {
73
+ clearTimeout(timeout);
74
+ reject(new Error(`SSE connection failed: ${res.statusCode}`));
75
+ return;
76
+ }
77
+ this._sseRes = res;
78
+ res.on("data", (chunk) => {
79
+ this._sseBuffer += chunk.toString();
80
+ const lines = this._sseBuffer.split("\n");
81
+ this._sseBuffer = lines.pop() || "";
82
+ for (const line of lines) {
83
+ if (line.startsWith("data: ")) {
84
+ const data = line.slice(6).trim();
85
+ // First data message contains the messages endpoint URL
86
+ if (!this.sessionUrl && data.includes("/mcp/messages")) {
87
+ clearTimeout(timeout);
88
+ this.sessionUrl = data.startsWith("http")
89
+ ? data
90
+ : `${this.baseUrl}${data}`;
91
+ resolve();
92
+ } else if (this.sessionUrl) {
93
+ // Subsequent data messages are JSON-RPC responses
94
+ this._handleSseMessage(data);
95
+ }
96
+ }
97
+ }
98
+ });
99
+ res.on("error", (e) => {
100
+ clearTimeout(timeout);
101
+ reject(e);
102
+ });
103
+ });
104
+ req.on("error", (e) => {
105
+ clearTimeout(timeout);
106
+ reject(e);
107
+ });
108
+ req.end();
109
+ });
110
+ }
111
+
112
+ _handleSseMessage(data) {
113
+ try {
114
+ const parsed = JSON.parse(data);
115
+ if (parsed.id && this._pendingRequests.has(parsed.id)) {
116
+ const { resolve, reject } = this._pendingRequests.get(parsed.id);
117
+ this._pendingRequests.delete(parsed.id);
118
+ if (parsed.error) {
119
+ reject(new Error(parsed.error.message || JSON.stringify(parsed.error)));
120
+ } else {
121
+ resolve(parsed.result);
122
+ }
123
+ }
124
+ } catch {
125
+ // ignore non-JSON SSE messages
126
+ }
127
+ }
128
+
129
+ async callTool(name, args) {
130
+ if (!this.sessionUrl) throw new Error("Not connected. Call connect() first.");
131
+
132
+ const id = Date.now();
133
+ const body = JSON.stringify({
134
+ jsonrpc: "2.0",
135
+ id,
136
+ method: "tools/call",
137
+ params: { name, arguments: args },
138
+ });
139
+
140
+ // Set up listener for SSE response before sending
141
+ const resultPromise = new Promise((resolve, reject) => {
142
+ const timeout = setTimeout(() => {
143
+ this._pendingRequests.delete(id);
144
+ reject(new Error("Tool call timeout (30s)"));
145
+ }, 30000);
146
+ this._pendingRequests.set(id, {
147
+ resolve: (v) => { clearTimeout(timeout); resolve(v); },
148
+ reject: (e) => { clearTimeout(timeout); reject(e); },
149
+ });
150
+ });
151
+
152
+ // Send the POST request (response comes via SSE, not HTTP body)
153
+ await new Promise((resolve, reject) => {
154
+ const req = this._request(this.sessionUrl, {
155
+ method: "POST",
156
+ headers: { "Content-Type": "application/json" },
157
+ });
158
+ req.on("response", (res) => {
159
+ // 200 or 202 = accepted, actual result comes via SSE
160
+ if (res.statusCode >= 200 && res.statusCode < 300) {
161
+ res.resume(); // drain response
162
+ resolve();
163
+ } else {
164
+ let data = "";
165
+ res.on("data", (chunk) => (data += chunk));
166
+ res.on("end", () => reject(new Error(`HTTP ${res.statusCode}: ${data}`)));
167
+ }
168
+ });
169
+ req.on("error", reject);
170
+ req.write(body);
171
+ req.end();
172
+ });
173
+
174
+ return resultPromise;
175
+ }
176
+
177
+ disconnect() {
178
+ if (this._sseRes) {
179
+ this._sseRes.destroy();
180
+ this._sseRes = null;
181
+ }
182
+ }
183
+
184
+ _request(url, opts) {
185
+ const parsed = new URL(url);
186
+ const mod = parsed.protocol === "https:" ? https : http;
187
+ return mod.request(url, {
188
+ ...opts,
189
+ headers: {
190
+ ...(opts.headers || {}),
191
+ Authorization: `Bearer ${this.token}`,
192
+ },
193
+ });
194
+ }
195
+ }
196
+
197
+ // --- Multipart upload (bearer) to the Collavre web app ---
198
+ // Bytes travel as raw multipart, not base64-over-JSON-RPC, so binary files
199
+ // (png, mp4, pdf, svg) upload without bloat. The endpoint embeds the node into
200
+ // the creative's description and attaches it to creative.files.
201
+ function postMultipartFile(baseUrl, token, creativeId, filePath) {
202
+ return new Promise((resolve, reject) => {
203
+ const fileName = path.basename(filePath);
204
+ const fileBuf = fs.readFileSync(filePath);
205
+ const boundary =
206
+ "----collavre" +
207
+ Buffer.from(fileName + fileBuf.length).toString("hex").slice(0, 16);
208
+ const head = Buffer.from(
209
+ `--${boundary}\r\n` +
210
+ `Content-Disposition: form-data; name="file"; filename="${fileName}"\r\n` +
211
+ `Content-Type: application/octet-stream\r\n\r\n`
212
+ );
213
+ const tail = Buffer.from(`\r\n--${boundary}--\r\n`);
214
+ const body = Buffer.concat([head, fileBuf, tail]);
215
+
216
+ const url = new URL(
217
+ `${baseUrl.replace(/\/+$/, "")}/creatives/${creativeId}/attachments`
218
+ );
219
+ const mod = url.protocol === "https:" ? https : http;
220
+ const req = mod.request(url, {
221
+ method: "POST",
222
+ headers: {
223
+ Authorization: `Bearer ${token}`,
224
+ "Content-Type": `multipart/form-data; boundary=${boundary}`,
225
+ "Content-Length": body.length,
226
+ },
227
+ });
228
+ req.on("response", (res) => {
229
+ let data = "";
230
+ res.on("data", (c) => (data += c));
231
+ res.on("end", () => {
232
+ if (res.statusCode >= 200 && res.statusCode < 300) {
233
+ try {
234
+ resolve(JSON.parse(data));
235
+ } catch {
236
+ resolve({ raw: data });
237
+ }
238
+ } else {
239
+ reject(new Error(`HTTP ${res.statusCode}: ${data}`));
240
+ }
241
+ });
242
+ });
243
+ req.on("error", reject);
244
+ req.write(body);
245
+ req.end();
246
+ });
247
+ }
248
+
249
+ // --- Commands ---
250
+ async function withClient(fn) {
251
+ const config = loadConfig();
252
+ if (!config.url || !config.token) {
253
+ console.error("Not configured. Run: collavre auth --url <url> --token <token>");
254
+ process.exit(1);
255
+ }
256
+ const client = new McpClient(config.url, config.token);
257
+ try {
258
+ await client.connect();
259
+ await fn(client);
260
+ } finally {
261
+ client.disconnect();
262
+ }
263
+ }
264
+
265
+ function parseArgs(argv) {
266
+ const args = {};
267
+ const positional = [];
268
+ for (let i = 0; i < argv.length; i++) {
269
+ if (argv[i].startsWith("--")) {
270
+ const key = argv[i].slice(2);
271
+ const next = argv[i + 1];
272
+ if (!next || next.startsWith("--")) {
273
+ args[key] = true;
274
+ } else {
275
+ args[key] = next;
276
+ i++;
277
+ }
278
+ } else {
279
+ positional.push(argv[i]);
280
+ }
281
+ }
282
+ return { args, positional };
283
+ }
284
+
285
+ // Fix Ruby hash-style output to valid JSON
286
+ function fixRubyHash(text) {
287
+ if (!text) return text;
288
+ // Ruby symbol keys: {id: 1} → {"id": 1}
289
+ // Also handles nested arrays/hashes
290
+ try {
291
+ // Try parsing as JSON first
292
+ JSON.parse(text);
293
+ return text;
294
+ } catch {
295
+ // Convert Ruby hash syntax to JSON
296
+ // First, quote symbol keys: word: → "word":
297
+ let fixed = text
298
+ .replace(/(?<=[\{,\s])(\w+):\s/g, '"$1": ');
299
+ // Replace nil → null only outside quoted strings
300
+ fixed = fixed.replace(/"(?:[^"\\]|\\.)*"|(\bnil\b)/g, (match, nil) => nil ? "null" : match);
301
+ try {
302
+ JSON.parse(fixed);
303
+ return fixed;
304
+ } catch {
305
+ return text;
306
+ }
307
+ }
308
+ }
309
+
310
+ function processMarkdownOutput(text, truncateLen) {
311
+ let output = decodeHtmlEntities(text);
312
+ if (truncateLen && truncateLen > 0) {
313
+ output = output.split("\n").map((line) => {
314
+ // Match tree lines: " - [id] description (progress%)"
315
+ const match = line.match(/^(\s*-\s*\[\d+\]\s*)(.+?)(\s*\(\d+%\)\s*)$/);
316
+ if (match) {
317
+ let desc = match[2];
318
+ if (desc.length > truncateLen) {
319
+ desc = desc.slice(0, truncateLen - 1) + "…";
320
+ }
321
+ return match[1] + desc + match[3];
322
+ }
323
+ return line;
324
+ }).join("\n");
325
+ }
326
+ return output;
327
+ }
328
+
329
+ function printResult(result, { truncate } = {}) {
330
+ if (!result) return;
331
+ if (result.content) {
332
+ for (const item of result.content) {
333
+ if (item.type === "text") {
334
+ // Try to parse as JSON (or fix Ruby hash format)
335
+ const fixed = fixRubyHash(item.text);
336
+ try {
337
+ const parsed = JSON.parse(fixed);
338
+ console.log(JSON.stringify(parsed, null, 2));
339
+ } catch {
340
+ // Markdown output — decode HTML entities and optionally truncate
341
+ console.log(processMarkdownOutput(item.text, truncate));
342
+ }
343
+ }
344
+ }
345
+ } else {
346
+ console.log(JSON.stringify(result, null, 2));
347
+ }
348
+ }
349
+
350
+ const commands = {
351
+ auth(argv) {
352
+ const { args } = parseArgs(argv);
353
+ if (!args.url || !args.token) {
354
+ console.error("Usage: collavre auth --url <url> --token <token>");
355
+ process.exit(1);
356
+ }
357
+ saveConfig({ url: args.url, token: args.token });
358
+ console.log(`Saved config to ${CONFIG_FILE}`);
359
+ },
360
+
361
+ async list(argv) {
362
+ const { args } = parseArgs(argv);
363
+ const truncate = args.truncate ? parseInt(args.truncate) : undefined;
364
+ await withClient(async (client) => {
365
+ const result = await client.callTool("creative_retrieval_service", {
366
+ level: parseInt(args.level) || 3,
367
+ format: args.format || "markdown",
368
+ include_comments: args.comments === true,
369
+ });
370
+ printResult(result, { truncate });
371
+ });
372
+ },
373
+
374
+ async get(argv) {
375
+ const { args, positional } = parseArgs(argv);
376
+ const id = parseInt(positional[0]);
377
+ if (!id) {
378
+ console.error("Usage: collavre get <id> [--level N] [--comments] [--format json] [--truncate N]");
379
+ process.exit(1);
380
+ }
381
+ const truncate = args.truncate ? parseInt(args.truncate) : undefined;
382
+ await withClient(async (client) => {
383
+ const result = await client.callTool("creative_retrieval_service", {
384
+ id,
385
+ level: parseInt(args.level) || 3,
386
+ format: args.format || "markdown",
387
+ include_comments: args.comments === true,
388
+ });
389
+ printResult(result, { truncate });
390
+ });
391
+ },
392
+
393
+ async search(argv) {
394
+ const { args, positional } = parseArgs(argv);
395
+ const query = positional[0];
396
+ if (!query) {
397
+ console.error("Usage: collavre search <query> [--tags tags]");
398
+ process.exit(1);
399
+ }
400
+ await withClient(async (client) => {
401
+ const params = {
402
+ query,
403
+ };
404
+ if (args.tags) params.tags = args.tags;
405
+ const result = await client.callTool("creative_retrieval_service", params);
406
+ printResult(result);
407
+ });
408
+ },
409
+
410
+ async create(argv) {
411
+ const { args } = parseArgs(argv);
412
+ if (!args.desc) {
413
+ console.error("Usage: collavre create --parent <id> --desc <text>");
414
+ process.exit(1);
415
+ }
416
+ await withClient(async (client) => {
417
+ const params = { description: args.desc };
418
+ if (args.parent) params.parent_id = parseInt(args.parent);
419
+ if (args.after) params.after_id = parseInt(args.after);
420
+ if (args.before) params.before_id = parseInt(args.before);
421
+ const result = await client.callTool("creative_create_service", params);
422
+ printResult(result);
423
+ });
424
+ },
425
+
426
+ async update(argv) {
427
+ const { args, positional } = parseArgs(argv);
428
+ const id = parseInt(positional[0]);
429
+ if (!id) {
430
+ console.error("Usage: collavre update <id> [--desc text] [--progress 1.0] [--parent id]");
431
+ process.exit(1);
432
+ }
433
+ await withClient(async (client) => {
434
+ const params = { id };
435
+ if (args.desc) params.description = args.desc;
436
+ if (args.progress !== undefined) params.progress = parseFloat(args.progress);
437
+ if (args.parent !== undefined) params.parent_id = parseInt(args.parent);
438
+ const result = await client.callTool("creative_update_service", params);
439
+ printResult(result);
440
+ });
441
+ },
442
+
443
+ async import(argv) {
444
+ const { args } = parseArgs(argv);
445
+ const parentId = parseInt(args.parent);
446
+ if (!parentId) {
447
+ console.error("Usage: collavre import --parent <id> --file <path> | --stdin");
448
+ process.exit(1);
449
+ }
450
+
451
+ let markdown;
452
+ if (args.file) {
453
+ markdown = fs.readFileSync(args.file, "utf8");
454
+ } else if (args.stdin) {
455
+ markdown = fs.readFileSync(0, "utf8");
456
+ } else {
457
+ console.error("Provide --file <path> or --stdin");
458
+ process.exit(1);
459
+ }
460
+
461
+ await withClient(async (client) => {
462
+ const result = await client.callTool("creative_import_service", {
463
+ markdown,
464
+ parent_id: parentId,
465
+ });
466
+ printResult(result);
467
+ });
468
+ },
469
+
470
+ async batch(argv) {
471
+ const { args } = parseArgs(argv);
472
+ if (!args.file) {
473
+ console.error("Usage: collavre batch --file <ops.json>");
474
+ process.exit(1);
475
+ }
476
+ const ops = JSON.parse(fs.readFileSync(args.file, "utf8"));
477
+ await withClient(async (client) => {
478
+ const result = await client.callTool("creative_batch_service", {
479
+ operations: ops,
480
+ });
481
+ printResult(result);
482
+ });
483
+ },
484
+
485
+ async attach(argv) {
486
+ const { args } = parseArgs(argv);
487
+ const creativeId = parseInt(args.creative);
488
+ const file = args.file && args.file !== true ? args.file : null;
489
+ if (!creativeId || !file) {
490
+ console.error("Usage: collavre attach --creative <id> --file <path>");
491
+ process.exit(1);
492
+ }
493
+ if (!fs.existsSync(file)) {
494
+ console.error(`File not found: ${file}`);
495
+ process.exit(1);
496
+ }
497
+ const config = loadConfig();
498
+ if (!config.url || !config.token) {
499
+ console.error("Not configured. Run: collavre auth --url <url> --token <token>");
500
+ process.exit(1);
501
+ }
502
+ // config.url is the MCP base URL; the web app shares the same origin.
503
+ const webBase = new URL(config.url).origin;
504
+ const result = await postMultipartFile(webBase, config.token, creativeId, file);
505
+ console.log(JSON.stringify(result, null, 2));
506
+ },
507
+
508
+ async tool(argv) {
509
+ const { args, positional } = parseArgs(argv);
510
+ const sub = positional[0];
511
+
512
+ if (!sub || sub === "help") {
513
+ console.log(`Usage: collavre tool <subcommand> [options]
514
+
515
+ Subcommands:
516
+ list List available tools (summary)
517
+ list --full List with full details
518
+ search <query> Search tools by name/description
519
+ info <tool_name> Show tool parameters and usage
520
+ run <tool_name> --json '{}' Run tool with JSON arguments
521
+ run <tool_name> --key value Run tool with flag arguments`);
522
+ process.exit(0);
523
+ }
524
+
525
+ await withClient(async (client) => {
526
+ switch (sub) {
527
+ case "list": {
528
+ const action = args.full ? "list" : "list_summary";
529
+ const result = await client.callTool("meta_tool", { action });
530
+ printResult(result);
531
+ break;
532
+ }
533
+
534
+ case "search": {
535
+ const query = positional[1];
536
+ if (!query) {
537
+ console.error("Usage: collavre tool search <query>");
538
+ process.exit(1);
539
+ }
540
+ const result = await client.callTool("meta_tool", {
541
+ action: "search",
542
+ query,
543
+ });
544
+ printResult(result);
545
+ break;
546
+ }
547
+
548
+ case "info": {
549
+ const toolName = positional[1];
550
+ if (!toolName) {
551
+ console.error("Usage: collavre tool info <tool_name>");
552
+ process.exit(1);
553
+ }
554
+ const result = await client.callTool("meta_tool", {
555
+ action: "get",
556
+ tool_name: toolName,
557
+ });
558
+ printResult(result);
559
+ break;
560
+ }
561
+
562
+ case "run": {
563
+ const toolName = positional[1];
564
+ if (!toolName) {
565
+ console.error("Usage: collavre tool run <tool_name> [--json '{}' | --key value ...]");
566
+ process.exit(1);
567
+ }
568
+ let toolArgs = {};
569
+ if (args.json) {
570
+ toolArgs = JSON.parse(args.json);
571
+ } else {
572
+ // Build arguments from remaining --key value flags
573
+ const { json: _, ...rest } = args;
574
+ for (const [k, v] of Object.entries(rest)) {
575
+ // Auto-parse numbers and booleans
576
+ if (v === "true") toolArgs[k] = true;
577
+ else if (v === "false") toolArgs[k] = false;
578
+ else if (v !== true && !isNaN(v) && v !== "") toolArgs[k] = Number(v);
579
+ else toolArgs[k] = v;
580
+ }
581
+ }
582
+ const result = await client.callTool("meta_tool", {
583
+ action: "run",
584
+ tool_name: toolName,
585
+ arguments: toolArgs,
586
+ });
587
+ printResult(result);
588
+ break;
589
+ }
590
+
591
+ default:
592
+ console.error(`Unknown subcommand: ${sub}. Run 'collavre tool help' for usage.`);
593
+ process.exit(1);
594
+ }
595
+ });
596
+ },
597
+ };
598
+
599
+ // --- Main ---
600
+ async function main() {
601
+ const [cmd, ...argv] = process.argv.slice(2);
602
+
603
+ if (!cmd || cmd === "help" || cmd === "--help") {
604
+ console.log(`Collavre CLI — Manage Creatives via MCP
605
+
606
+ Usage: collavre <command> [options]
607
+
608
+ Commands:
609
+ auth --url <url> --token <token> Configure connection
610
+ list [--level N] [--format json] [--truncate N] List root creatives
611
+ get <id> [--level N] [--comments] [--truncate N] Get creative subtree
612
+ search <query> [--tags t1,t2] Search creatives
613
+ create --parent <id> --desc <text> Create creative
614
+ update <id> [--desc] [--progress 1.0] Update creative
615
+ import --parent <id> --file <path> Import markdown
616
+ attach --creative <id> --file <path> Upload & embed a file (bearer multipart)
617
+ batch --file <ops.json> Batch operations
618
+ tool <list|search|info|run> Discover & run any tool
619
+ help Show this help`);
620
+ process.exit(0);
621
+ }
622
+
623
+ if (commands[cmd]) {
624
+ await commands[cmd](argv);
625
+ } else {
626
+ console.error(`Unknown command: ${cmd}. Run 'collavre help' for usage.`);
627
+ process.exit(1);
628
+ }
629
+ }
630
+
631
+ main().catch((e) => {
632
+ console.error(`Error: ${e.message}`);
633
+ process.exit(1);
634
+ });
@@ -0,0 +1,24 @@
1
+ const NAMED_ENTITIES = {
2
+ amp: "&",
3
+ lt: "<",
4
+ gt: ">",
5
+ quot: '"',
6
+ "#39": "'",
7
+ nbsp: " ",
8
+ };
9
+
10
+ const ENTITY_PATTERN = /&(amp|lt|gt|quot|#39|nbsp|#\d+|#x[0-9a-fA-F]+);/g;
11
+
12
+ export function decodeHtmlEntities(text) {
13
+ if (!text) return text;
14
+
15
+ return text.replace(ENTITY_PATTERN, (match, entity) => {
16
+ if (Object.hasOwn(NAMED_ENTITIES, entity)) return NAMED_ENTITIES[entity];
17
+
18
+ const codePoint = entity.startsWith("#x")
19
+ ? Number.parseInt(entity.slice(2), 16)
20
+ : Number.parseInt(entity.slice(1), 10);
21
+
22
+ return codePoint <= 0x10ffff ? String.fromCodePoint(codePoint) : match;
23
+ });
24
+ }