kward 0.74.0 → 0.76.0

data/lib/kward/rpc/server.rb

@@ -11,6 +11,7 @@ require_relative "../telemetry/logger"
 require_relative "../telemetry/stats"
 require_relative "auth_manager"
 require_relative "config_manager"
+require_relative "mcp_status"
 require_relative "redactor"
 require_relative "session_manager"
 require_relative "transport"
@@ -19,7 +20,7 @@ require_relative "transport"
 module Kward
   # JSON-RPC backend namespace used by UI clients.
   module RPC
-    # Experimental JSON-RPC backend for UI clients.
+    # JSON-RPC backend for trusted local UI clients.
     #
     # The server speaks LSP-style Content-Length framing over stdin/stdout,
     # exposes capabilities during `initialize`, redacts secrets in errors and
@@ -47,14 +48,15 @@ module Kward
       PROTOCOL_METHODS = ["initialize", "shutdown"].freeze
       WORKSPACE_METHODS = ["workspace/validate", "workspace/info"].freeze
       TOOL_METHODS = ["tools/list"].freeze
+      MCP_METHODS = ["mcp/status"].freeze
       PROMPT_METHODS = ["prompts/list", "prompts/expand"].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"
+        "sessions/export", "sessions/delete", "sessions/close", "sessions/transcript", "sessions/active"
       ].freeze
-      TURN_METHODS = ["turns/start", "turns/cancel", "turns/status", "turns/events"].freeze
+      TURN_METHODS = ["turns/start", "turns/cancel", "turns/status", "turns/events", "turns/list", "turns/listActive"].freeze
       MODEL_METHODS = ["models/list", "models/current", "models/set", "reasoning/set"].freeze
       RUNTIME_METHODS = ["runtime/state", "runtime/stats"].freeze
       RUNTIME_SETTING_METHODS = ["runtime/updateSetting", "runtime/reload"].freeze
@@ -73,16 +75,21 @@ module Kward
       STARTUP_RESOURCE_METHODS = ["resources/startup"].freeze
       CONFIG_METHODS = ["config/read", "config/update"].freeze
       LOGGING_METHODS = ["logging/stats", "logging/tokenCsv"].freeze
+      LIFECYCLE_HOOK_METHODS = ["hooks/logs"].freeze
       UI_METHODS = ["ui/answerQuestion"].freeze
+      TOOL_APPROVAL_METHODS = ["tool/answerApproval"].freeze
       SESSION_EVENT_NOTIFICATION = "session/event"
       SESSION_UPDATED_NOTIFICATION = "session/updated"
       TURN_EVENT_NOTIFICATION = "turn/event"
       UI_QUESTION_NOTIFICATION = "ui/question"
       UI_FOOTER_NOTIFICATION = "ui/footer"
+      TOOL_APPROVAL_NOTIFICATION = "tool/approvalRequested"
+      HOOK_EVENT_NOTIFICATION = "hook/event"
       METHOD_GROUPS = {
         protocol: PROTOCOL_METHODS,
         workspace: WORKSPACE_METHODS,
         tools: TOOL_METHODS,
+        mcp: MCP_METHODS,
         prompts: PROMPT_METHODS,
         sessions: SESSION_METHODS,
         turns: TURN_METHODS,
@@ -96,7 +103,9 @@ module Kward
         startup_resources: STARTUP_RESOURCE_METHODS,
         config: CONFIG_METHODS,
         logging: LOGGING_METHODS,
-        ui: UI_METHODS
+        lifecycle_hooks: LIFECYCLE_HOOK_METHODS,
+        ui: UI_METHODS,
+        tool_approval: TOOL_APPROVAL_METHODS
       }.freeze
       RPC_METHODS = METHOD_GROUPS.values.flatten.freeze
 
@@ -201,7 +210,9 @@ module Kward
         when WORKSPACE_METHODS[1]
           workspace_info(params["workspaceRoot"] || Dir.pwd)
         when TOOL_METHODS[0]
-          { tools: ToolRegistry.new(workspace: configured_workspace).schemas }
+          @session_manager.tool_schemas(session_id: params["sessionId"])
+        when MCP_METHODS[0]
+          MCPStatus.new(config_manager: @config_manager).to_h
         when PROMPT_METHODS[0]
           prompts_list
         when PROMPT_METHODS[1]
@@ -236,6 +247,8 @@ module Kward
           logging_stats(params)
         when LOGGING_METHODS[1]
           logging_token_csv(params)
+        when LIFECYCLE_HOOK_METHODS[0]
+          lifecycle_hook_logs(params)
         when MEMORY_METHODS[0]
           @session_manager.memory_status
         when MEMORY_METHODS[1]
@@ -316,12 +329,16 @@ module Kward
           @session_manager.close_session(session_id: params.fetch("sessionId"))
         when SESSION_METHODS[14]
           @session_manager.transcript(session_id: params.fetch("sessionId"))
