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
@@ -4,17 +4,22 @@ require "thread"
4
4
  module Kward
5
5
  # Retains output while a detached PTY command runs without terminal ownership.
6
6
  class BufferedPtyOutputSink
7
- attr_reader :captured_output
8
-
9
- def initialize(max_capture_bytes:)
7
+ def initialize(max_capture_bytes:, initial_output: nil, initial_truncated: false)
10
8
  @max_capture_bytes = max_capture_bytes
11
9
  @captured_output = +"".b
12
- @truncated = false
10
+ @truncated = initial_truncated
13
11
  @mutex = Mutex.new
12
+ write(initial_output) unless initial_output.to_s.empty?
13
+ end
14
+
15
+ def captured_output
16
+ @mutex.synchronize { @captured_output.dup }
14
17
  end
15
18
 
16
19
  def write(chunk)
17
20
  value = chunk.to_s.b
21
+ return if value.empty?
22
+
18
23
  @mutex.synchronize do
19
24
  remaining = @max_capture_bytes - @captured_output.bytesize
20
25
  if value.bytesize > remaining
@@ -0,0 +1,137 @@
1
+ require_relative "../terminal/ansi"
2
+ require_relative "../terminal/text"
3
+
4
+ # Namespace for the Kward CLI agent runtime.
5
+ module Kward
6
+ # Reduces safe, line-oriented PTY redraws to transcript-friendly text.
7
+ class PtyTranscriptNormalizer
8
+ HORIZONTAL_REDRAW_PATTERN = /[\r\b]|\e\[[0-9;]*[CDGK`]/.freeze
9
+
10
+ MAX_SCREEN_COLUMNS = 4096
11
+
12
+ def self.normalize(text, columns: 80, max_bytes: nil)
13
+ columns = columns.to_i.clamp(1, MAX_SCREEN_COLUMNS)
14
+ output = +""
15
+ text.each_line do |line|
16
+ body = line.delete_suffix("\n")
17
+ output << if body.match?(HORIZONTAL_REDRAW_PATTERN)
18
+ Line.new(body, columns).render
19
+ else
20
+ ANSI.sanitize_transcript(body)
21
+ end
22
+ output << "\n" if line.end_with?("\n")
23
+ return nil if max_bytes && output.bytesize > max_bytes
24
+ end
25
+ output
26
+ end
27
+
28
+ # Applies the horizontal cursor controls accepted by AdaptivePtyOutputSink
29
+ # without modeling a complete terminal screen.
30
+ class Line
31
+ WideGlyph = Struct.new(:text, :column, :width)
32
+ BLANK_CELL = " ".freeze
33
+
34
+ def initialize(text, columns)
35
+ @text = text
36
+ @last_column = columns - 1
37
+ @cells = []
38
+ @cursor = 0
39
+ end
40
+
41
+ def render
42
+ ANSI.scan_escape_tokens(@text).each do |token|
43
+ token[:escape] ? apply_escape(token[:text]) : write_text(token[:text])
44
+ end
45
+ @cells.each_with_index.map do |cell, column|
46
+ cell.is_a?(WideGlyph) ? (cell.text if cell.column == column) : cell
47
+ end.join.rstrip
48
+ end
49
+
50
+ private
51
+
52
+ def apply_escape(sequence)
53
+ final = sequence[-1]
54
+ return set_column(sequence) if final == "G" || final == "`"
55
+ return move_cursor(sequence, 1) if final == "C"
56
+ return move_cursor(sequence, -1) if final == "D"
57
+ return erase_line(sequence) if final == "K"
58
+ end
59
+
60
+ def set_column(sequence)
61
+ @cursor = (parameter(sequence, default: 1) - 1).clamp(0, @last_column)
62
+ end
63
+
64
+ def move_cursor(sequence, direction)
65
+ distance = [parameter(sequence, default: 1), 1].max
66
+ @cursor = (@cursor + (distance * direction)).clamp(0, @last_column)
67
+ end
68
+
69
+ def erase_line(sequence)
70
+ case parameter(sequence, default: 0)
71
+ when 1
72
+ 0.upto([@cursor, @cells.length - 1].min) { |index| clear_cell(index) }
73
+ when 2
74
+ @cells.clear
75
+ else
76
+ if @cursor < @cells.length
77
+ clear_cell(@cursor)
78
+ @cells.slice!(@cursor..)
79
+ end
80
+ end
81
+ end
82
+
83
+ def parameter(sequence, default:)
84
+ value = sequence[2...-1].to_s.split(";", 2).first.to_s
85
+ value.empty? ? default : value.to_i
86
+ end
87
+
88
+ def write_text(text)
89
+ text.each_grapheme_cluster do |grapheme|
90
+ case grapheme
91
+ when "\r"
92
+ @cursor = 0
93
+ when "\b"
94
+ @cursor = [@cursor - 1, 0].max
95
+ when "\t"
96
+ @cursor = [((@cursor / 8) + 1) * 8, @last_column].min
97
+ else
98
+ write_grapheme(grapheme)
99
+ end
100
+ end
101
+ end
102
+
103
+ def write_grapheme(grapheme)
104
+ width = grapheme.ascii_only? ? 1 : TerminalText.width(grapheme)
105
+ if width.zero?
106
+ previous = @cells[@cursor - 1] if @cursor.positive?
107
+ if previous.is_a?(WideGlyph)
108
+ previous.text << grapheme
109
+ elsif previous
110
+ previous = previous.dup if previous.frozen?
111
+ @cells[@cursor - 1] = previous << grapheme
112
+ end
113
+ return
114
+ end
115
+
116
+ fill_to_cursor
117
+ width.times { |offset| clear_cell(@cursor + offset) }
118
+ cell = width == 1 ? grapheme : WideGlyph.new(grapheme, @cursor, width)
119
+ @cells.fill(cell, @cursor, width)
120
+ @cursor += width
121
+ end
122
+
123
+ def clear_cell(column)
124
+ cell = @cells[column]
125
+ if cell.is_a?(WideGlyph)
126
+ @cells.fill(BLANK_CELL, cell.column, cell.width)
127
+ elsif cell
128
+ @cells[column] = BLANK_CELL
129
+ end
130
+ end
131
+
132
+ def fill_to_cursor
133
+ @cells.concat([BLANK_CELL] * (@cursor - @cells.length)) if @cursor > @cells.length
134
+ end
135
+ end
136
+ end
137
+ end
@@ -33,6 +33,9 @@ module Kward
33
33
  model = model.to_s.strip
34
34
  raise "Model must be a non-empty string" if model.empty?
35
35
 
36
+ # RPC catalog IDs identify direct OpenAI; legacy config "openai"
37
+ # continues to mean Codex when read by ModelInfo.
38
+ provider = "OpenAI" if provider.to_s == "openai"
36
39
  update(ModelInfo.config_values_for_selection(provider, model))
37
40
  end
38
41
 
@@ -1,7 +1,7 @@
1
1
  require_relative "../cancellation"
2
2
  require_relative "../image_attachments"
3
- require_relative "../plugin_chat_runtime"
4
- require_relative "../plugin_registry"
3
+ require_relative "../plugins/chat_runtime"
4
+ require_relative "../plugins/registry"
5
5
  require_relative "attachment_normalizer"
6
6
  require_relative "transcript_normalizer"
7
7
 
@@ -30,21 +30,25 @@ module Kward
30
30
  @runtime.supported_types(surface: :rpc)
31
31
  end
32
32
 
33
+ def type_entries
34
+ supported_types.map { |type| type_payload(type) }
35
+ end
36
+
33
37
  def list
34
- { chats: supported_types.map { |type| type_payload(type) } }
38
+ { chats: type_entries }
35
39
  end
36
40
 
37
41
  def open(type_id:)
38
42
  chat = @runtime.open(type_id: type_id, surface: :rpc, scope_key: "owner")
39
43
  payload = chat_payload(chat)
40
- return payload if chat.driver.respond_to?(:transcript_page)
44
+ return payload if transcript_paging?(chat)
41
45
 
42
46
  payload.merge(messages: TranscriptNormalizer.new(chat.driver.messages).normalize)
43
47
  end
44
48
 
45
49
  def transcript(chat_id:, limit: nil, before: nil)
46
50
  chat = fetch_chat(chat_id)
47
- page = transcript_page(chat.driver, limit: limit, before: before)
51
+ page = transcript_page(chat, limit: limit, before: before)
48
52
  {
49
53
  chat: chat_payload(chat),
50
54
  messages: TranscriptNormalizer.new(page.fetch(:messages)).normalize,
@@ -70,7 +74,7 @@ module Kward
70
74
  normalized_attachments = AttachmentNormalizer.new.normalize(attachments)
71
75
  turn = @runtime.start_turn(
72
76
  chat_id: chat.id,
73
- input: @runtime.input_with_attachments(input, normalized_attachments),
77
+ input: @runtime.input_with_attachments(input, normalized_attachments, capabilities: chat.type.capabilities),
74
78
  display_input: input.to_s
75
79
  )
76
80
  turn_payload(turn)
@@ -121,19 +125,35 @@ module Kward
121
125
  end
122
126
 
123
127
  def type_payload(type)
124
- {
128
+ payload = {
125
129
  id: type.id,
126
130
  name: type.name,
127
131
  title: type.title,
128
132
  singleton: type.singleton,
129
133
  transport: type.transport == true ? true : nil
130
134
  }.compact
135
+ return payload unless type.capabilities.declared?
136
+
137
+ capabilities = type.capabilities.to_h
138
+ payload.merge(
139
+ apiVersion: capabilities.fetch(:api_version),
140
+ capabilities: {
141
+ attachments: capabilities.fetch(:attachments),
142
+ steering: capabilities.fetch(:steering),
143
+ transcriptPaging: capabilities.fetch(:transcript_paging)
144
+ }
145
+ )
146
+ end
147
+
148
+ def transcript_paging?(chat)
149
+ capabilities = chat.type.capabilities
150
+ capabilities.declared? ? capabilities.transcript_paging? : chat.driver.respond_to?(:transcript_page)
131
151
  end
132
152
 
133
- def transcript_page(driver, limit:, before:)
134
- return { messages: driver.messages, has_more: false } unless limit && driver.respond_to?(:transcript_page)
153
+ def transcript_page(chat, limit:, before:)
154
+ return { messages: chat.driver.messages, has_more: false } unless limit && transcript_paging?(chat)
135
155
 
136
- driver.transcript_page(limit: limit, before: before)
156
+ chat.driver.transcript_page(limit: limit, before: before)
137
157
  end
138
158
 
139
159
  def chat_payload(chat)
@@ -74,6 +74,31 @@ module Kward
74
74
  answer_raw(request_id, normalize_answers(answers))
75
75
  end
76
76
 
77
+ def request_plugin_ui(kind, payload, cancellation: nil)
78
+ request_id = SecureRandom.uuid
79
+ @mutex.synchronize { @pending_requests[request_id] = true }
80
+ cancellation&.on_cancel { cancel_request(request_id) }
81
+ unless cancellation&.cancelled?
82
+ @notify.call("ui/request", {
83
+ sessionId: @session_id,
84
+ requestId: request_id,
85
+ kind: kind.to_s,
86
+ payload: payload
87
+ })
88
+ end
89
+
90
+ @mutex.synchronize do
91
+ @condition.wait(@mutex) until @answers.key?(request_id)
92
+ answer = @answers.delete(request_id)
93
+ @pending_requests.delete(request_id)
94
+ answer
95
+ end
96
+ end
97
+
98
+ def answer_plugin_ui(request_id, value)
99
+ answer_raw(request_id, value)
100
+ end
101
+
77
102
  def cancel_request(request_id)
78
103
  @mutex.synchronize do
79
104
  request_id = request_id.to_s
@@ -2,11 +2,11 @@ require "json"
2
2
  require_relative "../model/client"
3
3
  require_relative "../config_files"
4
4
  require_relative "../memory/manager"
5
- require_relative "../plugin_registry"
5
+ require_relative "../plugins/registry"
6
6
  require_relative "../transport"
7
7
  require_relative "../prompts/commands"
8
8
  require_relative "../tools/registry"
9
- require_relative "../workspace_factory"
9
+ require_relative "../workspace/factory"
10
10
  require_relative "../telemetry/logger"
11
11
  require_relative "../telemetry/stats"
12
12
  require_relative "auth_manager"
@@ -60,6 +60,7 @@ module Kward
60
60
  "sessions/export", "sessions/delete", "sessions/close", "sessions/transcript", "sessions/active"
61
61
  ].freeze
62
62
  TURN_METHODS = ["turns/start", "turns/cancel", "turns/status", "turns/events", "turns/list", "turns/listActive"].freeze
63
+ IMAGE_METHODS = ["images/fetch", "images/saveToProject", "images/discard"].freeze
63
64
  PLUGIN_CHAT_METHODS = ["pluginChats/list", "pluginChats/open", "pluginChats/transcript", "pluginChats/subscribe", "pluginChats/unsubscribe", "pluginChats/turns/start", "pluginChats/turns/cancel", "pluginChats/turns/status", "pluginChats/turns/events", "pluginChats/turns/list", "pluginChats/turns/listActive"].freeze
64
65
  MODEL_METHODS = ["models/list", "models/current", "models/set", "reasoning/set", "models/refresh"].freeze
65
66
  RUNTIME_METHODS = ["runtime/state", "runtime/stats"].freeze
@@ -75,18 +76,22 @@ module Kward
75
76
  "memory/why", "memory/summarize"
76
77
  ].freeze
77
78
  COMMAND_METHODS = ["commands/list", "commands/run"].freeze
79
+ PLUGIN_ACTION_METHODS = ["pluginActions/list", "pluginActions/run"].freeze
78
80
  SKILL_CAPTURE_METHODS = ["skills/captureSessions", "skills/captureDraft", "skills/saveCapturedDraft"].freeze
79
81
  STARTUP_RESOURCE_METHODS = ["resources/startup"].freeze
80
82
  CONFIG_METHODS = ["config/read", "config/update"].freeze
81
83
  LOGGING_METHODS = ["logging/stats", "logging/tokenCsv"].freeze
82
84
  LIFECYCLE_HOOK_METHODS = ["hooks/logs"].freeze
83
- UI_METHODS = ["ui/answerQuestion"].freeze
85
+ UI_METHODS = ["ui/answerQuestion", "ui/answerRequest"].freeze
84
86
  TOOL_APPROVAL_METHODS = ["tool/answerApproval"].freeze
85
87
  TRANSPORT_METHODS = ["transports/list", "transports/status"].freeze
86
88
  SESSION_EVENT_NOTIFICATION = "session/event"
87
89
  SESSION_UPDATED_NOTIFICATION = "session/updated"
88
90
  TURN_EVENT_NOTIFICATION = "turn/event"
89
91
  UI_QUESTION_NOTIFICATION = "ui/question"
92
+ UI_REQUEST_NOTIFICATION = "ui/request"
93
+ UI_PROGRESS_NOTIFICATION = "ui/progress"
94
+ UI_NOTIFICATION = "ui/notification"
90
95
  UI_FOOTER_NOTIFICATION = "ui/footer"
91
96
  TOOL_APPROVAL_NOTIFICATION = "tool/approvalRequested"
92
97
  HOOK_EVENT_NOTIFICATION = "hook/event"
@@ -98,6 +103,7 @@ module Kward
98
103
  prompts: PROMPT_METHODS,
99
104
  sessions: SESSION_METHODS,
100
105
  turns: TURN_METHODS,
106
+ images: IMAGE_METHODS,
101
107
  plugin_chats: PLUGIN_CHAT_METHODS,
102
108
  models: MODEL_METHODS,
103
109
  runtime: RUNTIME_METHODS,
@@ -105,6 +111,7 @@ module Kward
105
111
  auth: AUTH_METHODS,
106
112
  memory: MEMORY_METHODS,
107
113
  commands: COMMAND_METHODS,
114
+ plugin_actions: PLUGIN_ACTION_METHODS,
108
115
  skill_capture: SKILL_CAPTURE_METHODS,
109
116
  startup_resources: STARTUP_RESOURCE_METHODS,
110
117
  config: CONFIG_METHODS,
@@ -176,6 +183,7 @@ module Kward
176
183
  @transport_manager.shutdown
177
184
  @plugin_chat_manager.shutdown
178
185
  @session_manager.shutdown_sessions
186
+ @session_manager.shutdown_plugins
179
187
  @shutdown_complete = true
180
188
  end
181
189
 
@@ -284,6 +292,10 @@ module Kward
284
292
  commands_list(params)
285
293
  when COMMAND_METHODS[1]
286
294
  commands_run(params)
295
+ when PLUGIN_ACTION_METHODS[0]
296
+ plugin_actions_list(params)
297
+ when PLUGIN_ACTION_METHODS[1]
298
+ plugin_actions_run(params)
287
299
  when SKILL_CAPTURE_METHODS[0]
288
300
  { sessions: @session_manager.skill_capture_sessions }
289
301
  when SKILL_CAPTURE_METHODS[1]
@@ -378,6 +390,12 @@ module Kward
378
390
  @session_manager.transcript(session_id: params.fetch("sessionId"))
379
391
  when SESSION_METHODS[15]
380
392
  @session_manager.active_sessions
393
+ when IMAGE_METHODS[0]
394
+ @session_manager.fetch_generated_image(session_id: params.fetch("sessionId"), image_id: params.fetch("imageId"), offset: params.fetch("offset", 0))
395
+ when IMAGE_METHODS[1]
396
+ @session_manager.save_generated_image(session_id: params.fetch("sessionId"), image_id: params.fetch("imageId"), directory: params.fetch("directory", "."))
397
+ when IMAGE_METHODS[2]
398
+ @session_manager.discard_generated_image(session_id: params.fetch("sessionId"), image_id: params.fetch("imageId"))
381
399
  when TURN_METHODS[0]
382
400
  @session_manager.start_turn(
383
401
  session_id: params.fetch("sessionId"),
@@ -421,6 +439,8 @@ module Kward
421
439
  @plugin_chat_manager.list_turns(chat_id: params["chatId"], active: true)
422
440
  when UI_METHODS[0]
423
441
  @session_manager.answer_question(session_id: params.fetch("sessionId"), question_request_id: params.fetch("questionRequestId"), answers: params.fetch("answers"))
442
+ when UI_METHODS[1]
443
+ @session_manager.answer_plugin_ui(session_id: params.fetch("sessionId"), request_id: params.fetch("requestId"), value: params["value"])
424
444
  when TOOL_APPROVAL_METHODS[0]
425
445
  @session_manager.answer_tool_approval(session_id: params.fetch("sessionId"), approval_request_id: params.fetch("approvalRequestId"), approved: params.fetch("approved"))
426
446
  else
@@ -447,7 +467,8 @@ module Kward
447
467
  supportsToolCalls: true,
448
468
  supportsToolResults: true,
449
469
  supportsCompactionSummaries: true,
450
- supportsReasoningRestore: true
470
+ supportsReasoningRestore: true,
471
+ turnSummaries: { supported: true, event: "turnSummary", field: "turnSummary", modes: %w[off compact detailed], defaultMode: ConfigFiles.transcript_turn_stats, scope: "agentTurns" }
451
472
  },
452
473
  sessions: {
453
474
  mode: "explicit",
@@ -469,13 +490,32 @@ module Kward
469
490
  startMode: "cliOnly",
470
491
  entries: @transport_manager.list
471
492
  },
493
+ plugins: {
494
+ apiVersion: PluginRegistry::PLUGIN_API_VERSION,
495
+ identified: @session_manager.plugin_registry.plugins.map do |plugin|
496
+ { id: plugin.id, version: plugin.version, apiVersion: plugin.api_version }
497
+ end
498
+ },
499
+ pluginTools: {
500
+ supported: true,
501
+ registered: @session_manager.plugin_registry.tools.length,
502
+ discoveryMethod: TOOL_METHODS.first,
503
+ source: "plugin",
504
+ executionProfileFiltering: true,
505
+ permissionPolicy: true
506
+ },
472
507
  pluginChats: {
473
508
  supported: @plugin_chat_manager.supported_types.any?,
474
509
  methods: PLUGIN_CHAT_METHODS,
475
510
  notification: "pluginChat/event",
476
511
  subscriptions: { supported: true, methods: PLUGIN_CHAT_METHODS.values_at(3, 4), requiredForLiveEvents: true },
477
512
  attachments: { supported: true, method: PLUGIN_CHAT_METHODS[5], encoding: "base64", mimeTypes: SessionManager::RPC_IMAGE_MIME_TYPES, maxBytes: SessionManager::RPC_ATTACHMENT_MAX_BYTES },
478
- types: @plugin_chat_manager.supported_types.map { |type| { id: type.id, name: type.name, title: type.title, singleton: type.singleton, transport: type.transport == true ? true : nil }.compact }
513
+ types: @plugin_chat_manager.type_entries
514
+ },
515
+ generatedImages: {
516
+ supported: true, provider: "Codex", tool: "generate_image", readyEvent: "imageReady",
517
+ progress: "toolCall", methods: IMAGE_METHODS, fetchChunkBytes: GeneratedImages::FETCH_CHUNK_BYTES,
518
+ downloads: "clientLocal", persistence: "temporary"
479
519
  },
480
520
  turns: {
481
521
  mode: "async",
@@ -512,7 +552,9 @@ module Kward
512
552
  assistantText: "assistantDelta",
513
553
  reasoning: { start: false, delta: true, boundary: true, end: false },
514
554
  modelRetry: { supported: true, event: "modelRetry" },
555
+ turnSummary: { supported: true, event: "turnSummary", terminalField: "summary" },
515
556
  steering: { supported: @session_manager.in_flight_steer_supported?, event: "turnSteered", mode: @session_manager.in_flight_steer_supported? ? "native" : "unsupported" },
557
+ pluginCommands: { structuredResult: "pluginCommandResult" },
516
558
  tools: { call: true, update: true, result: true, normalizedMetadata: true, diffs: true, firstChangedLine: true, changedFiles: true, workspaceGuardrails: workspace_guardrails_enabled?, focusedContext: true, contextBudgetStats: true },
517
559
  errors: true,
518
560
  sessionUpdates: false
@@ -529,9 +571,16 @@ module Kward
529
571
  models: {
530
572
  supported: true,
531
573
  methods: MODEL_METHODS,
532
- fields: ["provider", "id", "name", "reasoning", "reasoningEffort", "contextWindow"],
574
+ fields: ["provider", "id", "name", "reasoning", "reasoningEffort", "contextWindow", "current", "defaultSelectable", "supportedParameters", "source"],
533
575
  scopedModels: false,
534
- refresh: { supported: true, method: MODEL_METHODS[4], providerParameter: true }
576
+ refresh: {
577
+ supported: true,
578
+ method: MODEL_METHODS[4],
579
+ providerParameter: true,
580
+ resultFields: ["models", "refresh"],
581
+ metadataFields: ["provider", "status", "fallbackUsed"],
582
+ statuses: ["success", "unsupported", "failed"]
583
+ }
535
584
  },
536
585
  runtime: {
537
586
  supported: true,
@@ -577,7 +626,31 @@ module Kward
577
626
  },
578
627
  memory: { supported: true, optIn: true, defaultEnabled: false, autoSummaryDefaultEnabled: false, promptInjection: "interactive", storage: { core: "json", soft: "jsonl", events: "jsonl" }, methods: MEMORY_METHODS },
579
628
  stability: { protocol: "stable", compatibility: "additive-fields-unless-protocol-version-changes", experimentalCapabilities: [] },
580
- commands: { supported: true, methods: COMMAND_METHODS, method: COMMAND_METHODS[0], runMethod: COMMAND_METHODS[1], sources: ["builtin", "prompt", "skill", "plugin"], executableSources: ["builtin", "plugin"] },
629
+ commands: {
630
+ supported: true,
631
+ methods: COMMAND_METHODS,
632
+ method: COMMAND_METHODS[0],
633
+ runMethod: COMMAND_METHODS[1],
634
+ sources: ["builtin", "prompt", "skill", "plugin"],
635
+ executableSources: ["builtin", "plugin"],
636
+ typedArguments: { supported: true, schema: "jsonSchemaObject", textSyntax: "shellFlags", legacyRawStrings: true },
637
+ structuredResults: true,
638
+ modelTurns: {
639
+ supported: true, method: "turns/start", synchronous: false,
640
+ inputRole: "system", codexInputRole: "developer", scope: "turn", maxSystemBytes: PluginTurnRequest::MAX_SYSTEM_BYTES,
641
+ pluginChats: false, pan: false
642
+ }
643
+ },
644
+ pluginActions: {
645
+ supported: true,
646
+ methods: PLUGIN_ACTION_METHODS,
647
+ registered: @session_manager.plugin_actions.length,
648
+ namespace: "pluginId/actionName",
649
+ arguments: "jsonSchemaObject",
650
+ structuredResults: true,
651
+ blockingUi: false,
652
+ localTui: false
653
+ },
581
654
  skillCapture: { supported: true, methods: SKILL_CAPTURE_METHODS, destination: "personal", source: "savedSessionActiveLeaf", reviewRequired: true, overwrite: "explicit", autoActivate: false },
582
655
  projectSkillTrust: { supported: false, trustRequired: true, reason: "RPC has no interactive trust decision bridge; project skills remain skipped unless globally enabled." },
583
656
  mcp: {
@@ -595,16 +668,18 @@ module Kward
595
668
  },
596
669
  startupResources: { supported: true, method: STARTUP_RESOURCE_METHODS.first },
597
670
  starterPack: { supported: false, reason: "cliOnlyInstallCommand" },
598
- shell: { supported: false, reason: "interactiveTuiOnly" },
671
+ shell: { supported: false, nativeScripting: false, history: false, lineEditing: false, programmableCompletion: false, promptFormat: false, mailNotifications: false, reason: "interactiveTuiOnly" },
599
672
  scratchpad: { supported: false, reason: "interactiveTuiOnly" },
600
673
  extensionUi: {
601
674
  question: { supported: true, notification: UI_QUESTION_NOTIFICATION, method: UI_METHODS.first, maxQuestions: 4, multiSelect: false, preview: false },
602
- select: false,
603
- confirm: false,
604
- input: false,
675
+ select: { supported: true, notification: UI_REQUEST_NOTIFICATION, method: UI_METHODS[1], maxOptions: PluginUI::MAX_OPTIONS },
676
+ confirm: { supported: true, notification: UI_REQUEST_NOTIFICATION, method: UI_METHODS[1] },
677
+ input: { supported: true, notification: UI_REQUEST_NOTIFICATION, method: UI_METHODS[1], maxBytes: PluginUI::MAX_TEXT_BYTES },
678
+ progress: { supported: true, notification: UI_PROGRESS_NOTIFICATION },
679
+ notify: { supported: true, notification: UI_NOTIFICATION, levels: PluginUI::NOTIFICATION_LEVELS.map(&:to_s) },
605
680
  editor: false,
606
681
  widgets: false,
607
- footer: { supported: true, notification: UI_FOOTER_NOTIFICATION },
682
+ footer: { supported: true, notification: UI_FOOTER_NOTIFICATION, segments: true, tooltip: true, priorities: PluginRegistry::STATUS_PRIORITIES.keys.map(&:to_s) },
608
683
  custom: false,
609
684
  terminalInput: false
610
685
  },
@@ -789,8 +864,12 @@ module Kward
789
864
  argumentHint: command.argument_hint,
790
865
  source: "plugin",
791
866
  path: command.path,
792
- executable: true
793
- }
867
+ pluginId: command.plugin_id,
868
+ executable: true,
869
+ typed: command.typed?,
870
+ schema: command.schema,
871
+ positionals: command.positionals
872
+ }.compact
794
873
  end
795
874
  { commands: builtins + prompts + skills + plugins }
796
875
  end
@@ -799,7 +878,29 @@ module Kward
799
878
  @session_manager.run_command(
800
879
  session_id: params.fetch("sessionId"),
801
880
  command: params.fetch("name"),
802
- arguments: params["arguments"] || ""
881
+ arguments: params.key?("arguments") ? params["arguments"] : ""
882
+ )
883
+ end
884
+
885
+ def plugin_actions_list(params)
886
+ @session_manager.runtime_state(session_id: params.fetch("sessionId"))
887
+ actions = @session_manager.plugin_actions.map do |action|
888
+ {
889
+ id: action.id,
890
+ name: action.name,
891
+ pluginId: action.plugin_id,
892
+ description: action.description,
893
+ schema: action.schema
894
+ }
895
+ end
896
+ { actions: actions }
897
+ end
898
+
899
+ def plugin_actions_run(params)
900
+ @session_manager.run_plugin_action(
901
+ session_id: params.fetch("sessionId"),
902
+ id: params.fetch("id"),
903
+ arguments: params.key?("arguments") ? params["arguments"] : {}
803
904
  )
804
905
  end
805
906
 
@@ -835,7 +936,7 @@ module Kward
835
936
  end
836
937
 
837
938
  def models_refresh(params)
838
- { models: @session_manager.refresh_models(provider: params["provider"]) }
939
+ @session_manager.refresh_models(provider: params["provider"], with_metadata: true)
839
940
  end
840
941
 
841
942
  def models_current