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,287 @@
1
+ require "io/console"
2
+ require "pty"
3
+ require "json"
4
+ require "socket"
5
+ require_relative "../terminal/ansi"
6
+ require_relative "../terminal/keys"
7
+ require_relative "../pty/adaptive_output_sink"
8
+ require_relative "../pty/transcript_normalizer"
9
+ require_relative "../cancellation"
10
+
11
+ module Kward
12
+ module NativeShell
13
+ # The inner PTY is the shell's controlling terminal; the launcher only
14
+ # relays bytes, resizes it, and retains a bounded pre-input snapshot.
15
+ class StandaloneTerminal
16
+ CHANNEL_FD = 30
17
+ CAPTURE_BYTES = 32_000
18
+ CHUNK_BYTES = 16_384
19
+ POLL_SECONDS = 0.05
20
+
21
+ def run(ruby_arguments, descriptors)
22
+ @lock = Mutex.new
23
+ @pending_input = +"".b
24
+ @null = File.open(File::NULL, "w")
25
+ @channel, child = UNIXSocket.pair
26
+ @channel.sync = true
27
+ @reader, @writer, @pid = PTY.spawn(terminal_defaults, *ruby_arguments, descriptors.merge(CHANNEL_FD => child))
28
+ child.close
29
+ @writer.sync = true
30
+ @reader.console_mode = $stdin.console_mode
31
+ resize
32
+ handlers = %w[HUP TERM INT].to_h do |signal|
33
+ [signal, Signal.trap(signal) { @signal = signal }]
34
+ end
35
+ $stdin.raw(intr: false) do
36
+ server = Thread.new { serve }
37
+ server.report_on_exception = false
38
+ begin
39
+ relay
40
+ ensure
41
+ @channel.shutdown rescue nil
42
+ server.kill
43
+ server.join
44
+ end
45
+ end
46
+ @reader.close
47
+ @writer.close
48
+ reap_child
49
+ @status&.exitstatus || (@status&.termsig && 128 + @status.termsig) || 1
50
+ ensure
51
+ handlers&.each { |signal, handler| Signal.trap(signal, handler) }
52
+ [@reader, @writer, @channel, child, @null].compact.each { |io| io.close unless io.closed? }
53
+ reap_child
54
+ end
55
+
56
+ private
57
+
58
+ def terminal_defaults
59
+ defaults = color_defaults
60
+ # Git's default LESS=FRX disables alternate-screen restoration (-X).
61
+ defaults["LESS"] = "FR" unless ENV.key?("LESS") || ENV["TERM"] == "dumb"
62
+ defaults
63
+ end
64
+
65
+ def color_defaults
66
+ return {} if ENV["TERM"] == "dumb" || !ANSI.enabled?
67
+
68
+ defaults = {}
69
+ defaults["CLICOLOR"] = "1" unless ENV.key?("CLICOLOR")
70
+ defaults["COLORTERM"] = "truecolor" unless ENV.key?("COLORTERM")
71
+ defaults["TERM"] = "xterm-256color" if ENV["TERM"].to_s.empty?
72
+ defaults
73
+ end
74
+
75
+ def relay
76
+ loop do
77
+ resize
78
+ if @signal
79
+ Process.kill(@signal, @pid) rescue nil
80
+ break if @signal == "HUP"
81
+ @signal = nil
82
+ end
83
+ readers = [@reader]
84
+ readers << $stdin if @pending_input.bytesize < CHUNK_BYTES
85
+ writers = [@writer] unless @pending_input.empty?
86
+ ready = IO.select(readers, writers, nil, POLL_SECONDS)
87
+ @lock.synchronize { drain_output(1) } if ready&.first&.include?(@reader)
88
+ forward_input if ready&.first&.include?($stdin)
89
+ @lock.synchronize { flush_input } if ready&.[](1)&.include?(@writer)
90
+ _, @status = Process.waitpid2(@pid, Process::WNOHANG)
91
+ break if @status
92
+ end
93
+ rescue EOFError, Errno::EIO, Errno::EPIPE
94
+ # Closing the PTY or its real terminal ends the relay.
95
+ ensure
96
+ @lock.synchronize { drain_output } rescue nil
97
+ end
98
+
99
+ def reap_child
100
+ return unless @pid && !@status
101
+
102
+ # EOF from a fast exec can precede its wait status. Give it a chance
103
+ # to exit normally before falling back to cleanup after terminal loss.
104
+ 10.times do
105
+ _, @status = Process.waitpid2(@pid, Process::WNOHANG)
106
+ return if @status
107
+ sleep 0.01
108
+ end
109
+ Process.kill("KILL", @pid)
110
+ _, @status = Process.waitpid2(@pid)
111
+ rescue Errno::ESRCH, Errno::ECHILD
112
+ nil
113
+ end
114
+
115
+ def resize
116
+ size = $stdin.winsize
117
+ return if size == @size || size.any?(&:zero?)
118
+
119
+ @reader.winsize = size
120
+ @size = size
121
+ rescue Errno::EIO
122
+ nil
123
+ end
124
+
125
+ def forward_input
126
+ bytes = $stdin.read_nonblock(CHUNK_BYTES, exception: false)
127
+ raise EOFError unless bytes
128
+ return if bytes == :wait_readable
129
+
130
+ cancellation, running = @lock.synchronize do
131
+ if @cancellation
132
+ [@cancellation, @agent_running]
133
+ else
134
+ drain_output
135
+ @capture&.input_forwarded
136
+ @pending_input << bytes
137
+ [nil, nil]
138
+ end
139
+ end
140
+ return unless cancellation && bytes.include?(TerminalKeys::CTRL_C)
141
+
142
+ cancellation.cancel!
143
+ Process.kill("INT", @pid) if running
144
+ end
145
+
146
+ def flush_input
147
+ return if @pending_input.empty?
148
+
149
+ # A full slave input queue must not block relaying command output.
150
+ length = @writer.write_nonblock(@pending_input, exception: false)
151
+ @pending_input = @pending_input.byteslice(length..) if length.is_a?(Integer)
152
+ end
153
+
154
+ def drain_output(limit = 64)
155
+ limit.times do
156
+ chunk = @reader.read_nonblock(CHUNK_BYTES, exception: false)
157
+ break unless chunk.is_a?(String)
158
+
159
+ write_terminal(chunk)
160
+ @capture&.write(chunk)
161
+ end
162
+ rescue Errno::EIO
163
+ nil
164
+ end
165
+
166
+ def write_terminal(bytes)
167
+ $stdout.write(bytes)
168
+ $stdout.flush
169
+ @at_line_start = bytes.end_with?("\n")
170
+ end
171
+
172
+ def start_capture
173
+ @capture = AdaptivePtyOutputSink.new(output: @null, on_exclusive: -> {}, max_capture_bytes: CAPTURE_BYTES)
174
+ end
175
+
176
+ def stop_capture
177
+ drain_output
178
+ sink, @capture = @capture, nil
179
+ sink.finish
180
+ return "" unless sink.transcript_safe? && !sink.preserve_terminal_view?
181
+
182
+ raw = ANSI.normalize_transcript_encoding(sink.captured_output).gsub("\r\n", "\n")
183
+ PtyTranscriptNormalizer.normalize(raw, columns: @size&.last || 80, max_bytes: CAPTURE_BYTES).to_s
184
+ end
185
+
186
+ def serve
187
+ while (line = @channel.gets)
188
+ message = JSON.parse(line)
189
+ case message.fetch("type")
190
+ when "ready"
191
+ respond("ok")
192
+ when "begin"
193
+ @lock.synchronize do
194
+ drain_output
195
+ @last_command = message.fetch("command")
196
+ start_capture
197
+ @capture.input_forwarded if message["input_pending"] || !@pending_input.empty?
198
+ end
199
+ respond("ok")
200
+ when "finish"
201
+ @lock.synchronize do
202
+ @last_output = stop_capture
203
+ @status_of_command = message.fetch("status")
204
+ end
205
+ respond("ok")
206
+ when "clear_context"
207
+ @lock.synchronize { @capture = @last_command = @last_output = @status_of_command = nil }
208
+ respond("ok")
209
+ when "ask" then answer(message)
210
+ end
211
+ end
212
+ rescue EOFError, Errno::EPIPE, IOError
213
+ nil
214
+ ensure
215
+ @channel.shutdown rescue nil
216
+ end
217
+
218
+ def answer(message)
219
+ @cwd = message.fetch("cwd")
220
+ @lock.synchronize do
221
+ @pending_input = +"".b
222
+ @cancellation = Cancellation.new
223
+ end
224
+ require_relative "standalone_agent"
225
+ @agent ||= StandaloneAgent.new
226
+ text, draft = @agent.ask(message.fetch("instruction"), self, cancellation: @cancellation)
227
+ @cancellation.raise_if_cancelled!
228
+ finish_answer(ANSI.sanitize_transcript(text), draft: draft)
229
+ rescue Cancellation::CancelledError
230
+ finish_answer("Canceled.")
231
+ rescue LoadError, StandardError => e
232
+ finish_answer(ANSI.sanitize_transcript("Shell agent: #{e.message}"))
233
+ end
234
+
235
+ def finish_answer(text, draft: nil)
236
+ @lock.synchronize do
237
+ @cancellation = nil
238
+ respond("answer", text: text, draft: draft)
239
+ end
240
+ end
241
+
242
+ def respond(type, **data)
243
+ @channel.puts(JSON.generate(data.merge(type: type)))
244
+ end
245
+
246
+ public
247
+
248
+ attr_reader :cwd
249
+
250
+ def context_snapshot
251
+ { cwd: @cwd, last_command: @last_command, last_output: @last_output, exit_status: @status_of_command }
252
+ end
253
+
254
+ def timeout_seconds
255
+ Kwsh::DEFAULT_TIMEOUT_SECONDS
256
+ end
257
+
258
+ def run_for_agent(command, timeout_seconds: nil, cancellation: nil)
259
+ cancellation&.raise_if_cancelled!
260
+ respond("run", command: command, timeout: timeout_seconds || self.timeout_seconds)
261
+ JSON.parse(@channel.readline).fetch("type") == "running" or raise IOError, "Shell agent command did not start"
262
+ @lock.synchronize do
263
+ drain_output
264
+ start_capture
265
+ @agent_running = true
266
+ respond("ok")
267
+ end
268
+ Process.kill("INT", @pid) if cancellation&.cancelled?
269
+ result = JSON.parse(@channel.readline)
270
+ @cwd = result.fetch("cwd")
271
+ output = @lock.synchronize do
272
+ captured = stop_capture
273
+ write_terminal("\r\n") unless @at_line_start
274
+ captured
275
+ end
276
+ @last_command, @last_output, @status_of_command = command, output, result.fetch("status")
277
+ cancellation&.raise_if_cancelled!
278
+ Kwsh::Result.new(output: output, exit_status: @status_of_command)
279
+ ensure
280
+ @lock.synchronize do
281
+ @agent_running = false
282
+ @capture = nil
283
+ end
284
+ end
285
+ end
286
+ end
287
+ end
@@ -1,7 +1,7 @@
1
1
  require "digest"
