kward 0.67.1 → 0.69.0

data/lib/kward/rpc/server.rb

@@ -14,7 +14,9 @@ require_relative "redactor"
 require_relative "session_manager"
 require_relative "transport"
 
+# Namespace for the Kward CLI agent runtime.
 module Kward
+  # JSON-RPC backend namespace used by UI clients.
   module RPC
     # Experimental JSON-RPC backend for UI clients.
     #
@@ -22,6 +24,13 @@ module Kward
     # exposes capabilities during `initialize`, redacts secrets in errors and
     # notifications, and coordinates auth, config, sessions, turns, tools,
     # memory, commands, and startup resources.
+    #
+    # `Server` should stay focused on protocol concerns: framing, JSON-RPC error
+    # codes, method dispatch, capability reporting, and redaction at the wire
+    # boundary. Delegate stateful product behavior to manager objects such as
+    # `SessionManager`, `AuthManager`, and `ConfigManager`. When adding an RPC
+    # feature, update dispatch, capabilities, docs, and tests together so clients
+    # can trust `initialize` as the source of supported behavior.
     class Server
       PROTOCOL_VERSION = 1
       JSONRPC_VERSION = "2.0"
@@ -34,12 +43,30 @@ module Kward
         invalid_params: -32_602,
         internal_error: -32_603
       }.freeze
-
+      SESSION_METHODS = [
+        "sessions/create", "sessions/resume", "sessions/list", "sessions/rename",
+        "sessions/clone", "sessions/compact", "sessions/forkMessages", "sessions/fork",
+        "sessions/tree", "sessions/tree/setLabel", "sessions/tree/navigate",
+        "sessions/export", "sessions/delete", "sessions/close", "sessions/transcript"
+      ].freeze
+      MODEL_METHODS = ["models/list", "models/current", "models/set", "reasoning/set", "openrouter/catalog"].freeze
+      AUTH_METHODS = [
+        "auth/status", "auth/providers", "auth/loginWithApiKey", "auth/logoutProvider",
+        "auth/loginWithOAuth", "auth/startOpenAILogin", "auth/submitOpenAICode", "auth/loginStatus"
+      ].freeze
+      MEMORY_METHODS = [
+        "memory/status", "memory/enable", "memory/disable", "memory/autoSummary/enable",
+        "memory/autoSummary/disable", "memory/list", "memory/add", "memory/addCore",
+        "memory/forget", "memory/promote", "memory/relax", "memory/inspect",
+        "memory/why", "memory/summarize"
+      ].freeze
+
+      # Creates the RPC server and its stateful managers.
       def initialize(input: $stdin, output: $stdout, error_output: $stderr, client: Client.new)
         @transport = Transport.new(input: input, output: output)
         @error_output = error_output
-        @session_manager = SessionManager.new(server: self, client: client)
         @config_manager = ConfigManager.new
+        @session_manager = SessionManager.new(server: self, client: client, config_manager: @config_manager)
         @auth_manager = AuthManager.new(server: self, config_manager: @config_manager)
         @shutdown = false
       end
@@ -287,7 +314,7 @@ module Kward
           sessions: {
             mode: "explicit",
             persistence: "jsonl",
-            methods: ["sessions/create", "sessions/resume", "sessions/list", "sessions/rename", "sessions/clone", "sessions/compact", "sessions/forkMessages", "sessions/fork", "sessions/tree", "sessions/tree/setLabel", "sessions/tree/navigate", "sessions/export", "sessions/delete", "sessions/close", "sessions/transcript"],
+            methods: SESSION_METHODS,
             startupResume: { supported: true, method: "sessions/create", parameter: "resumeLast", default: session_auto_resume_enabled?, immediateTranscript: true, sessionActivePersonaLabel: true },
             list: { supported: true, source: "rpc", ancestry: true, treeFields: true },
             fork: { supported: true, methods: ["sessions/forkMessages", "sessions/fork"], entryIdFormat: "entry-id", selectedMessage: "excludedFromForkComposerTextReturned" },
@@ -333,7 +360,7 @@ module Kward
           },
           models: {
             supported: true,
-            methods: ["models/list", "models/current", "models/set", "reasoning/set", "openrouter/catalog"],
+            methods: MODEL_METHODS,
             fields: ["provider", "id", "name", "reasoning", "reasoningEffort", "contextWindow"],
             scopedModels: false
           },
@@ -351,13 +378,13 @@ module Kward
           auth: {
             supported: true,
             providerFormat: "tauren-auth-v1",
-            methods: ["auth/status", "auth/providers", "auth/loginWithApiKey", "auth/logoutProvider", "auth/loginWithOAuth", "auth/startOpenAILogin", "auth/submitOpenAICode", "auth/loginStatus"],
-            oauthProviders: ["openai", "github"],
+            methods: AUTH_METHODS,
+            oauthProviders: ["openai", "anthropic", "github"],
             unsupportedOAuthProviders: { github: "CLI-only GitHub login for Copilot scaffolding; RPC login is not implemented yet." },
             apiKeyProviders: ["openrouter"],
             logout: true
           },
-          memory: { supported: true, optIn: true, defaultEnabled: false, autoSummaryDefaultEnabled: false, promptInjection: "interactive", storage: { core: "json", soft: "jsonl", events: "jsonl" }, methods: ["memory/status", "memory/enable", "memory/disable", "memory/autoSummary/enable", "memory/autoSummary/disable", "memory/list", "memory/add", "memory/addCore", "memory/forget", "memory/promote", "memory/relax", "memory/inspect", "memory/why", "memory/summarize"] },
+          memory: { supported: true, optIn: true, defaultEnabled: false, autoSummaryDefaultEnabled: false, promptInjection: "interactive", storage: { core: "json", soft: "jsonl", events: "jsonl" }, methods: MEMORY_METHODS },
           commands: { supported: true, methods: ["commands/list", "commands/run"], method: "commands/list", runMethod: "commands/run", sources: ["builtin", "prompt", "skill", "plugin"], executableSources: ["builtin", "plugin"] },
           startupResources: { supported: true, method: "resources/startup" },
           starterPack: { supported: false, reason: "cliOnlyInstallCommand" },
@@ -533,8 +560,13 @@ module Kward
       def startup_resources(params)
         @session_manager.runtime_state(session_id: params.fetch("sessionId"))
         sections = []
-        agents_path = File.join(ConfigFiles.config_dir, "AGENTS.md")
-        sections << { name: "Context", items: ["AGENTS.md"] } if File.exist?(agents_path)
+        context_items = []
+        if File.exist?(ConfigFiles.config_principles_path)
+          context_items << "PRINCIPLES.md"
+        elsif File.exist?(ConfigFiles.config_agents_path)
+          context_items << "AGENTS.md"
+        end
+        sections << { name: "Context", items: context_items } unless context_items.empty?
         skills = ConfigFiles.skills.map(&:name)
         prompts = ConfigFiles.prompt_templates(reserved_commands: BUILTIN_SLASH_COMMAND_NAMES).map { |template| "/#{template.command}" }
         plugins = @session_manager.plugin_commands.map { |command| "/#{command.name}" }
@@ -600,11 +632,11 @@ module Kward
       end
 
       def workspace_guardrails_enabled?
-        ConfigFiles.workspace_guardrails_enabled?(@config_manager.read(redacted: false))
+        @config_manager.workspace_guardrails_enabled?
       end
 
       def session_auto_resume_enabled?
-        ConfigFiles.session_auto_resume_enabled?(@config_manager.read(redacted: false))
+        @config_manager.session_auto_resume_enabled?
       end
 
       def write_result(id, result)