kward 0.84.0 → 0.86.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 (245) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +164 -0
  3. data/CONTRIBUTING.md +1 -1
  4. data/Gemfile.lock +6 -2
  5. data/README.md +5 -5
  6. data/Rakefile +3 -0
  7. data/doc/agent-tools.md +24 -1
  8. data/doc/api.md +20 -2
  9. data/doc/composer.md +5 -4
  10. data/doc/configuration.md +86 -14
  11. data/doc/extensibility.md +4 -1
  12. data/doc/getting-started.md +3 -3
  13. data/doc/git.md +4 -2
  14. data/doc/memory.md +1 -1
  15. data/doc/pan.md +6 -0
  16. data/doc/permissions.md +4 -4
  17. data/doc/plugins.md +504 -20
  18. data/doc/providers.md +10 -4
  19. data/doc/rpc.md +279 -23
  20. data/doc/sandboxing.md +11 -5
  21. data/doc/security.md +7 -1
  22. data/doc/session-management.md +41 -5
  23. data/doc/shell.md +643 -27
  24. data/doc/tabs.md +8 -3
  25. data/doc/transports.md +15 -0
  26. data/doc/troubleshooting.md +1 -1
  27. data/doc/usage.md +25 -12
  28. data/doc/workspace-tools.md +9 -0
  29. data/examples/plugins/openrouter_proxy/README.md +103 -0
  30. data/examples/plugins/openrouter_proxy/fake_embeddings.rb +85 -0
  31. data/examples/plugins/openrouter_proxy/plugin.rb +7 -0
  32. data/examples/plugins/openrouter_proxy/protocol.rb +202 -0
  33. data/examples/plugins/openrouter_proxy/server.rb +186 -0
  34. data/examples/plugins/space_invaders.rb +1 -2
  35. data/examples/plugins/stardate_footer.rb +2 -2
  36. data/examples/plugins/telegram/plugin.rb +1 -1
  37. data/exe/kward +2 -2
  38. data/exe/kwsh +7 -0
  39. data/kward.gemspec +3 -1
  40. data/lib/kward/agent.rb +66 -19
  41. data/lib/kward/cli/commands.rb +41 -11
  42. data/lib/kward/cli/compaction.rb +9 -3
  43. data/lib/kward/cli/interactive_turn.rb +10 -0
  44. data/lib/kward/cli/plugins.rb +85 -12
  45. data/lib/kward/cli/prompt_interface.rb +29 -6
  46. data/lib/kward/cli/rendering.rb +24 -28
  47. data/lib/kward/cli/runtime_helpers.rb +168 -56
  48. data/lib/kward/cli/sessions.rb +9 -5
  49. data/lib/kward/cli/settings/menus.rb +745 -0
  50. data/lib/kward/cli/settings/model.rb +316 -0
  51. data/lib/kward/cli/settings.rb +6 -1055
  52. data/lib/kward/cli/slash_commands.rb +45 -4
  53. data/lib/kward/cli/tabs.rb +257 -44
  54. data/lib/kward/cli/tool_summaries.rb +2 -0
  55. data/lib/kward/{cli_transcript_formatter.rb → cli/transcript_formatter.rb} +6 -13
  56. data/lib/kward/cli/worktrees.rb +66 -2
  57. data/lib/kward/cli.rb +82 -31
  58. data/lib/kward/compactor.rb +18 -7
  59. data/lib/kward/config/core.rb +400 -0
  60. data/lib/kward/config/extensions.rb +99 -0
  61. data/lib/kward/config/paths.rb +11 -0
  62. data/lib/kward/config/prompts.rb +313 -0
  63. data/lib/kward/config/settings.rb +257 -0
  64. data/lib/kward/config_files.rb +14 -1008
  65. data/lib/kward/conversation.rb +41 -2
  66. data/lib/kward/entrypoint.rb +14 -0
  67. data/lib/kward/events.rb +2 -0
  68. data/lib/kward/generated_images.rb +237 -0
  69. data/lib/kward/image_attachments.rb +1 -1
  70. data/lib/kward/model/catalog.rb +6 -3
  71. data/lib/kward/model/client.rb +107 -38
  72. data/lib/kward/model/codex_images.rb +83 -0
  73. data/lib/kward/model/copilot_models.rb +10 -6
  74. data/lib/kward/model/model_info.rb +42 -7
  75. data/lib/kward/{openrouter_model_cache.rb → model/openrouter_model_cache.rb} +7 -5
  76. data/lib/kward/model/payloads.rb +18 -8
  77. data/lib/kward/model/sources.rb +3 -1
  78. data/lib/kward/model/stream_parser.rb +4 -7
  79. data/lib/kward/model/typesafe_client.rb +78 -0
  80. data/lib/kward/pan/index.html.erb +8 -1
  81. data/lib/kward/pan/server.rb +23 -8
  82. data/lib/kward/permissions/policy.rb +6 -2
  83. data/lib/kward/plugin_registry.rb +2 -659
  84. data/lib/kward/plugins/actions.rb +453 -0
  85. data/lib/kward/plugins/chat_contract.rb +121 -0
  86. data/lib/kward/{plugin_chat_runtime.rb → plugins/chat_runtime.rb} +62 -18
  87. data/lib/kward/plugins/codex_responses.rb +73 -0
  88. data/lib/kward/plugins/host.rb +248 -0
  89. data/lib/kward/plugins/http_server.rb +83 -0
  90. data/lib/kward/plugins/registry.rb +1229 -0
  91. data/lib/kward/plugins/resources.rb +206 -0
  92. data/lib/kward/plugins/turn_request.rb +36 -0
  93. data/lib/kward/plugins/ui.rb +219 -0
  94. data/lib/kward/prompt_interface/composer_controller.rb +0 -1
  95. data/lib/kward/prompt_interface/composer_renderer.rb +160 -73
  96. data/lib/kward/prompt_interface/composer_state.rb +1 -1
  97. data/lib/kward/prompt_interface/editor/controller.rb +2 -2
  98. data/lib/kward/prompt_interface/editor/renderer.rb +10 -7
  99. data/lib/kward/prompt_interface/editor/runner.rb +1 -1
  100. data/lib/kward/prompt_interface/editor/state.rb +1 -1
  101. data/lib/kward/prompt_interface/file_overlay.rb +3 -3
  102. data/lib/kward/prompt_interface/generated_image_preview.rb +162 -0
  103. data/lib/kward/prompt_interface/git_prompt.rb +18 -11
  104. data/lib/kward/prompt_interface/interactive/renderer.rb +1 -1
  105. data/lib/kward/prompt_interface/interactive/state.rb +18 -20
  106. data/lib/kward/prompt_interface/key_handler.rb +108 -25
  107. data/lib/kward/prompt_interface/layout.rb +11 -1
  108. data/lib/kward/prompt_interface/overlay_renderer.rb +26 -9
  109. data/lib/kward/prompt_interface/plugin_ui_requests.rb +82 -0
  110. data/lib/kward/prompt_interface/project_browser.rb +27 -54
  111. data/lib/kward/prompt_interface/prompt_renderer.rb +27 -35
  112. data/lib/kward/prompt_interface/question_prompt.rb +19 -28
  113. data/lib/kward/prompt_interface/runtime_state.rb +37 -10
  114. data/lib/kward/prompt_interface/screen.rb +30 -20
  115. data/lib/kward/prompt_interface/selection_prompt.rb +8 -8
  116. data/lib/kward/prompt_interface/slash_overlay.rb +1 -1
  117. data/lib/kward/prompt_interface/transcript_renderer.rb +7 -6
  118. data/lib/kward/prompt_interface.rb +149 -30
  119. data/lib/kward/prompts/commands.rb +2 -1
  120. data/lib/kward/prompts.rb +7 -1
  121. data/lib/kward/{adaptive_pty_output_sink.rb → pty/adaptive_output_sink.rb} +39 -5
  122. data/lib/kward/{interactive_pty_runner.rb → pty/interactive_runner.rb} +22 -30
  123. data/lib/kward/{local_command_runner.rb → pty/local_command_runner.rb} +1 -1
  124. data/lib/kward/{local_pty_command_runner.rb → pty/local_pty_runner.rb} +3 -9
  125. data/lib/kward/{pty_output_sink.rb → pty/output_sink.rb} +9 -4
  126. data/lib/kward/pty/transcript_normalizer.rb +137 -0
  127. data/lib/kward/rpc/config_manager.rb +3 -0
  128. data/lib/kward/rpc/plugin_chat_manager.rb +30 -10
  129. data/lib/kward/rpc/prompt_bridge.rb +25 -0
  130. data/lib/kward/rpc/server.rb +118 -17
  131. data/lib/kward/rpc/session_manager.rb +208 -60
  132. data/lib/kward/rpc/session_tree_rows.rb +2 -2
  133. data/lib/kward/rpc/tool_metadata.rb +1 -1
  134. data/lib/kward/rpc/transcript_normalizer.rb +11 -7
  135. data/lib/kward/sandbox/command_runner.rb +1 -1
  136. data/lib/kward/{session_catalog.rb → sessions/catalog.rb} +1 -1
  137. data/lib/kward/{session_store.rb → sessions/store.rb} +39 -12
  138. data/lib/kward/{session_tree_nodes.rb → sessions/tree_nodes.rb} +3 -3
  139. data/lib/kward/{session_tree_renderer.rb → sessions/tree_renderer.rb} +4 -4
  140. data/lib/kward/{session_tree_tool_display.rb → sessions/tree_tool_display.rb} +1 -1
  141. data/lib/kward/{kwsh.rb → shell/kwsh.rb} +30 -10
  142. data/lib/kward/{kwshrc.rb → shell/kwshrc.rb} +11 -2
  143. data/lib/kward/shell/native_arithmetic.rb +255 -0
  144. data/lib/kward/shell/native_arrays.rb +102 -0
  145. data/lib/kward/shell/native_braces.rb +96 -0
  146. data/lib/kward/shell/native_builtins.rb +476 -0
  147. data/lib/kward/shell/native_completion.rb +169 -0
  148. data/lib/kward/shell/native_condition.rb +75 -0
  149. data/lib/kward/shell/native_directory.rb +116 -0
  150. data/lib/kward/shell/native_exec_state.rb +73 -0
  151. data/lib/kward/shell/native_expansion.rb +252 -0
  152. data/lib/kward/shell/native_fields.rb +62 -0
  153. data/lib/kward/shell/native_glob.rb +96 -0
  154. data/lib/kward/shell/native_history.rb +242 -0
  155. data/lib/kward/shell/native_interactive.rb +164 -0
  156. data/lib/kward/shell/native_invocation.rb +42 -0
  157. data/lib/kward/shell/native_jobs.rb +250 -0
  158. data/lib/kward/shell/native_line_editor.rb +382 -0
  159. data/lib/kward/shell/native_line_terminal.rb +286 -0
  160. data/lib/kward/shell/native_locale.rb +109 -0
  161. data/lib/kward/shell/native_locals.rb +57 -0
  162. data/lib/kward/shell/native_pattern.rb +200 -0
  163. data/lib/kward/shell/native_process.rb +279 -0
  164. data/lib/kward/shell/native_program.rb +40 -0
  165. data/lib/kward/shell/native_programmable_completion.rb +115 -0
  166. data/lib/kward/shell/native_prompt_format.rb +89 -0
  167. data/lib/kward/shell/native_runtime.rb +964 -0
  168. data/lib/kward/shell/native_substitution.rb +110 -0
  169. data/lib/kward/shell/native_syntax.rb +946 -0
  170. data/lib/kward/shell/native_traps.rb +196 -0
  171. data/lib/kward/shell/native_vi.rb +407 -0
  172. data/lib/kward/shell/native_vi_terminal.rb +19 -0
  173. data/lib/kward/shell/native_worker.rb +82 -0
  174. data/lib/kward/{persistent_shell_session.rb → shell/persistent_session.rb} +187 -193
  175. data/lib/kward/shell/prompt.rb +66 -0
  176. data/lib/kward/shell/prompt_agent.rb +17 -0
  177. data/lib/kward/{shell_prompt_session.rb → shell/prompt_session.rb} +1 -1
  178. data/lib/kward/shell/script_runner.rb +244 -0
  179. data/lib/kward/shell/standalone_agent.rb +31 -0
  180. data/lib/kward/shell/standalone_link.rb +78 -0
  181. data/lib/kward/shell/standalone_terminal.rb +287 -0
  182. data/lib/kward/skills/trust_store.rb +1 -1
  183. data/lib/kward/tabs/driver.rb +194 -0
  184. data/lib/kward/{tab_store.rb → tabs/store.rb} +2 -2
  185. data/lib/kward/{clipboard.rb → terminal/clipboard.rb} +1 -1
  186. data/lib/kward/{terminal_image_support.rb → terminal/image_support.rb} +1 -1
  187. data/lib/kward/{terminal_keys.rb → terminal/keys.rb} +22 -1
  188. data/lib/kward/terminal/locale_text.rb +29 -0
  189. data/lib/kward/{terminal_sequences.rb → terminal/sequences.rb} +45 -4
  190. data/lib/kward/tools/base.rb +18 -0
  191. data/lib/kward/tools/context_for_task.rb +15 -6
  192. data/lib/kward/tools/datetime.rb +85 -0
  193. data/lib/kward/tools/edit_file.rb +9 -6
  194. data/lib/kward/tools/generate_image.rb +36 -0
  195. data/lib/kward/tools/git_commit.rb +13 -7
  196. data/lib/kward/tools/list_directory.rb +4 -4
  197. data/lib/kward/tools/plugin_tool.rb +41 -0
  198. data/lib/kward/tools/prepare_shell_command.rb +1 -1
  199. data/lib/kward/tools/read_file.rb +7 -6
  200. data/lib/kward/tools/registry.rb +130 -21
  201. data/lib/kward/tools/run_shell_command.rb +10 -8
  202. data/lib/kward/tools/search/code.rb +1 -1
  203. data/lib/kward/tools/summarize_file_structure.rb +5 -5
  204. data/lib/kward/tools/tool_call.rb +4 -1
  205. data/lib/kward/tools/typesafe_evaluate.rb +81 -0
  206. data/lib/kward/tools/workspace_targets.rb +58 -0
  207. data/lib/kward/tools/write_file.rb +9 -6
  208. data/lib/kward/{export_path.rb → transcripts/export_path.rb} +1 -1
  209. data/lib/kward/{markdown_transcript.rb → transcripts/markdown_transcript.rb} +10 -2
  210. data/lib/kward/transcripts/turn_summary_formatter.rb +93 -0
  211. data/lib/kward/transport/contracts.rb +200 -0
  212. data/lib/kward/transport/gateway.rb +81 -36
  213. data/lib/kward/transport/plugin_chat_gateway.rb +3 -2
  214. data/lib/kward/transport.rb +1 -200
  215. data/lib/kward/turn_summary.rb +68 -0
  216. data/lib/kward/version.rb +1 -1
  217. data/lib/kward/{workspace_factory.rb → workspace/factory.rb} +2 -2
  218. data/lib/kward/{git_worktree_manager.rb → workspace/git_worktree_manager.rb} +28 -0
  219. data/lib/kward/{workspace.rb → workspace/workspace.rb} +3 -3
  220. data/lib/main.rb +6 -3
  221. data/templates/default/fulldoc/html/css/kward.css +125 -0
  222. data/templates/default/fulldoc/html/images/kward_screen_1.png +0 -0
  223. data/templates/default/fulldoc/html/setup.rb +1 -1
  224. data/templates/default/layout/html/layout.erb +16 -4
  225. metadata +150 -48
  226. data/lib/kward/pty_transcript_normalizer.rb +0 -93
  227. data/lib/kward/shell_prompt.rb +0 -52
  228. data/lib/kward/tab_driver.rb +0 -90
  229. data/templates/default/fulldoc/html/images/kward_workflow.svg +0 -52
  230. /data/lib/kward/{editor_prompt.rb → cli/editor_prompt.rb} +0 -0
  231. /data/lib/kward/{editor_prompt_session.rb → cli/editor_prompt_session.rb} +0 -0
  232. /data/lib/kward/{diff_view_mode.rb → prompt_interface/editor/diff_view_mode.rb} +0 -0
  233. /data/lib/kward/{editor_mode.rb → prompt_interface/editor/editor_mode.rb} +0 -0
  234. /data/lib/kward/{markdown_code_block.rb → prompt_interface/editor/markdown_code_block.rb} +0 -0
  235. /data/lib/kward/{scratchpad_languages.rb → prompt_interface/editor/scratchpad_languages.rb} +0 -0
  236. /data/lib/kward/{scratchpad_runner.rb → prompt_interface/editor/scratchpad_runner.rb} +0 -0
  237. /data/lib/kward/{detached_run.rb → pty/detached_run.rb} +0 -0
  238. /data/lib/kward/{session_diff.rb → sessions/diff.rb} +0 -0
  239. /data/lib/kward/{session_naming.rb → sessions/naming.rb} +0 -0
  240. /data/lib/kward/{session_trash.rb → sessions/trash.rb} +0 -0
  241. /data/lib/kward/{ansi.rb → terminal/ansi.rb} +0 -0
  242. /data/lib/kward/{terminal_text.rb → terminal/text.rb} +0 -0
  243. /data/lib/kward/{transcript_export.rb → transcripts/transcript_export.rb} +0 -0
  244. /data/lib/kward/{project_files.rb → workspace/files.rb} +0 -0
  245. /data/lib/kward/{path_guard.rb → workspace/path_guard.rb} +0 -0