2
2
  require "json"
3
3
  require "pathname"
4
- require_relative "../path_guard"
4
+ require_relative "../workspace/path_guard"
5
5
  require_relative "../private_file"
6
6
 
7
7
  # Namespace for Agent Skills discovery and trust management.
@@ -0,0 +1,194 @@
1
+ require "digest"
2
+ require "logger"
3
+ require_relative "../config_files"
4
+ require_relative "../deep_copy"
5
+ require_relative "../plugins/chat_contract"
6
+ require_relative "../plugins/host"
7
+ require_relative "../plugins/resources"
8
+
9
+ # Namespace for the Kward CLI agent runtime.
10
+ module Kward
11
+ # Adapts a session-backed agent to the tab runtime interface. Plugin tab
12
+ # drivers implement the same small surface without becoming Kward sessions.
13
+ class SessionTabDriver
14
+ attr_reader :session, :agent, :worktree
15
+
16
+ def initialize(session:, agent:, worktree: nil)
17
+ @session = session
18
+ @agent = agent
19
+ @worktree = worktree
20
+ end
21
+
22
+ def messages
23
+ agent.conversation.messages
24
+ end
25
+
26
+ def conversation
27
+ agent.conversation
28
+ end
29
+
30
+ def submit(input, display_input:, cancellation:, steering: nil, &block)
31
+ options = { cancellation: cancellation }
32
+ options[:display_input] = display_input unless display_input.nil?
33
+ options[:steering] = steering if steering
34
+ agent.ask(input, **options, &block)
35
+ end
36
+
37
+ def descriptor
38
+ descriptor = { "kind" => "session", "session_path" => session.path }
39
+ descriptor["worktree"] = worktree.descriptor if worktree
40
+ descriptor
41
+ end
42
+
43
+ def session?
44
+ true
45
+ end
46
+
47
+ def supports_steering?
48
+ true
49
+ end
50
+
51
+ def assistant_label
52
+ nil
53
+ end
54
+ end
55
+
56
+ # Represents a persisted plugin tab whose provider plugin is unavailable.
57
+ # Its descriptor is retained so reinstalling the plugin restores the tab.
58
+ class UnavailableTabDriver
59
+ attr_reader :descriptor
60
+
61
+ def initialize(descriptor:, message:)
62
+ @descriptor = descriptor
63
+ @message = message
64
+ end
65
+
66
+ def messages
67
+ [{ role: "assistant", content: @message }]
68
+ end
69
+
70
+ def submit(*)
71
+ raise @message
72
+ end
73
+
74
+ def session?
75
+ false
76
+ end
77
+
78
+ def supports_steering?
79
+ false
80
+ end
81
+
82
+ def assistant_label
83
+ "Plugin"
84
+ end
85
+ end
86
+
87
+ # Dependencies and instance-scoped services made available to a plugin chat
88
+ # factory without exposing CLI or workspace-session internals.
89
+ class PluginTabHost
90
+ SURFACES = %i[local rpc transport shared].freeze
91
+
92
+ class LogDevice
93
+ def write(message)
94
+ ConfigFiles.emit_warning(message.to_s.chomp)
95
+ end
96
+
97
+ def close
98
+ nil
99
+ end
100
+ end
101
+ private_constant :LogDevice
102
+
103
+ attr_reader :client, :workspace_root, :plugin_id, :type_id, :surface, :scope_key,
104
+ :capabilities, :config, :storage, :logger
105
+
106
+ def initialize(client:, workspace_root:, plugin_host: nil, type_id: nil, surface: :local, scope_key: "default", capabilities: nil, config: nil, storage: nil, logger: nil, env: ENV)
107
+ @client = client
108
+ @workspace_root = workspace_root
109
+ @plugin_id = plugin_host&.id
110
+ @type_id = required_value(type_id || @plugin_id || "anonymous", "plugin chat type id").freeze
111
+ @surface = normalize_surface(surface)
112
+ @scope_key = required_value(scope_key, "plugin chat scope key").freeze
113
+ @capabilities = capabilities || PluginChatCapabilities.legacy
114
+ @config = freeze_config(config || plugin_host&.config || ConfigFiles.plugin_config(storage_owner_id))
115
+ @storage = PluginScopedStore.new(storage || plugin_host&.storage || default_storage, storage_namespace)
116
+ @logger = logger || plugin_host&.logger || default_logger
117
+ @env = env
118
+ @resources = PluginResources.new(name: "Kward plugin chat #{@type_id}", warning_sink: ConfigFiles.warning_sink).tap(&:activate!)
119
+ end
120
+
121
+ # Starts cooperative background work owned by this chat instance.
122
+ def background(name: nil, cancellation: nil, &block)
123
+ @resources.background(name: name, cancellation: cancellation, &block)
124
+ end
125
+
126
+ # Registers cleanup that runs when the chat instance closes.
127
+ def on_cleanup(resource = nil, &block)
128
+ @resources.on_cleanup(resource, &block)
129
+ end
130
+
131
+ alias manage on_cleanup
132
+
133
+ # Reads a secret from private plugin config, an explicit environment
134
+ # variable, or the plugin's conventional KWARD_PLUGIN_* variable.
135
+ def secret(key, env: nil)
136
+ key = required_value(key, "secret key")
137
+ value = config[key]
138
+ value = @env[env.to_s] if value.nil? && env
139
+ value = @env[default_secret_env_name(key)] if value.nil?
140
+ value.to_s unless value.nil?
141
+ end
142
+
143
+ # Cancels chat-owned work and invokes cleanup callbacks.
144
+ # @api private
145
+ def shutdown(timeout: PluginResources::DEFAULT_SHUTDOWN_TIMEOUT)
146
+ @resources.shutdown(timeout: timeout)
147
+ self
148
+ end
149
+
150
+ private
151
+
152
+ def storage_owner_id
153
+ plugin_id || type_id
154
+ end
155
+
156
+ def storage_namespace
157
+ "plugin_chat:#{type_id}:#{scope_key}"
158
+ end
159
+
160
+ def default_storage
161
+ safe_id = "chat.#{Digest::SHA256.hexdigest(storage_owner_id)[0, 24]}"
162
+ PluginStore.new(safe_id)
163
+ end
164
+
165
+ def freeze_config(value)
166
+ raise ArgumentError, "Kward plugin config for #{storage_owner_id} must be an object" unless value.is_a?(Hash)
167
+
168
+ DeepCopy.freeze(DeepCopy.dup(value))
169
+ end
170
+
171
+ def normalize_surface(value)
172
+ surface = value.to_sym
173
+ raise ArgumentError, "Unknown plugin chat surface: #{value}" unless SURFACES.include?(surface)
174
+
175
+ surface
176
+ end
177
+
178
+ def required_value(value, name)
179
+ value = value.to_s
180
+ raise ArgumentError, "#{name} is required" if value.empty?
181
+
182
+ value
183
+ end
184
+
185
+ def default_secret_env_name(key)
186
+ parts = [storage_owner_id, key].map { |part| part.gsub(/[^A-Za-z0-9]/, "_").upcase }
187
+ "KWARD_PLUGIN_#{parts.join("_")}"
188
+ end
189
+
190
+ def default_logger
191
+ Logger.new(LogDevice.new).tap { |logger| logger.progname = "Kward plugin chat #{type_id}" }
192
+ end
193
+ end
194
+ end
@@ -1,7 +1,7 @@
1
1
  require "digest"
