@mrclrchtr/supi-lsp 11.3.0 → 12.0.0

package/src/session/workspace-lsp-runtime.ts

@@ -1,4 +1,5 @@
 import type { CodeQueryResult, CodeRequestControl } from "@mrclrchtr/supi-code-runtime/api";
+import type { CommandEditCaptureResult } from "../client/client-edit-capture.ts";
 import type {
   CodeAction,
   CodeActionContext,
@@ -80,6 +81,14 @@ export interface RoutedMutationResponse<T> {
   readonly reason?: string;
 }
 
+/** One code-action response with the routed server's negotiated kinds. */
+export interface RoutedCodeActionResponse extends RoutedMutationResponse<CodeAction[] | null> {
+  /** Negotiated `codeActionProvider.codeActionKinds`; undefined when the server did not narrow them. */
+  readonly advertisedKinds?: readonly string[];
+  /** Negotiated `executeCommandProvider.commands`; undefined when the server lists none. */
+  readonly advertisedCommands?: readonly string[];
+}
+
 /** Extra protocol context for one explicit code-action request. */
 export interface WorkspaceCodeActionRequestOptions {
   /** Operation-specific CodeActionKind filters. */
@@ -164,7 +173,19 @@ export interface WorkspaceLspRuntime extends WorkspaceLspDiagnosticSurface {
     positionOrRange: Position | Range,
     control?: CodeRequestControl,
     options?: WorkspaceCodeActionRequestOptions,
-  ): Promise<RoutedMutationResponse<CodeAction[] | null> | null>;
+  ): Promise<RoutedCodeActionResponse | null>;
+  /**
+   * Run the command of one command-only code action on the client routed to
+   * `filePath` and capture the single edit the server pushes. No pushed edit is
+   * applied. The runtime enforces eligibility itself: a `refactor*`,
+   * `source.organizeImports*`, or `source.fixAll*` kind, and a command the
+   * server lists when it lists any; other actions are unavailable unrun.
+   */
+  captureCodeActionEdit(
+    filePath: string,
+    action: CodeAction,
+    control?: CodeRequestControl,
+  ): Promise<RoutedMutationResponse<CommandEditCaptureResult | null> | null>;
   getOpenDocumentVersion(filePath: string): number | null;
   /**
    * Wait for file readiness; an explicit refresh may make one shared route