+        when SESSION_METHODS[15]
+          @session_manager.active_sessions
         when TURN_METHODS[0]
           @session_manager.start_turn(
             session_id: params.fetch("sessionId"),
             input: params.fetch("input"),
             streaming_behavior: params["streamingBehavior"],
-            attachments: params["attachments"] || []
+            attachments: params["attachments"] || [],
+            options: params["options"] || {},
+            context: params["context"]
           )
         when TURN_METHODS[1]
           @session_manager.cancel_turn(turn_id: params.fetch("turnId"))
@@ -329,8 +346,14 @@ module Kward
           @session_manager.turn_status(turn_id: params.fetch("turnId"))
         when TURN_METHODS[3]
           @session_manager.turn_events(turn_id: params.fetch("turnId"), after_sequence: params["afterSequence"] || 0)
+        when TURN_METHODS[4]
+          @session_manager.list_turns(session_id: params["sessionId"])
+        when TURN_METHODS[5]
+          @session_manager.list_turns(session_id: params["sessionId"], active: true)
         when UI_METHODS[0]
           @session_manager.answer_question(session_id: params.fetch("sessionId"), question_request_id: params.fetch("questionRequestId"), answers: params.fetch("answers"))
+        when TOOL_APPROVAL_METHODS[0]
+          @session_manager.answer_tool_approval(session_id: params.fetch("sessionId"), approval_request_id: params.fetch("approvalRequestId"), approved: params.fetch("approved"))
         else
           raise NoMethodError, method
         end
@@ -340,7 +363,7 @@ module Kward
         {
           protocolVersion: PROTOCOL_VERSION,
           serverName: "kward",
-          experimental: true,
+          experimental: false,
           capabilities: capabilities
         }
       end
@@ -349,7 +372,7 @@ module Kward
         {
           framing: "content-length",
           transcript: {
-            format: "tauren-transcript-v1",
+            format: "kward-transcript-v1",
             messagesNormalized: true,
             supportsImages: true,
             supportsToolCalls: true,
@@ -363,10 +386,11 @@ module Kward
             methods: SESSION_METHODS,
             startupResume: { supported: true, method: SESSION_METHODS[0], parameter: "resumeLast", default: session_auto_resume_enabled?, immediateTranscript: true, sessionActivePersonaLabel: true },
             list: { supported: true, source: "rpc", ancestry: true, treeFields: true },
+            active: { supported: true, method: SESSION_METHODS[15] },
             fork: { supported: true, methods: SESSION_METHODS.values_at(6, 7), entryIdFormat: "entry-id", selectedMessage: "excludedFromForkComposerTextReturned" },
             compact: { supported: true, method: SESSION_METHODS[5], notification: SESSION_EVENT_NOTIFICATION, events: ["compactionStart", "compactionEnd"] },
             import: { supported: false },
-            tree: { supported: true, method: SESSION_METHODS[8], labels: true, labelTimestamps: true, navigate: true, summarize: true, shape: "tauren-tree-items-v1" },
+            tree: { supported: true, method: SESSION_METHODS[8], labels: true, labelTimestamps: true, navigate: true, summarize: true, shape: "kward-tree-items-v1" },
             updates: { supported: false, notification: SESSION_UPDATED_NOTIFICATION }
           },
           turns: {
@@ -383,15 +407,29 @@ module Kward
               queuedTurns: "cancel-before-run",
               runningTurns: "stop-emitting-events-when-possible"
             },
-            eventReplay: { behavior: "recent-in-memory", persisted: false, limit: SessionManager::RECENT_EVENT_LIMIT }
+            eventReplay: { behavior: "recent-in-memory", persisted: false, limit: SessionManager::RECENT_EVENT_LIMIT },
+            options: {
+              supported: true,
+              method: TURN_METHODS[0],
+              fields: ["provider", "model", "reasoningEffort", "allowedTools", "disabledTools", "approvalMode"],
+              perTurnModel: true,
+              perTurnReasoning: true,
+              perTurnToolScope: true
+            },
+            list: { supported: true, method: TURN_METHODS[4], activeMethod: TURN_METHODS[5] },
+            context: {
+              supported: true,
+              method: TURN_METHODS[0],
+              fields: ["activeFile", "openFiles", "selection", "diagnostics"]
+            }
           },
           events: {
             notification: TURN_EVENT_NOTIFICATION,
             assistantText: "assistantDelta",
-            reasoning: { start: false, delta: true, end: false },
+            reasoning: { start: false, delta: true, boundary: true, end: false },
             modelRetry: { supported: true, event: "modelRetry" },
             steering: { supported: @session_manager.in_flight_steer_supported?, event: "turnSteered", mode: @session_manager.in_flight_steer_supported? ? "native" : "unsupported" },
-            tools: { call: true, update: false, result: true, normalizedMetadata: true, diffs: true, changedFiles: true, workspaceGuardrails: workspace_guardrails_enabled?, focusedContext: true, contextBudgetStats: true },
+            tools: { call: true, update: true, result: true, normalizedMetadata: true, diffs: true, changedFiles: true, workspaceGuardrails: workspace_guardrails_enabled?, focusedContext: true, contextBudgetStats: true },
             errors: true,
             sessionUpdates: false
           },