2
2
  require "json"
3
- require_relative "config_files"
4
- require_relative "private_file"
3
+ require_relative "../config_files"
4
+ require_relative "../private_file"
5
5
 
6
6
  # Namespace for the Kward CLI agent runtime.
7
7
  module Kward
@@ -1,5 +1,5 @@
1
1
  require "open3"
2
- require_relative "terminal_sequences"
2
+ require_relative "sequences"
3
3
  require "rbconfig"
4
4
 
5
5
  # Namespace for the Kward CLI agent runtime.
@@ -1,4 +1,4 @@
1
- require_relative "terminal_sequences"
1
+ require_relative "sequences"
2
2
 
3
3
  # Namespace for the Kward CLI agent runtime.
4
4
  module Kward
@@ -2,6 +2,7 @@
2
2
  module Kward
3
3
  # Terminal input key byte sequences grouped by semantic key.
4
4
  module TerminalKeys
5
+ ESCAPE = "\e".freeze
5
6
  CTRL_SPACE = "\x00".freeze
6
7
  CTRL_A = "\x01".freeze
7
8
  CTRL_B = "\x02".freeze
@@ -9,6 +10,7 @@ module Kward
9
10
  CTRL_D = "\x04".freeze
10
11
  CTRL_E = "\x05".freeze
