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.
Files changed (151) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +130 -0
  3. data/CONTRIBUTING.md +1 -1
  4. data/Gemfile.lock +6 -2
  5. data/README.md +3 -3
  6. data/Rakefile +3 -0
  7. data/doc/agent-tools.md +11 -0
  8. data/doc/api.md +4 -1
  9. data/doc/composer.md +4 -3
  10. data/doc/configuration.md +60 -11
  11. data/doc/extensibility.md +2 -0
  12. data/doc/getting-started.md +3 -3
  13. data/doc/git.md +1 -1
  14. data/doc/memory.md +1 -1
  15. data/doc/plugins.md +40 -5
  16. data/doc/providers.md +10 -4
  17. data/doc/rpc.md +125 -7
  18. data/doc/session-management.md +36 -1
  19. data/doc/shell.md +643 -27
  20. data/doc/tabs.md +2 -1
  21. data/doc/troubleshooting.md +1 -1
  22. data/doc/usage.md +21 -11
  23. data/examples/plugins/openrouter_proxy/README.md +103 -0
  24. data/examples/plugins/openrouter_proxy/fake_embeddings.rb +85 -0
  25. data/examples/plugins/openrouter_proxy/plugin.rb +7 -0
  26. data/examples/plugins/openrouter_proxy/protocol.rb +202 -0
  27. data/examples/plugins/openrouter_proxy/server.rb +186 -0
  28. data/examples/plugins/space_invaders.rb +0 -1
  29. data/exe/kward +2 -2
  30. data/exe/kwsh +7 -0
  31. data/kward.gemspec +3 -1
  32. data/lib/kward/agent.rb +43 -9
  33. data/lib/kward/cli/commands.rb +41 -11
  34. data/lib/kward/cli/interactive_turn.rb +10 -0
  35. data/lib/kward/cli/plugins.rb +5 -1
  36. data/lib/kward/cli/prompt_interface.rb +4 -1
  37. data/lib/kward/cli/rendering.rb +21 -28
  38. data/lib/kward/cli/runtime_helpers.rb +52 -34
  39. data/lib/kward/cli/settings/model.rb +1 -12
  40. data/lib/kward/cli/tabs.rb +91 -18
  41. data/lib/kward/cli/tool_summaries.rb +2 -0
  42. data/lib/kward/cli/transcript_formatter.rb +3 -10
  43. data/lib/kward/cli/worktrees.rb +1 -0
  44. data/lib/kward/cli.rb +56 -7
  45. data/lib/kward/config/core.rb +16 -5
  46. data/lib/kward/config/extensions.rb +3 -0
  47. data/lib/kward/config/paths.rb +11 -0
  48. data/lib/kward/config/settings.rb +7 -0
  49. data/lib/kward/conversation.rb +11 -1
  50. data/lib/kward/entrypoint.rb +14 -0
  51. data/lib/kward/events.rb +2 -0
  52. data/lib/kward/generated_images.rb +237 -0
  53. data/lib/kward/model/catalog.rb +6 -3
  54. data/lib/kward/model/client.rb +105 -36
  55. data/lib/kward/model/codex_images.rb +83 -0
  56. data/lib/kward/model/copilot_models.rb +8 -4
  57. data/lib/kward/model/model_info.rb +27 -9
  58. data/lib/kward/model/openrouter_model_cache.rb +4 -2
  59. data/lib/kward/model/payloads.rb +6 -5
  60. data/lib/kward/model/sources.rb +3 -1
  61. data/lib/kward/model/stream_parser.rb +4 -7
  62. data/lib/kward/pan/index.html.erb +8 -1
  63. data/lib/kward/pan/server.rb +13 -1
  64. data/lib/kward/plugins/codex_responses.rb +73 -0
  65. data/lib/kward/plugins/host.rb +16 -0
  66. data/lib/kward/plugins/http_server.rb +83 -0
  67. data/lib/kward/plugins/registry.rb +39 -0
  68. data/lib/kward/prompt_interface/composer_controller.rb +0 -1
  69. data/lib/kward/prompt_interface/composer_renderer.rb +159 -72
  70. data/lib/kward/prompt_interface/editor/controller.rb +1 -1
  71. data/lib/kward/prompt_interface/editor/renderer.rb +10 -7
  72. data/lib/kward/prompt_interface/file_overlay.rb +3 -3
  73. data/lib/kward/prompt_interface/generated_image_preview.rb +162 -0
  74. data/lib/kward/prompt_interface/git_prompt.rb +18 -11
  75. data/lib/kward/prompt_interface/interactive/renderer.rb +1 -1
  76. data/lib/kward/prompt_interface/interactive/state.rb +18 -20
  77. data/lib/kward/prompt_interface/key_handler.rb +108 -25
  78. data/lib/kward/prompt_interface/layout.rb +11 -1
  79. data/lib/kward/prompt_interface/overlay_renderer.rb +25 -8
  80. data/lib/kward/prompt_interface/project_browser.rb +27 -54
  81. data/lib/kward/prompt_interface/prompt_renderer.rb +27 -35
  82. data/lib/kward/prompt_interface/question_prompt.rb +19 -28
  83. data/lib/kward/prompt_interface/runtime_state.rb +31 -9
  84. data/lib/kward/prompt_interface/screen.rb +24 -21
  85. data/lib/kward/prompt_interface/selection_prompt.rb +8 -8
  86. data/lib/kward/prompt_interface/slash_overlay.rb +1 -1
  87. data/lib/kward/prompt_interface/transcript_renderer.rb +7 -6
  88. data/lib/kward/prompt_interface.rb +109 -39
  89. data/lib/kward/prompts.rb +7 -1
  90. data/lib/kward/pty/adaptive_output_sink.rb +38 -4
  91. data/lib/kward/pty/interactive_runner.rb +20 -28
  92. data/lib/kward/pty/transcript_normalizer.rb +65 -21
  93. data/lib/kward/rpc/config_manager.rb +3 -0
  94. data/lib/kward/rpc/server.rb +27 -5
  95. data/lib/kward/rpc/session_manager.rb +62 -17
  96. data/lib/kward/rpc/transcript_normalizer.rb +11 -7
  97. data/lib/kward/sessions/store.rb +30 -3
  98. data/lib/kward/shell/kwsh.rb +27 -7
  99. data/lib/kward/shell/kwshrc.rb +11 -2
  100. data/lib/kward/shell/native_arithmetic.rb +255 -0
  101. data/lib/kward/shell/native_arrays.rb +102 -0
  102. data/lib/kward/shell/native_braces.rb +96 -0
  103. data/lib/kward/shell/native_builtins.rb +476 -0
  104. data/lib/kward/shell/native_completion.rb +169 -0
  105. data/lib/kward/shell/native_condition.rb +75 -0
  106. data/lib/kward/shell/native_directory.rb +116 -0
  107. data/lib/kward/shell/native_exec_state.rb +73 -0
  108. data/lib/kward/shell/native_expansion.rb +252 -0
  109. data/lib/kward/shell/native_fields.rb +62 -0
  110. data/lib/kward/shell/native_glob.rb +96 -0
  111. data/lib/kward/shell/native_history.rb +242 -0
  112. data/lib/kward/shell/native_interactive.rb +164 -0
  113. data/lib/kward/shell/native_invocation.rb +42 -0
  114. data/lib/kward/shell/native_jobs.rb +250 -0
  115. data/lib/kward/shell/native_line_editor.rb +382 -0
  116. data/lib/kward/shell/native_line_terminal.rb +286 -0
  117. data/lib/kward/shell/native_locale.rb +109 -0
  118. data/lib/kward/shell/native_locals.rb +57 -0
  119. data/lib/kward/shell/native_pattern.rb +200 -0
  120. data/lib/kward/shell/native_process.rb +279 -0
  121. data/lib/kward/shell/native_program.rb +40 -0
  122. data/lib/kward/shell/native_programmable_completion.rb +115 -0
  123. data/lib/kward/shell/native_prompt_format.rb +89 -0
  124. data/lib/kward/shell/native_runtime.rb +964 -0
  125. data/lib/kward/shell/native_substitution.rb +110 -0
  126. data/lib/kward/shell/native_syntax.rb +946 -0
  127. data/lib/kward/shell/native_traps.rb +196 -0
  128. data/lib/kward/shell/native_vi.rb +407 -0
  129. data/lib/kward/shell/native_vi_terminal.rb +19 -0
  130. data/lib/kward/shell/native_worker.rb +82 -0
  131. data/lib/kward/shell/persistent_session.rb +184 -190
  132. data/lib/kward/shell/prompt.rb +14 -0
  133. data/lib/kward/shell/prompt_agent.rb +17 -0
  134. data/lib/kward/shell/script_runner.rb +244 -0
  135. data/lib/kward/shell/standalone_agent.rb +31 -0
  136. data/lib/kward/shell/standalone_link.rb +78 -0
  137. data/lib/kward/shell/standalone_terminal.rb +287 -0
  138. data/lib/kward/terminal/keys.rb +22 -1
  139. data/lib/kward/terminal/locale_text.rb +29 -0
  140. data/lib/kward/terminal/sequences.rb +45 -4
  141. data/lib/kward/tools/datetime.rb +85 -0
  142. data/lib/kward/tools/generate_image.rb +36 -0
  143. data/lib/kward/tools/registry.rb +35 -9
  144. data/lib/kward/tools/tool_call.rb +3 -1
  145. data/lib/kward/transcripts/markdown_transcript.rb +8 -0
  146. data/lib/kward/transcripts/turn_summary_formatter.rb +93 -0
  147. data/lib/kward/transport/gateway.rb +2 -1
  148. data/lib/kward/turn_summary.rb +68 -0
  149. data/lib/kward/version.rb +1 -1
  150. data/lib/main.rb +6 -3
  151. 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