@@ -0,0 +1,316 @@
1
+ # CLI settings model behavior.
2
+ module Kward
3
+ class CLI
4
+ module Settings
5
+ module Model
6
+ private
7
+
8
+ def configure_model(conversation = nil, models: nil)
9
+ unless model_overlay_available?
10
+ runtime_output("Model overlay is unavailable in this prompt.")
11
+ return
12
+ end
13
+
14
+ models ||= normalized_available_models(conversation)
15
+ provider_filter = nil
16
+ show_all = false
17
+ loop do
18
+ visible_models = provider_filter ? models.select { |model| model[:provider] == provider_filter } : models
19
+ visible_models = visible_models.select { |model| ModelInfo.default_selectable_model?(model) } unless show_all
20
+ actions = ["Refresh model list", "Enter model ID manually", "Show all models", "Change provider"]
21
+ selected = @prompt.select("Default model", model_choices(visible_models, conversation) + actions, title: "Models", custom: true)
22
+ return unless selected
23
+
24
+ case selected.to_s
25
+ when "Refresh model list"
26
+ refreshed = @client.refresh_available_models(provider: provider_filter) if @client.respond_to?(:refresh_available_models)
27
+ models = normalized_available_models(conversation, models: refreshed)
28
+ when "Enter model ID manually"
29
+ provider = provider_filter || conversation&.provider || current_model_provider
30
+ model = @prompt.select("Model ID for #{provider}", [], title: "Models", custom: true)
31
+ return unless model
32
+ persist_model_selection(provider, model, conversation)
33
+ return
34
+ when "Show all models"
35
+ provider_filter = nil
36
+ show_all = true
37
+ when "Change provider"
38
+ selected_provider_name = selected_provider(@prompt.select("Provider", provider_choices, title: "Models"))
39
+ if selected_provider_name
40
+ provider_filter = selected_provider_name
41
+ show_all = false
42
+ end
43
+ else
44
+ provider, model = selected_model(selected, models)
45
+ persist_model_selection(provider, model, conversation)
46
+ return
47
+ end
48
+ end
49
+ rescue StandardError => e
50
+ runtime_output("Model error: #{e.message}")
51
+ end
52
+
53
+ def configure_reasoning(conversation = nil)
54
+ unless model_overlay_available?
55
+ runtime_output("Reasoning overlay is unavailable in this prompt.")
56
+ return
57
+ end
58
+
59
+ provider = conversation&.provider || current_model_provider
60
+ model = conversation&.model || current_model_id
61
+ choices = ModelInfo.reasoning_effort_choices(provider, model)
62
+ if choices.empty?
63
+ runtime_output("Reasoning effort is unavailable for #{provider} #{model}.")
64
+ return
65
+ end
66
+
67
+ selected = @prompt.select("Reasoning effort", reasoning_choices(choices, conversation), title: "Reasoning")
68
+ return unless selected
69
+
70
+ effort, = choices.find { |_value, label| selected.to_s.downcase.start_with?(label.downcase) }
71
+ raise "Reasoning effort must be one of: #{choices.map(&:first).join(", ")}" unless effort
72
+
73
+ set_reasoning_effort(effort, conversation, provider: provider)
74
+ rescue StandardError => e
75
+ runtime_output("Reasoning error: #{e.message}")
76
+ end
77
+
78
+ def login_picker_available?
79
+ @prompt.respond_to?(:select)
80
+ end
81
+
82
+ def login_method_choices
83
+ ["API key", "Subscription / OAuth"]
84
+ end
85
+
86
+ def selected_login_method(selected)
87
+ case selected.to_s.downcase
88
+ when /\Aapi key\z/ then :api_key
89
+ when /\Asubscription \/ oauth\z/ then :oauth
90
+ end
91
+ end
92
+
93
+ def login_provider_prompt(method)
94
+ method == :api_key ? "Add an API key" : "Sign in with a subscription"
95
+ end
96
+
97
+ def login_provider_choices(method)
98
+ if method == :api_key
99
+ ProviderCatalog.api_key_providers.map(&:name)
100
+ else
101
+ ["Anthropic Claude", "ChatGPT", "GitHub Copilot"]
102
+ end
103
+ end
104
+
105
+ def selected_login_provider(selected)
106
+ value = selected.to_s.downcase
107
+ return "openai" if value == "openai" || value == "chatgpt"
108
+ return "anthropic" if value == "anthropic" || value == "anthropic claude"
109
+ return "copilot" if value == "github copilot"
110
+
111
+ ProviderCatalog.find_by_name(selected)&.id
112
+ end
113
+
114
+ def model_overlay_available?
115
+ @prompt.respond_to?(:select)
116
+ end
117
+
118
+ def settings_overlay_available?
119
+ @prompt.respond_to?(:select)
120
+ end
121
+
122
+ def update_overlay_settings(values)
123
+ settings = ConfigFiles.update_overlay_settings(values)
124
+ @prompt.update_overlay_settings(settings) if @prompt.respond_to?(:update_overlay_settings)
125
+ settings
126
+ end
127
+
128
+ def choose_overlay_setting(message, choices, values)
129
+ choice = @prompt.select(message, choices, title: "Settings")
130
+ return nil unless choice
131
+
132
+ values.find { |value| choice.to_s.downcase.start_with?(value) }
133
+ end
134
+
135
+ def normalized_available_models(conversation = current_footer_conversation, models: nil)
136
+ current_provider = conversation.provider || (@client.respond_to?(:current_provider) ? @client.current_provider : "Codex")
137
+ current_model = conversation.model || (@client.respond_to?(:current_model) ? @client.current_model : nil)
138
+ current_reasoning = conversation.reasoning_effort || (@client.respond_to?(:current_reasoning_effort) ? @client.current_reasoning_effort : nil)
139
+ models ||= @client.respond_to?(:available_models) ? @client.available_models : []
140
+ ModelInfo.normalize_available(
141
+ models,
142
+ current_provider: current_provider,
143
+ current_model: current_model,
144
+ current_reasoning_effort: current_reasoning
145
+ )
146
+ end
147
+
148
+ def model_choices(models, conversation = current_footer_conversation)
149
+ current_provider = conversation.provider || current_model_provider
150
+ current_model = conversation.model || current_model_id
151
+ choices = models.map do |model|
152
+ label = "#{model[:provider]} #{model[:id]}"
153
+ label += " (current)" if model[:current]
154
+ label
155
+ end
156
+ choices.empty? ? ["#{current_provider} #{current_model} (current)"] : choices.uniq
157
+ end
158
+
159
+ def selected_model(selected, models)
160
+ text = selected.to_s.sub(/ \(current\)\z/, "").strip
161
+ known = models.find { |model| "#{model[:provider]} #{model[:id]}" == text }
162
+ return [known[:provider], known[:id]] if known
163
+
164
+ provider, model = text.split(/\s+/, 2)
165
+ known_provider = ["Codex", "Anthropic", "OpenRouter", "Copilot", "Local"].include?(provider) || ProviderCatalog.find_by_name(provider)
166
+ return [provider, model.strip] if known_provider && !model.to_s.strip.empty?
167
+
168
+ [current_model_provider, text]
169
+ end
170
+
171
+ def persist_model_selection(provider, model, conversation)
172
+ model = model.to_s.strip
173
+ raise "Model must be a non-empty string" if model.empty?
174
+
175
+ ConfigFiles.update_config(ModelInfo.config_values_for_selection(provider, model))
176
+ reload_client_config
177
+ refresh_conversation_runtime(conversation)
178
+ refresh_composer_status
179
+ end
180
+
181
+ REASONING_CONFIG_DEBOUNCE_SECONDS = 0.5
182
+
183
+ def cycle_reasoning(conversation = current_footer_conversation, direction: :next, persist: :immediate)
184
+ provider = conversation&.provider || current_model_provider
185
+ model = conversation&.model || current_model_id
186
+ choices = ModelInfo.reasoning_effort_choices(provider, model)
187
+ return false if choices.empty?
188
+
189
+ current = (pending_reasoning_effort(provider) || conversation&.reasoning_effort || current_reasoning_effort).to_s
190
+ current_index = choices.index { |effort, _label| effort == current }
191
+ current_index ||= direction == :previous ? 0 : -1
192
+ offset = direction == :previous ? -1 : 1
193
+ effort = choices[(current_index + offset) % choices.length].first
194
+ persist == :debounced ? apply_reasoning_effort(effort, conversation, provider: provider) : set_reasoning_effort(effort, conversation, provider: provider)
195
+ true
196
+ rescue StandardError => e
197
+ runtime_output("Reasoning error: #{e.message}")
198
+ false
199
+ end
200
+
201
+ def set_reasoning_effort(effort, conversation = nil, provider: nil)
202
+ @pending_reasoning_config_mutex.synchronize { @pending_reasoning_config = nil }
203
+ persist_reasoning_config(effort, provider: provider)
204
+ apply_reasoning_effort(effort, conversation, provider: provider, queue_config: false)
205
+ end
206
+
207
+ def apply_reasoning_effort(effort, conversation = nil, provider: nil, queue_config: true)
208
+ queue_reasoning_config(effort, provider: provider, conversation: conversation) if queue_config
209
+ if queue_config
210
+ update_conversation_reasoning_effort(conversation, effort)
211
+ refresh_composer_status
212
+ else
213
+ refresh_conversation_runtime(conversation, reasoning_effort: effort)
214
+ refresh_composer_status
215
+ end
216
+ end
217
+
218
+ def update_conversation_reasoning_effort(conversation, effort)
219
+ return unless conversation&.respond_to?(:update_runtime_context!)
220
+
221
+ conversation.update_runtime_context!(
222
+ provider: conversation.provider || current_model_provider,
223
+ model: conversation.model || current_model_id,
224
+ reasoning_effort: effort,
225
+ refresh: false
226
+ )
227
+ end
228
+
229
+ def pending_reasoning_effort(provider)
230
+ @pending_reasoning_config_mutex.synchronize do
231
+ pending = @pending_reasoning_config
232
+ return nil unless pending
233
+ return nil unless pending[:provider].to_s.downcase == provider.to_s.downcase
234
+
235
+ pending[:effort]
236
+ end
237
+ end
238
+
239
+ def queue_reasoning_config(effort, provider: nil, conversation: nil)
240
+ pending = {
241
+ effort: effort,
242
+ provider: provider || current_model_provider,
243
+ conversation: conversation,
244
+ deadline: Process.clock_gettime(Process::CLOCK_MONOTONIC) + REASONING_CONFIG_DEBOUNCE_SECONDS
245
+ }
246
+ @pending_reasoning_config_mutex.synchronize { @pending_reasoning_config = pending }
247
+ schedule_reasoning_config_flush
248
+ end
249
+
250
+ def schedule_reasoning_config_flush
251
+ return if @pending_reasoning_config_thread&.alive?
252
+
253
+ @pending_reasoning_config_thread = Thread.new do
254
+ loop do
255
+ sleep REASONING_CONFIG_DEBOUNCE_SECONDS
256
+ break if flush_pending_reasoning_config(force: false)
257
+ break unless @pending_reasoning_config_mutex.synchronize { @pending_reasoning_config }
258
+ end
259
+ rescue StandardError => e
260
+ runtime_output("Reasoning error: #{e.message}")
261
+ end
262
+ end
263
+
264
+ def flush_pending_reasoning_config(force: true, conversation: nil)
265
+ pending = nil
266
+ @pending_reasoning_config_mutex.synchronize do
267
+ pending = @pending_reasoning_config
268
+ return false unless pending
269
+
270
+ now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
271
+ return false if !force && now < pending[:deadline].to_f
272
+
273
+ @pending_reasoning_config = nil
274
+ end
275
+ persist_reasoning_config(pending[:effort], provider: pending[:provider])
276
+ conversation ||= pending[:conversation]
277
+ if conversation&.reasoning_effort.to_s == pending[:effort].to_s
278
+ refresh_conversation_runtime(conversation, reasoning_effort: pending[:effort])
279
+ conversation.persist_runtime_context! if conversation.respond_to?(:persist_runtime_context!)
280
+ end
281
+ true
282
+ end
283
+
284
+ def persist_reasoning_config(effort, provider: nil)
285
+ ConfigFiles.update_config(ModelInfo.reasoning_config_key_for_provider(provider || current_model_provider) => effort)
286
+ reload_client_config
287
+ end
288
+
289
+ def reasoning_choices(choices, conversation = current_footer_conversation)
290
+ current = (conversation.reasoning_effort || (@client.respond_to?(:current_reasoning_effort) ? @client.current_reasoning_effort : ModelInfo::DEFAULT_REASONING_EFFORT)).to_s
291
+ choices.map do |effort, label|
292
+ text = label.dup
293
+ text += " (current)" if current == effort
294
+ text
295
+ end
296
+ end
297
+
298
+ def overlay_alignment_choices(settings)
299
+ ConfigFiles::OVERLAY_ALIGNMENTS.map do |alignment|
300
+ label = alignment.capitalize
301
+ label += " (current)" if settings["alignment"] == alignment
302
+ label
303
+ end
304
+ end
305
+
306
+ def overlay_width_choices(settings)
307
+ ConfigFiles::OVERLAY_WIDTHS.map do |width|
308
+ label = width.capitalize
309
+ label += " (current)" if settings["width"] == width
310
+ label
311
+ end
312
+ end
313
+ end
314
+ end
315
+ end
316
+ end