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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +164 -0
- data/CONTRIBUTING.md +1 -1
- data/Gemfile.lock +6 -2
- data/README.md +5 -5
- data/Rakefile +3 -0
- data/doc/agent-tools.md +24 -1
- data/doc/api.md +20 -2
- data/doc/composer.md +5 -4
- data/doc/configuration.md +86 -14
- data/doc/extensibility.md +4 -1
- data/doc/getting-started.md +3 -3
- data/doc/git.md +4 -2
- data/doc/memory.md +1 -1
- data/doc/pan.md +6 -0
- data/doc/permissions.md +4 -4
- data/doc/plugins.md +504 -20
- data/doc/providers.md +10 -4
- data/doc/rpc.md +279 -23
- data/doc/sandboxing.md +11 -5
- data/doc/security.md +7 -1
- data/doc/session-management.md +41 -5
- data/doc/shell.md +643 -27
- data/doc/tabs.md +8 -3
- data/doc/transports.md +15 -0
- data/doc/troubleshooting.md +1 -1
- data/doc/usage.md +25 -12
- data/doc/workspace-tools.md +9 -0
- data/examples/plugins/openrouter_proxy/README.md +103 -0
- data/examples/plugins/openrouter_proxy/fake_embeddings.rb +85 -0
- data/examples/plugins/openrouter_proxy/plugin.rb +7 -0
- data/examples/plugins/openrouter_proxy/protocol.rb +202 -0
- data/examples/plugins/openrouter_proxy/server.rb +186 -0
- data/examples/plugins/space_invaders.rb +1 -2
- data/examples/plugins/stardate_footer.rb +2 -2
- data/examples/plugins/telegram/plugin.rb +1 -1
- data/exe/kward +2 -2
- data/exe/kwsh +7 -0
- data/kward.gemspec +3 -1
- data/lib/kward/agent.rb +66 -19
- data/lib/kward/cli/commands.rb +41 -11
- data/lib/kward/cli/compaction.rb +9 -3
- data/lib/kward/cli/interactive_turn.rb +10 -0
- data/lib/kward/cli/plugins.rb +85 -12
- data/lib/kward/cli/prompt_interface.rb +29 -6
- data/lib/kward/cli/rendering.rb +24 -28
- data/lib/kward/cli/runtime_helpers.rb +168 -56
- data/lib/kward/cli/sessions.rb +9 -5
- data/lib/kward/cli/settings/menus.rb +745 -0
- data/lib/kward/cli/settings/model.rb +316 -0
- data/lib/kward/cli/settings.rb +6 -1055
- data/lib/kward/cli/slash_commands.rb +45 -4
- data/lib/kward/cli/tabs.rb +257 -44
- data/lib/kward/cli/tool_summaries.rb +2 -0
- data/lib/kward/{cli_transcript_formatter.rb → cli/transcript_formatter.rb} +6 -13
- data/lib/kward/cli/worktrees.rb +66 -2
- data/lib/kward/cli.rb +82 -31
- data/lib/kward/compactor.rb +18 -7
- data/lib/kward/config/core.rb +400 -0
- data/lib/kward/config/extensions.rb +99 -0
- data/lib/kward/config/paths.rb +11 -0
- data/lib/kward/config/prompts.rb +313 -0
- data/lib/kward/config/settings.rb +257 -0
- data/lib/kward/config_files.rb +14 -1008
- data/lib/kward/conversation.rb +41 -2
- data/lib/kward/entrypoint.rb +14 -0
- data/lib/kward/events.rb +2 -0
- data/lib/kward/generated_images.rb +237 -0
- data/lib/kward/image_attachments.rb +1 -1
- data/lib/kward/model/catalog.rb +6 -3
- data/lib/kward/model/client.rb +107 -38
- data/lib/kward/model/codex_images.rb +83 -0
- data/lib/kward/model/copilot_models.rb +10 -6
- data/lib/kward/model/model_info.rb +42 -7
- data/lib/kward/{openrouter_model_cache.rb → model/openrouter_model_cache.rb} +7 -5
- data/lib/kward/model/payloads.rb +18 -8
- data/lib/kward/model/sources.rb +3 -1
- data/lib/kward/model/stream_parser.rb +4 -7
- data/lib/kward/model/typesafe_client.rb +78 -0
- data/lib/kward/pan/index.html.erb +8 -1
- data/lib/kward/pan/server.rb +23 -8
- data/lib/kward/permissions/policy.rb +6 -2
- data/lib/kward/plugin_registry.rb +2 -659
- data/lib/kward/plugins/actions.rb +453 -0
- data/lib/kward/plugins/chat_contract.rb +121 -0
- data/lib/kward/{plugin_chat_runtime.rb → plugins/chat_runtime.rb} +62 -18
- data/lib/kward/plugins/codex_responses.rb +73 -0
- data/lib/kward/plugins/host.rb +248 -0
- data/lib/kward/plugins/http_server.rb +83 -0
- data/lib/kward/plugins/registry.rb +1229 -0
- data/lib/kward/plugins/resources.rb +206 -0
- data/lib/kward/plugins/turn_request.rb +36 -0
- data/lib/kward/plugins/ui.rb +219 -0
- data/lib/kward/prompt_interface/composer_controller.rb +0 -1
- data/lib/kward/prompt_interface/composer_renderer.rb +160 -73
- data/lib/kward/prompt_interface/composer_state.rb +1 -1
- data/lib/kward/prompt_interface/editor/controller.rb +2 -2
- data/lib/kward/prompt_interface/editor/renderer.rb +10 -7
- data/lib/kward/prompt_interface/editor/runner.rb +1 -1
- data/lib/kward/prompt_interface/editor/state.rb +1 -1
- data/lib/kward/prompt_interface/file_overlay.rb +3 -3
- data/lib/kward/prompt_interface/generated_image_preview.rb +162 -0
- data/lib/kward/prompt_interface/git_prompt.rb +18 -11
- data/lib/kward/prompt_interface/interactive/renderer.rb +1 -1
- data/lib/kward/prompt_interface/interactive/state.rb +18 -20
- data/lib/kward/prompt_interface/key_handler.rb +108 -25
- data/lib/kward/prompt_interface/layout.rb +11 -1
- data/lib/kward/prompt_interface/overlay_renderer.rb +26 -9
- data/lib/kward/prompt_interface/plugin_ui_requests.rb +82 -0
- data/lib/kward/prompt_interface/project_browser.rb +27 -54
- data/lib/kward/prompt_interface/prompt_renderer.rb +27 -35
- data/lib/kward/prompt_interface/question_prompt.rb +19 -28
- data/lib/kward/prompt_interface/runtime_state.rb +37 -10
- data/lib/kward/prompt_interface/screen.rb +30 -20
- data/lib/kward/prompt_interface/selection_prompt.rb +8 -8
- data/lib/kward/prompt_interface/slash_overlay.rb +1 -1
- data/lib/kward/prompt_interface/transcript_renderer.rb +7 -6
- data/lib/kward/prompt_interface.rb +149 -30
- data/lib/kward/prompts/commands.rb +2 -1
- data/lib/kward/prompts.rb +7 -1
- data/lib/kward/{adaptive_pty_output_sink.rb → pty/adaptive_output_sink.rb} +39 -5
- data/lib/kward/{interactive_pty_runner.rb → pty/interactive_runner.rb} +22 -30
- data/lib/kward/{local_command_runner.rb → pty/local_command_runner.rb} +1 -1
- data/lib/kward/{local_pty_command_runner.rb → pty/local_pty_runner.rb} +3 -9
- data/lib/kward/{pty_output_sink.rb → pty/output_sink.rb} +9 -4
- data/lib/kward/pty/transcript_normalizer.rb +137 -0
- data/lib/kward/rpc/config_manager.rb +3 -0
- data/lib/kward/rpc/plugin_chat_manager.rb +30 -10
- data/lib/kward/rpc/prompt_bridge.rb +25 -0
- data/lib/kward/rpc/server.rb +118 -17
- data/lib/kward/rpc/session_manager.rb +208 -60
- data/lib/kward/rpc/session_tree_rows.rb +2 -2
- data/lib/kward/rpc/tool_metadata.rb +1 -1
- data/lib/kward/rpc/transcript_normalizer.rb +11 -7
- data/lib/kward/sandbox/command_runner.rb +1 -1
- data/lib/kward/{session_catalog.rb → sessions/catalog.rb} +1 -1
- data/lib/kward/{session_store.rb → sessions/store.rb} +39 -12
- data/lib/kward/{session_tree_nodes.rb → sessions/tree_nodes.rb} +3 -3
- data/lib/kward/{session_tree_renderer.rb → sessions/tree_renderer.rb} +4 -4
- data/lib/kward/{session_tree_tool_display.rb → sessions/tree_tool_display.rb} +1 -1
- data/lib/kward/{kwsh.rb → shell/kwsh.rb} +30 -10
- data/lib/kward/{kwshrc.rb → shell/kwshrc.rb} +11 -2
- data/lib/kward/shell/native_arithmetic.rb +255 -0
- data/lib/kward/shell/native_arrays.rb +102 -0
- data/lib/kward/shell/native_braces.rb +96 -0
- data/lib/kward/shell/native_builtins.rb +476 -0
- data/lib/kward/shell/native_completion.rb +169 -0
- data/lib/kward/shell/native_condition.rb +75 -0
- data/lib/kward/shell/native_directory.rb +116 -0
- data/lib/kward/shell/native_exec_state.rb +73 -0
- data/lib/kward/shell/native_expansion.rb +252 -0
- data/lib/kward/shell/native_fields.rb +62 -0
- data/lib/kward/shell/native_glob.rb +96 -0
- data/lib/kward/shell/native_history.rb +242 -0
- data/lib/kward/shell/native_interactive.rb +164 -0
- data/lib/kward/shell/native_invocation.rb +42 -0
- data/lib/kward/shell/native_jobs.rb +250 -0
- data/lib/kward/shell/native_line_editor.rb +382 -0
- data/lib/kward/shell/native_line_terminal.rb +286 -0
- data/lib/kward/shell/native_locale.rb +109 -0
- data/lib/kward/shell/native_locals.rb +57 -0
- data/lib/kward/shell/native_pattern.rb +200 -0
- data/lib/kward/shell/native_process.rb +279 -0
- data/lib/kward/shell/native_program.rb +40 -0
- data/lib/kward/shell/native_programmable_completion.rb +115 -0
- data/lib/kward/shell/native_prompt_format.rb +89 -0
- data/lib/kward/shell/native_runtime.rb +964 -0
- data/lib/kward/shell/native_substitution.rb +110 -0
- data/lib/kward/shell/native_syntax.rb +946 -0
- data/lib/kward/shell/native_traps.rb +196 -0
- data/lib/kward/shell/native_vi.rb +407 -0
- data/lib/kward/shell/native_vi_terminal.rb +19 -0
- data/lib/kward/shell/native_worker.rb +82 -0
- data/lib/kward/{persistent_shell_session.rb → shell/persistent_session.rb} +187 -193
- data/lib/kward/shell/prompt.rb +66 -0
- data/lib/kward/shell/prompt_agent.rb +17 -0
- data/lib/kward/{shell_prompt_session.rb → shell/prompt_session.rb} +1 -1
- data/lib/kward/shell/script_runner.rb +244 -0
- data/lib/kward/shell/standalone_agent.rb +31 -0
- data/lib/kward/shell/standalone_link.rb +78 -0
- data/lib/kward/shell/standalone_terminal.rb +287 -0
- data/lib/kward/skills/trust_store.rb +1 -1
- data/lib/kward/tabs/driver.rb +194 -0
- data/lib/kward/{tab_store.rb → tabs/store.rb} +2 -2
- data/lib/kward/{clipboard.rb → terminal/clipboard.rb} +1 -1
- data/lib/kward/{terminal_image_support.rb → terminal/image_support.rb} +1 -1
- data/lib/kward/{terminal_keys.rb → terminal/keys.rb} +22 -1
- data/lib/kward/terminal/locale_text.rb +29 -0
- data/lib/kward/{terminal_sequences.rb → terminal/sequences.rb} +45 -4
- data/lib/kward/tools/base.rb +18 -0
- data/lib/kward/tools/context_for_task.rb +15 -6
- data/lib/kward/tools/datetime.rb +85 -0
- data/lib/kward/tools/edit_file.rb +9 -6
- data/lib/kward/tools/generate_image.rb +36 -0
- data/lib/kward/tools/git_commit.rb +13 -7
- data/lib/kward/tools/list_directory.rb +4 -4
- data/lib/kward/tools/plugin_tool.rb +41 -0
- data/lib/kward/tools/prepare_shell_command.rb +1 -1
- data/lib/kward/tools/read_file.rb +7 -6
- data/lib/kward/tools/registry.rb +130 -21
- data/lib/kward/tools/run_shell_command.rb +10 -8
- data/lib/kward/tools/search/code.rb +1 -1
- data/lib/kward/tools/summarize_file_structure.rb +5 -5
- data/lib/kward/tools/tool_call.rb +4 -1
- data/lib/kward/tools/typesafe_evaluate.rb +81 -0
- data/lib/kward/tools/workspace_targets.rb +58 -0
- data/lib/kward/tools/write_file.rb +9 -6
- data/lib/kward/{export_path.rb → transcripts/export_path.rb} +1 -1
- data/lib/kward/{markdown_transcript.rb → transcripts/markdown_transcript.rb} +10 -2
- data/lib/kward/transcripts/turn_summary_formatter.rb +93 -0
- data/lib/kward/transport/contracts.rb +200 -0
- data/lib/kward/transport/gateway.rb +81 -36
- data/lib/kward/transport/plugin_chat_gateway.rb +3 -2
- data/lib/kward/transport.rb +1 -200
- data/lib/kward/turn_summary.rb +68 -0
- data/lib/kward/version.rb +1 -1
- data/lib/kward/{workspace_factory.rb → workspace/factory.rb} +2 -2
- data/lib/kward/{git_worktree_manager.rb → workspace/git_worktree_manager.rb} +28 -0
- data/lib/kward/{workspace.rb → workspace/workspace.rb} +3 -3
- data/lib/main.rb +6 -3
- data/templates/default/fulldoc/html/css/kward.css +125 -0
- data/templates/default/fulldoc/html/images/kward_screen_1.png +0 -0
- data/templates/default/fulldoc/html/setup.rb +1 -1
- data/templates/default/layout/html/layout.erb +16 -4
- metadata +150 -48
- data/lib/kward/pty_transcript_normalizer.rb +0 -93
- data/lib/kward/shell_prompt.rb +0 -52
- data/lib/kward/tab_driver.rb +0 -90
- data/templates/default/fulldoc/html/images/kward_workflow.svg +0 -52
- /data/lib/kward/{editor_prompt.rb → cli/editor_prompt.rb} +0 -0
- /data/lib/kward/{editor_prompt_session.rb → cli/editor_prompt_session.rb} +0 -0
- /data/lib/kward/{diff_view_mode.rb → prompt_interface/editor/diff_view_mode.rb} +0 -0
- /data/lib/kward/{editor_mode.rb → prompt_interface/editor/editor_mode.rb} +0 -0
- /data/lib/kward/{markdown_code_block.rb → prompt_interface/editor/markdown_code_block.rb} +0 -0
- /data/lib/kward/{scratchpad_languages.rb → prompt_interface/editor/scratchpad_languages.rb} +0 -0
- /data/lib/kward/{scratchpad_runner.rb → prompt_interface/editor/scratchpad_runner.rb} +0 -0
- /data/lib/kward/{detached_run.rb → pty/detached_run.rb} +0 -0
- /data/lib/kward/{session_diff.rb → sessions/diff.rb} +0 -0
- /data/lib/kward/{session_naming.rb → sessions/naming.rb} +0 -0
- /data/lib/kward/{session_trash.rb → sessions/trash.rb} +0 -0
- /data/lib/kward/{ansi.rb → terminal/ansi.rb} +0 -0
- /data/lib/kward/{terminal_text.rb → terminal/text.rb} +0 -0
- /data/lib/kward/{transcript_export.rb → transcripts/transcript_export.rb} +0 -0
- /data/lib/kward/{project_files.rb → workspace/files.rb} +0 -0
- /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
|
|
@@ -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
|
|
@@ -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
|
-
|
|
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
|