kward 0.85.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 +130 -0
- data/CONTRIBUTING.md +1 -1
- data/Gemfile.lock +6 -2
- data/README.md +3 -3
- data/Rakefile +3 -0
- data/doc/agent-tools.md +11 -0
- data/doc/api.md +4 -1
- data/doc/composer.md +4 -3
- data/doc/configuration.md +60 -11
- data/doc/extensibility.md +2 -0
- data/doc/getting-started.md +3 -3
- data/doc/git.md +1 -1
- data/doc/memory.md +1 -1
- data/doc/plugins.md +40 -5
- data/doc/providers.md +10 -4
- data/doc/rpc.md +125 -7
- data/doc/session-management.md +36 -1
- data/doc/shell.md +643 -27
- data/doc/tabs.md +2 -1
- data/doc/troubleshooting.md +1 -1
- data/doc/usage.md +21 -11
- 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 +0 -1
- data/exe/kward +2 -2
- data/exe/kwsh +7 -0
- data/kward.gemspec +3 -1
- data/lib/kward/agent.rb +43 -9
- data/lib/kward/cli/commands.rb +41 -11
- data/lib/kward/cli/interactive_turn.rb +10 -0
- data/lib/kward/cli/plugins.rb +5 -1
- data/lib/kward/cli/prompt_interface.rb +4 -1
- data/lib/kward/cli/rendering.rb +21 -28
- data/lib/kward/cli/runtime_helpers.rb +52 -34
- data/lib/kward/cli/settings/model.rb +1 -12
- data/lib/kward/cli/tabs.rb +91 -18
- data/lib/kward/cli/tool_summaries.rb +2 -0
- data/lib/kward/cli/transcript_formatter.rb +3 -10
- data/lib/kward/cli/worktrees.rb +1 -0
- data/lib/kward/cli.rb +56 -7
- data/lib/kward/config/core.rb +16 -5
- data/lib/kward/config/extensions.rb +3 -0
- data/lib/kward/config/paths.rb +11 -0
- data/lib/kward/config/settings.rb +7 -0
- data/lib/kward/conversation.rb +11 -1
- 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/model/catalog.rb +6 -3
- data/lib/kward/model/client.rb +105 -36
- data/lib/kward/model/codex_images.rb +83 -0
- data/lib/kward/model/copilot_models.rb +8 -4
- data/lib/kward/model/model_info.rb +27 -9
- data/lib/kward/model/openrouter_model_cache.rb +4 -2
- data/lib/kward/model/payloads.rb +6 -5
- data/lib/kward/model/sources.rb +3 -1
- data/lib/kward/model/stream_parser.rb +4 -7
- data/lib/kward/pan/index.html.erb +8 -1
- data/lib/kward/pan/server.rb +13 -1
- data/lib/kward/plugins/codex_responses.rb +73 -0
- data/lib/kward/plugins/host.rb +16 -0
- data/lib/kward/plugins/http_server.rb +83 -0
- data/lib/kward/plugins/registry.rb +39 -0
- data/lib/kward/prompt_interface/composer_controller.rb +0 -1
- data/lib/kward/prompt_interface/composer_renderer.rb +159 -72
- data/lib/kward/prompt_interface/editor/controller.rb +1 -1
- data/lib/kward/prompt_interface/editor/renderer.rb +10 -7
- 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 +25 -8
- 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 +31 -9
- data/lib/kward/prompt_interface/screen.rb +24 -21
- 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 +109 -39
- data/lib/kward/prompts.rb +7 -1
- data/lib/kward/pty/adaptive_output_sink.rb +38 -4
- data/lib/kward/pty/interactive_runner.rb +20 -28
- data/lib/kward/pty/transcript_normalizer.rb +65 -21
- data/lib/kward/rpc/config_manager.rb +3 -0
- data/lib/kward/rpc/server.rb +27 -5
- data/lib/kward/rpc/session_manager.rb +62 -17
- data/lib/kward/rpc/transcript_normalizer.rb +11 -7
- data/lib/kward/sessions/store.rb +30 -3
- data/lib/kward/shell/kwsh.rb +27 -7
- data/lib/kward/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/shell/persistent_session.rb +184 -190
- data/lib/kward/shell/prompt.rb +14 -0
- data/lib/kward/shell/prompt_agent.rb +17 -0
- 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/terminal/keys.rb +22 -1
- data/lib/kward/terminal/locale_text.rb +29 -0
- data/lib/kward/terminal/sequences.rb +45 -4
- data/lib/kward/tools/datetime.rb +85 -0
- data/lib/kward/tools/generate_image.rb +36 -0
- data/lib/kward/tools/registry.rb +35 -9
- data/lib/kward/tools/tool_call.rb +3 -1
- data/lib/kward/transcripts/markdown_transcript.rb +8 -0
- data/lib/kward/transcripts/turn_summary_formatter.rb +93 -0
- data/lib/kward/transport/gateway.rb +2 -1
- data/lib/kward/turn_summary.rb +68 -0
- data/lib/kward/version.rb +1 -1
- data/lib/main.rb +6 -3
- metadata +84 -1
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
module Kward
|
|
2
|
+
module NativeShell
|
|
3
|
+
# Bash's small programmable-completion subset used by rbenv. The callback
|
|
4
|
+
# is a trusted, explicitly registered function; the draft is data only.
|
|
5
|
+
module ProgrammableCompletion
|
|
6
|
+
COMPLETION_TIMEOUT = 2.0
|
|
7
|
+
COMPLETION_BYTES = 64 * 1024
|
|
8
|
+
COMPLETION_COUNT = 256
|
|
9
|
+
|
|
10
|
+
private
|
|
11
|
+
|
|
12
|
+
def complete_builtin(args)
|
|
13
|
+
flag, function, *commands = args
|
|
14
|
+
commands.shift if commands.first == "--"
|
|
15
|
+
unless flag == "-F" && function&.match?(/\A[A-Za-z_][A-Za-z0-9_]*\z/) && !commands.empty? && commands.none?(&:empty?)
|
|
16
|
+
raise ExecutionError, "complete: expected -F function command..."
|
|
17
|
+
end
|
|
18
|
+
commands.each { |command| @completion_functions[command] = function }
|
|
19
|
+
0
|
|
20
|
+
end
|
|
21
|
+
|
|
22
|
+
def compgen_builtin(args, streams)
|
|
23
|
+
flag, list, *rest = args
|
|
24
|
+
rest.shift if rest.first == "--"
|
|
25
|
+
raise ExecutionError, "compgen: expected -W wordlist [--] [prefix]" unless flag == "-W" && list && rest.size <= 1
|
|
26
|
+
|
|
27
|
+
prefix = rest.first.to_s
|
|
28
|
+
matches = Shellwords.split(list).select { |word| word.start_with?(prefix) }.uniq
|
|
29
|
+
matches.each { |word| write_line(streams, word) }
|
|
30
|
+
matches.empty? ? 1 : 0
|
|
31
|
+
end
|
|
32
|
+
|
|
33
|
+
def programmed_candidates(words, cancel:)
|
|
34
|
+
function = @completion_functions[words.first]
|
|
35
|
+
return unless @functions.key?(function)
|
|
36
|
+
|
|
37
|
+
reader, writer = IO.pipe
|
|
38
|
+
pid = Process.fork do
|
|
39
|
+
Process.setsid
|
|
40
|
+
reader.close
|
|
41
|
+
File.open(File::NULL, "r+") do |null|
|
|
42
|
+
[STDIN, STDOUT, STDERR].each { |io| io.reopen(null) }
|
|
43
|
+
writer.write(completion_reply(function, words, null))
|
|
44
|
+
end
|
|
45
|
+
exit!(0)
|
|
46
|
+
rescue StandardError, Interrupt
|
|
47
|
+
exit!(1)
|
|
48
|
+
end
|
|
49
|
+
writer.close
|
|
50
|
+
read_completion(reader, cancel).split("\0").map do |word|
|
|
51
|
+
word.force_encoding(words.last.encoding)
|
|
52
|
+
end
|
|
53
|
+
rescue IOError, SystemCallError
|
|
54
|
+
[]
|
|
55
|
+
ensure
|
|
56
|
+
reader&.close unless reader&.closed?
|
|
57
|
+
writer&.close unless writer&.closed?
|
|
58
|
+
if pid
|
|
59
|
+
# Keep the pid reserved until both the worker and its ordinary child
|
|
60
|
+
# processes have been signaled, including when cancellation races setsid.
|
|
61
|
+
Process.kill("KILL", pid) rescue nil
|
|
62
|
+
Process.kill("KILL", -pid) rescue nil
|
|
63
|
+
Process.waitpid(pid) rescue nil
|
|
64
|
+
end
|
|
65
|
+
end
|
|
66
|
+
|
|
67
|
+
def completion_reply(function, words, null)
|
|
68
|
+
reset_child_state(job_group: Process.getpgrp)
|
|
69
|
+
@process_owned = true
|
|
70
|
+
@replace_process = false
|
|
71
|
+
@base_streams = { 0 => null, 1 => null, 2 => null }
|
|
72
|
+
@persistent_descriptors = {}
|
|
73
|
+
%w[COMP_WORDS COMP_CWORD COMPREPLY].each do |name|
|
|
74
|
+
@variables.delete(name)
|
|
75
|
+
@arrays.delete(name)
|
|
76
|
+
@readonly.delete(name)
|
|
77
|
+
@exported.delete(name)
|
|
78
|
+
end
|
|
79
|
+
@variables["COMP_CWORD"] = (words.length - 1).to_s
|
|
80
|
+
@arrays["COMP_WORDS"] = Arrays::ArrayValue.new(associative: false, values: words.each_with_index.to_h { |word, index| [index, word] })
|
|
81
|
+
@arrays["COMPREPLY"] = Arrays::ArrayValue.new(associative: false, values: {})
|
|
82
|
+
call_function(function, [words.first, words.last, words[-2].to_s], @base_streams)
|
|
83
|
+
reply = @arrays["COMPREPLY"]
|
|
84
|
+
buffer = +"".b
|
|
85
|
+
count = 0
|
|
86
|
+
reply&.values&.each_value do |value|
|
|
87
|
+
next if value.empty? || value.include?("\0")
|
|
88
|
+
break if count >= COMPLETION_COUNT || buffer.bytesize + value.bytesize + 1 > COMPLETION_BYTES
|
|
89
|
+
|
|
90
|
+
buffer << value.b << "\0"
|
|
91
|
+
count += 1
|
|
92
|
+
end
|
|
93
|
+
buffer
|
|
94
|
+
end
|
|
95
|
+
|
|
96
|
+
def read_completion(reader, cancel)
|
|
97
|
+
deadline = Process.clock_gettime(Process::CLOCK_MONOTONIC) + COMPLETION_TIMEOUT
|
|
98
|
+
buffer = +"".b
|
|
99
|
+
loop do
|
|
100
|
+
return "" if cancel&.call
|
|
101
|
+
remaining = deadline - Process.clock_gettime(Process::CLOCK_MONOTONIC)
|
|
102
|
+
return "" unless remaining.positive?
|
|
103
|
+
next unless IO.select([reader], nil, nil, [remaining, 0.025].min)
|
|
104
|
+
|
|
105
|
+
chunk = reader.read_nonblock(8192, exception: false)
|
|
106
|
+
return buffer if chunk.nil?
|
|
107
|
+
next if chunk == :wait_readable
|
|
108
|
+
|
|
109
|
+
buffer << chunk
|
|
110
|
+
return "" if buffer.bytesize > COMPLETION_BYTES
|
|
111
|
+
end
|
|
112
|
+
end
|
|
113
|
+
end
|
|
114
|
+
end
|
|
115
|
+
end
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
require "etc"
|
|
2
|
+
require_relative "../terminal/locale_text"
|
|
3
|
+
require_relative "../terminal/sequences"
|
|
4
|
+
|
|
5
|
+
module Kward
|
|
6
|
+
module NativeShell
|
|
7
|
+
# Expand only known prompt escapes. Metadata is text, never format source
|
|
8
|
+
# or terminal control data. Only styles generated here occupy zero cells.
|
|
9
|
+
class PromptFormat
|
|
10
|
+
ESCAPES = /(%(?:[FK]\{[^{}%]*\}|1~|[~d\/nm?#%fkbB]))/n.freeze
|
|
11
|
+
COLORS = %w[black red green yellow blue magenta cyan white].freeze
|
|
12
|
+
STYLES = { "%f" => [39], "%k" => [49], "%B" => [1], "%b" => [22] }.freeze
|
|
13
|
+
|
|
14
|
+
def initialize(template, directory:, home:, status:, color:, prefix: "")
|
|
15
|
+
@directory = directory.b
|
|
16
|
+
@home = home.to_s.b
|
|
17
|
+
@status = status
|
|
18
|
+
@parts = template.b.split(ESCAPES).filter_map do |part|
|
|
19
|
+
style = STYLES[part] || color_style(part)
|
|
20
|
+
style ? (style if color) : expand(part)
|
|
21
|
+
end
|
|
22
|
+
@parts.unshift(prefix.b) unless prefix.empty?
|
|
23
|
+
@styled = @parts.any? { |part| part.is_a?(Array) }
|
|
24
|
+
end
|
|
25
|
+
|
|
26
|
+
def cells(encoding)
|
|
27
|
+
@parts.flat_map do |part|
|
|
28
|
+
if part.is_a?(Array)
|
|
29
|
+
[[TerminalSequences.sgr(*part), 0]]
|
|
30
|
+
else
|
|
31
|
+
TerminalText.locale_cells(part.b.force_encoding(encoding).scrub)
|
|
32
|
+
end
|
|
33
|
+
end
|
|
34
|
+
end
|
|
35
|
+
|
|
36
|
+
def render(cells)
|
|
37
|
+
text = cells.map(&:first).join
|
|
38
|
+
@styled ? text + TerminalSequences::SGR_RESET : text
|
|
39
|
+
end
|
|
40
|
+
|
|
41
|
+
private
|
|
42
|
+
|
|
43
|
+
def expand(part)
|
|
44
|
+
case part
|
|
45
|
+
when "%%" then "%"
|
|
46
|
+
when "%d", "%/" then @directory
|
|
47
|
+
when "%~" then abbreviated_directory
|
|
48
|
+
when "%1~" then File.basename(abbreviated_directory)
|
|
49
|
+
when "%n" then username
|
|
50
|
+
when "%m" then Etc.uname.fetch(:nodename).split(".", 2).first.to_s
|
|
51
|
+
when "%?" then @status.to_s
|
|
52
|
+
when "%#" then Process.euid.zero? ? "#" : "%"
|
|
53
|
+
else part
|
|
54
|
+
end
|
|
55
|
+
end
|
|
56
|
+
|
|
57
|
+
def abbreviated_directory
|
|
58
|
+
return @directory unless @home.start_with?("/")
|
|
59
|
+
|
|
60
|
+
home = @home.sub(%r{/+\z}, "")
|
|
61
|
+
return "~" if @directory == (home.empty? ? "/" : home)
|
|
62
|
+
return @directory unless @directory.start_with?("#{home}/")
|
|
63
|
+
|
|
64
|
+
"~#{@directory.delete_prefix(home)}"
|
|
65
|
+
end
|
|
66
|
+
|
|
67
|
+
def username
|
|
68
|
+
Etc.getpwuid(Process.euid).name
|
|
69
|
+
rescue ArgumentError
|
|
70
|
+
Process.euid.to_s
|
|
71
|
+
end
|
|
72
|
+
|
|
73
|
+
def color_style(part)
|
|
74
|
+
match = /\A%([FK])\{([^{}]*)\}\z/n.match(part)
|
|
75
|
+
return unless match
|
|
76
|
+
|
|
77
|
+
foreground = match[1] == "F"
|
|
78
|
+
specification = match[2]
|
|
79
|
+
if (index = COLORS.index(specification))
|
|
80
|
+
[(foreground ? 30 : 40) + index]
|
|
81
|
+
elsif specification.match?(/\A\d{1,3}\z/) && (index = specification.to_i) <= 255
|
|
82
|
+
[foreground ? 38 : 48, 5, index]
|
|
83
|
+
elsif specification.match?(/\A#[0-9a-fA-F]{6}\z/)
|
|
84
|
+
[foreground ? 38 : 48, 2, *specification[1..].scan(/../).map(&:hex)]
|
|
85
|
+
end
|
|
86
|
+
end
|
|
87
|
+
end
|
|
88
|
+
end
|
|
89
|
+
end
|