11
12
  CTRL_F = "\x06".freeze
13
+ CTRL_G = "\x07".freeze
12
14
  CTRL_H = "\x08".freeze
13
15
  CTRL_J = "\x0A".freeze
14
16
  CTRL_K = "\x0B".freeze
@@ -26,6 +28,7 @@ module Kward
26
28
  CTRL_Y = "\x19".freeze
27
29
  CTRL_Z = "\x1A".freeze
28
30
  CTRL_PERIOD = "\x1E".freeze
31
+ CTRL_UNDERSCORE = "\x1F".freeze
29
32
 
30
33
  RETURN = ["\n", "\r"].freeze
31
34
  BACKSPACE = ["\b", "\x7F"].freeze
@@ -46,6 +49,12 @@ module Kward
46
49
  CTRL_SHIFT_TAB = ["\e[9;6u", "\e[27;6;9~", "\e[1;6I", "\e[1;6Z"].freeze
47
50
  SHIFT_ENTER = ["\e[13;2u", "\e[13;2~", "\e[27;2;13~", "\e\r", "\e\n"].freeze
48
51
 
52
+ ALT_B = ["\eb", "\eB"].freeze
53
+ ALT_D = ["\ed", "\eD"].freeze
54
+ ALT_F = ["\ef", "\eF"].freeze
55
+ ALT_Y = ["\ey", "\eY"].freeze
56
+ ALT_LAST_WORD = ["\e.", "\e_"].freeze
57
+ ALT_BACKSPACE = ["\e\b", "\e\x7F"].freeze
49
58
  ALT_LEFT = ["\e[1;3D", "\e[3D"].freeze