@@ -417,6 +455,20 @@ module Kward
             state: { supported: true },
             stats: { messageCounts: true, tokens: false, cost: false, contextUsage: true, contextUsageEstimated: true }
           },
+          lifecycleHooks: {
+            supported: true,
+            events: Hooks::Catalog.event_names,
+            decisions: Hooks::Decision::VALID_DECISIONS,
+            approvals: { supported: true, via: "toolApproval", requestNotification: TOOL_APPROVAL_NOTIFICATION, answerMethod: TOOL_APPROVAL_METHODS.first },
+            notifications: [HOOK_EVENT_NOTIFICATION, "hook/message"],
+            methods: LIFECYCLE_HOOK_METHODS,
+            auditLog: { supported: true, path: File.join(ConfigFiles.config_dir, "logs", "hooks.jsonl") },
+            commandHooks: true,
+            pluginHooks: true,
+            workspaceHooks: { supported: true, trustRequired: true, trustCommand: "/hooks trust" },
+            httpHooks: { supported: true, protocol: "jsonPost" },
+            asyncHooks: { supported: true, semantics: "observeOnly" }
+          },
           runtimeSettings: {
             supported: true,
             methods: RUNTIME_SETTING_METHODS,
@@ -424,7 +476,7 @@ module Kward
           },
           auth: {
             supported: true,
-            providerFormat: "tauren-auth-v1",
+            providerFormat: "kward-auth-v1",
             methods: AUTH_METHODS,
             oauthProviders: ["openai", "anthropic", "github"],
             unsupportedOAuthProviders: { github: "CLI-only GitHub login for Copilot scaffolding; RPC login is not implemented yet." },
@@ -433,8 +485,21 @@ module Kward
           },
           memory: { supported: true, optIn: true, defaultEnabled: false, autoSummaryDefaultEnabled: false, promptInjection: "interactive", storage: { core: "json", soft: "jsonl", events: "jsonl" }, methods: MEMORY_METHODS },
           workers: workers_capability,
+          stability: { protocol: "stable", compatibility: "additive-fields-unless-protocol-version-changes", experimentalCapabilities: ["workers"] },
           commands: { supported: true, methods: COMMAND_METHODS, method: COMMAND_METHODS[0], runMethod: COMMAND_METHODS[1], sources: ["builtin", "prompt", "skill", "plugin"], executableSources: ["builtin", "plugin"] },
-          mcp: { supported: true, transport: "stdio", config: "mcpServers", exposes: ["tools"], unsupported: ["resources", "prompts", "sampling", "streamableHttp"] },
+          mcp: {
+            supported: true,
+            transport: "stdio",
+            config: "mcpServers",
+            exposes: ["tools"],
+            discovery: {
+              supported: true,
+              methods: TOOL_METHODS + MCP_METHODS,
+              toolMetadata: true,
+              serverStatus: true
+            },
+            unsupported: ["resources", "prompts", "sampling", "streamableHttp"]
+          },
           startupResources: { supported: true, method: STARTUP_RESOURCE_METHODS.first },
           starterPack: { supported: false, reason: "cliOnlyInstallCommand" },
           shell: { supported: false, reason: "interactiveTuiOnly" },
@@ -456,7 +521,7 @@ module Kward
           },
           security: {
             workspaceMutationGuard: "none",
-            toolApproval: "none",
+            toolApproval: { supported: true, defaultMode: "none", modes: ["none", "ask"], requestNotification: TOOL_APPROVAL_NOTIFICATION, answerMethod: TOOL_APPROVAL_METHODS.first },
             canRunShell: true,
             canWriteFiles: true
           },
@@ -564,6 +629,21 @@ module Kward
         raise ArgumentError, e.message == TelemetryStats::USAGE ? e.message : "#{e.message} #{TelemetryStats::USAGE}"
       end
 
+      def lifecycle_hook_logs(params)
+        limit = params.fetch("limit", 20).to_i
+        limit = 20 unless limit.positive?
+        limit = 200 if limit > 200
+        path = File.join(ConfigFiles.config_dir, "logs", "hooks.jsonl")
+        return { path: path, records: [] } unless File.file?(path)
+
+        records = File.readlines(path, chomp: true).last(limit).filter_map do |line|
+          JSON.parse(line)
+        rescue JSON::ParserError
+          nil
+        end
+        { path: path, records: records }
+      end
+
       def commands_list(params)
         @session_manager.runtime_state(session_id: params.fetch("sessionId"))
         prompts = ConfigFiles.prompt_templates(reserved_commands: BUILTIN_SLASH_COMMAND_NAMES).map do |template|