50
59
  ALT_RIGHT = ["\e[1;3C", "\e[3C"].freeze
51
60
  ALT_UP = ["\e[1;3A", "\e[3A"].freeze
@@ -70,12 +79,15 @@ module Kward
70
79
  CTRL_SHIFT_UP = ["\e[1;6A", "\e[6A"].freeze
71
80
  CTRL_SHIFT_DOWN = ["\e[1;6B", "\e[6B"].freeze
72
81
 
82
+ CTRL_N_MODIFY_OTHER_KEYS = "\e[27;5;110~".freeze
73
83
  CTRL_T_CSI_U = "\e[116;5u".freeze
84
+ CTRL_SHIFT_T_CSI_U = ["\e[116;6u", "\e[84;6u"].freeze
74
85
  CTRL_W_CSI_U = "\e[119;5u".freeze
75
86
  CTRL_NUMBER_TAB_PATTERN = /\A\e\[((?:49)|(?:5[0-7]));5u\z/.freeze
76
87
  TAB_ACTION_SEQUENCES = (
77
88
  CTRL_TAB +
78
89
  CTRL_SHIFT_TAB +
90
+ CTRL_SHIFT_T_CSI_U +
79
91
  [CTRL_T, CTRL_T_CSI_U, CTRL_W_CSI_U] +
80
92
  (49..57).map { |code| "\e[#{code};5u" } +
81
93
  ["\et", "\eT"] +
@@ -84,7 +96,16 @@ module Kward
84
96
  (1..9).map { |number| "\e#{number}" }
85
97
  ).freeze
86
98
 
87
- CSI_U_PATTERN = /\A\e\[(\d+)((?:;[\d:]*)*)u/.freeze
99
+ CSI_U_MODIFIER_KEY_CODES = (57441..57454).freeze
100
+ CSI_U_PATTERN = /\A\e\[(\d+)(?::[\d:]*)?((?:;[\d:]*)*)u/.freeze
101
+ CSI_SEQUENCE_PATTERN = /\A\e\[[0-?]*[ -\/]*[@-~]/.freeze
102
+ CSI_PREFIX_PATTERN = /\A\e\[[0-?]*[ -\/]*\z/.freeze
103
+ MODIFY_OTHER_KEYS_PATTERN = /\A\e\[27;(\d+);(\d+)~\z/.freeze
104
+ HANDOFF_ESCAPE_DELAY = 0.03
105
+ LEGACY_CTRL_CODES = { 32 => 0, 50 => 0, 51 => 27, 52 => 28, 53 => 29, 54 => 30, 55 => 31,
106
+ 56 => 127, 47 => 31, 63 => 127, 64 => 0, 91 => 27, 92 => 28, 93 => 29,
107
+ 94 => 30, 95 => 31, 126 => 30 }.freeze
108
+ MAX_HANDOFF_SEQUENCE_BYTES = 4096
88
109
  MODIFIED_CURSOR_PATTERN = /\A\e\[(\d+);(\d+)([CDFH])\z/.freeze
89
110
  MODIFIED_DELETE_PATTERN = /\A\e\[3;(\d+)~\z/.freeze
90
111
  UP_PATTERN = /\A\e\[[0-9;:]*A\z/.freeze
@@ -0,0 +1,29 @@
1
+ require "fiddle"
2
+
3
+ module Kward
4
+ module TerminalText
5
+ # Standalone native shells use a scoped libc locale rather than the TUI's
6
+ # Unicode gem. Call only inside NativeShell::Locale.with; never setlocale.
7
+ LOCALE_WCWIDTH = Fiddle::Function.new(Fiddle::Handle::DEFAULT["wcwidth"], [Fiddle::TYPE_INT], Fiddle::TYPE_INT)
8
+
9
+ def self.locale_cells(text)
10
+ text.each_char.map do |character|
11
+ begin
12
+ codepoint = character.encode(Encoding::UTF_8).ord
13
+ width = LOCALE_WCWIDTH.call(codepoint)
14
+ if codepoint < 32 || codepoint == 127
15
+ ["^#{(codepoint ^ 64).chr}", 2]
16
+ elsif width >= 0
17
+ [character, width]
18
+ else
19
+ escaped = "\\u{#{codepoint.to_s(16)}}"
20
+ [escaped, escaped.length]
21
+ end
22
+ rescue EncodingError
23
+ escaped = character.bytes.map { |byte| format('\\x%02x', byte) }.join
24
+ [escaped, escaped.length]
25
+ end
26
+ end
27
+ end
28
+ end
29
+ end