fcp-python 0.1.5__tar.gz → 0.2.0__tar.gz

{fcp_python-0.1.5 → fcp_python-0.2.0}/.claude-plugin/plugin.json

@@ -1,11 +1,11 @@
 {
   "name": "fcp-python",
   "description": "Query and refactor Python codebases through intent-level commands",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "license": "MIT",
   "author": {
     "name": "Scott Meyer"
   },
-  "repository": "https://github.com/aetherwing-io/fcp-python",
+  "repository": "https://github.com/os-tack/fcp-python",
   "keywords": ["python", "pylsp", "refactoring", "code-intelligence", "mcp"]
 }

{fcp_python-0.1.5 → fcp_python-0.2.0}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: fcp-python
-Version: 0.1.5
+Version: 0.2.0
 Summary: Python Code Intelligence FCP — semantic Python code operations for LLMs via pylsp
 Requires-Python: <3.14,>=3.11
 Requires-Dist: fastmcp>=3.0
-Requires-Dist: fcp-core>=0.1.17
+Requires-Dist: fcp-core>=0.2.0
 Requires-Dist: python-lsp-server[rope]>=1.12

{fcp_python-0.1.5 → fcp_python-0.2.0}/README.md

@@ -1,8 +1,8 @@
 # fcp-python
 
-Python Code Intelligence FCP — an MCP server for querying and refactoring Python codebases through intent-level commands.
+Python Code Intelligence FCP — an MCP server for querying Python codebases and performing cross-file symbol rename through intent-level commands.
 
-Wraps [pylsp](https://github.com/python-lsp/python-lsp-server) (python-lsp-server) with [rope](https://github.com/python-rope/rope) for refactoring.
+Wraps [pylsp](https://github.com/python-lsp/python-lsp-server) (python-lsp-server), backed by jedi for navigation/queries and rope for rename. The mutation surface is intentionally narrow: `rename` is the only mutation verb. Everything else (extracting functions, adding imports, etc.) is something the calling LLM should do directly with a normal file edit — routing single-line changes through MCP→DSL→LSP adds ceremony without adding value.
 
 ## Install
 
@@ -24,8 +24,6 @@ python_query    ->  callers process_data
 python_query    ->  map
 python_query    ->  unused
 python          ->  rename Config Settings
-python          ->  extract validate @file:server.py @lines:15-30
-python          ->  import os @file:main.py @line:5
 python_help     ->  (shows reference card)
 ```
 

{fcp_python-0.1.5 → fcp_python-0.2.0}/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "fcp-python"
-version = "0.1.5"
+version = "0.2.0"
 description = "Python Code Intelligence FCP — semantic Python code operations for LLMs via pylsp"
 requires-python = ">=3.11,<3.14"
 dependencies = [
-    "fcp-core>=0.1.17",
+    "fcp-core>=0.2.0",
     "fastmcp>=3.0",
     "python-lsp-server[rope]>=1.12",
 ]

{fcp_python-0.1.5 → fcp_python-0.2.0}/src/fcp_python/bridge.py

@@ -47,8 +47,6 @@ slipstream fcp python_query "unused @file:src/utils.py"
 #### Refactoring
 ```
 slipstream fcp python "rename Config Settings"
-slipstream fcp python "extract validate @file:server.py @lines:15-30"
-slipstream fcp python "import os @file:main.py @line:5"
 ```
 
 #### Selectors
@@ -57,7 +55,6 @@ slipstream fcp python "import os @file:main.py @line:5"
 - `@module:NAME` — filter by module
 - `@kind:KIND` — function, class, method, variable, constant, module, property
 - `@line:N` — filter by line number
-- `@lines:N-M` — line range (for extract)
 - `@decorator:NAME` — filter by decorator (e.g. `@decorator:staticmethod`)
 """
 

fcp_python-0.2.0/src/fcp_python/domain/mutation.py

@@ -0,0 +1,95 @@
+"""Mutation dispatcher and handlers."""
+
+from __future__ import annotations
+
+from fcp_core import VerbRegistry, parse_op, suggest, ParseError
+
+from fcp_python.lsp.types import WorkspaceEdit
+from fcp_python.lsp.workspace_edit import apply_workspace_edit
+from fcp_python.resolver.selectors import parse_selector
+
+from .format import (
+    format_disambiguation,
+    format_error,
+    format_mutation_result,
+)
+from .model import PythonModel
+from .query import resolve_with_fallback
+
+
+async def dispatch_mutation(
+    model: PythonModel,
+    registry: VerbRegistry,
+    input_str: str,
+) -> str:
+    """Dispatch a mutation operation string to the appropriate handler."""
+    op = parse_op(input_str)
+    if isinstance(op, ParseError):
+        return format_error(f"parse error: {op.error}", None)
+
+    if registry.lookup(op.verb) is None:
+        verb_names = [v.verb for v in registry.verbs]
+        suggestion = suggest(op.verb, verb_names)
+        return format_error(f"unknown verb '{op.verb}'.", suggestion)
+
+    if model.lsp_client is None:
+        return format_error("no workspace open. Use python_session open PATH first.", None)
+
+    match op.verb:
+        case "rename":
+            return await handle_rename(model, op.positionals, op.selectors)
+        case _:
+            return format_error(f"verb '{op.verb}' is not a mutation.", None)
+
+
+# -- rename ---------------------------------------------------------------
+
+async def handle_rename(
+    model: PythonModel,
+    positionals: list[str],
+    selectors: list[str],
+) -> str:
+    if len(positionals) < 2:
+        return format_error("rename requires SYMBOL and NEW_NAME.", None)
+    old_name = positionals[0]
+    new_name = positionals[1]
+
+    parsed_selectors = [s for s in (parse_selector(sel) for sel in selectors) if s is not None]
+    resolved = await resolve_with_fallback(model, old_name, parsed_selectors)
+
+    if resolved.is_ambiguous:
+        return format_disambiguation(old_name, resolved.entries)
+    if resolved.is_not_found:
+        return format_error(f"symbol '{old_name}' not found.", None)
+    entry = resolved.entry
+
+    client = model.lsp_client
+    assert client is not None
+
+    params = {
+        "textDocument": {"uri": entry.uri},
+        "position": {
+            "line": entry.selection_range.start.line,
+            "character": entry.selection_range.start.character,
+        },
+        "newName": new_name,
+    }
+
+    try:
+        raw_edit = await client.request("textDocument/rename", params)
+    except Exception as e:
+        return format_error(f"rename failed: {e}", None)
+
+    if raw_edit is None:
+        return format_error("rename returned no edit.", None)
+
+    workspace_edit = WorkspaceEdit.from_dict(raw_edit)
+    try:
+        result = apply_workspace_edit(workspace_edit)
+    except Exception as e:
+        return format_error(f"failed to apply rename: {e}", None)
+
+    return format_mutation_result(
+        "rename", f"{old_name} → {new_name}", result, model.root_uri
+    )
+

{fcp_python-0.1.5 → fcp_python-0.2.0}/src/fcp_python/domain/verbs.py

@@ -24,8 +24,6 @@ def register_query_verbs(registry: VerbRegistry) -> None:
 def register_mutation_verbs(registry: VerbRegistry) -> None:
     registry.register_many([
         VerbSpec(verb="rename", syntax="rename SYMBOL NEW_NAME [@selectors...]", category="mutation"),
-        VerbSpec(verb="extract", syntax="extract FUNC_NAME @file:PATH @lines:N-M", category="mutation"),
-        VerbSpec(verb="import", syntax="import SYMBOL @file:PATH @line:N", category="mutation"),
     ])
 
 

{fcp_python-0.1.5 → fcp_python-0.2.0}/src/fcp_python/main.py

@@ -26,11 +26,13 @@ from fcp_python.lsp.types import PublishDiagnosticsParams, SymbolInformation
 from fcp_python.resolver.index import SymbolEntry, SymbolIndex
 
 mcp = FastMCP(
-    "python-fcp",
+    "fcp-python",
     instructions=(
-        "FCP Python server for querying Python codebases via pylsp. "
-        "Use python_session to open a workspace, python_query for read-only queries, "
-        "and python_help for the reference card."
+        "FCP Python server for querying and refactoring Python codebases via pylsp. "
+        "Use python_session to open a workspace directory containing Python files, "
+        "python_query for read-only queries like finding definitions, references, "
+        "diagnostics, and symbols, python for refactoring operations, and python_help "
+        "for the full verb reference. Start every interaction with python_session."
     ),
 )
 
@@ -53,9 +55,7 @@ _registry = _make_registry()
 @mcp.tool(
     description=(
         "Execute Python mutation operations. Examples: "
-        "'rename Config Settings', "
-        "'extract validate @file:server.py @lines:15-30', "
-        "'import os @file:main.py @line:5'"
+        "'rename Config Settings'"
     )
 )
 async def python(ops: list[str]) -> str:
@@ -106,13 +106,10 @@ async def python_help() -> str:
             "  @kind:KIND      — filter by symbol kind (function, class, method, variable, ...)\n"
             "  @module:NAME    — filter by module\n"
             "  @line:N         — filter by line number\n"
-            "  @lines:N-M      — line range for extract\n"
             "  @decorator:NAME — filter by decorator"
         ),
         "Mutation Examples": (
-            '  python ["rename Config Settings"]              — cross-file semantic rename\n'
-            '  python ["extract validate @file:server.py @lines:15-30"] — extract function\n'
-            '  python ["import os @file:main.py @line:5"]     — add missing import'
+            '  python ["rename Config Settings"]              — cross-file semantic rename'
         ),
     }
     return _registry.generate_reference_card(extra)

{fcp_python-0.1.5 → fcp_python-0.2.0}/tests/test_mutation.py

@@ -5,7 +5,7 @@ import pytest
 from fcp_core import VerbRegistry
 
 from fcp_python.domain.model import PythonModel
-from fcp_python.domain.mutation import dispatch_mutation, file_uri
+from fcp_python.domain.mutation import dispatch_mutation
 from fcp_python.domain.verbs import (
     register_mutation_verbs,
     register_query_verbs,
@@ -58,26 +58,10 @@ async def test_dispatch_rename_recognized():
 
 
 @pytest.mark.asyncio
-async def test_dispatch_extract_recognized():
+async def test_dispatch_mutation_unrecognized_removed_verb():
+    """extract/import were removed as broken/low-value; verify they're rejected cleanly."""
     model = _make_model()
     reg = _make_registry()
-    result = await dispatch_mutation(model, reg, "extract validate @file:server.py @lines:15-30")
-    assert "no workspace open" in result
-
-
-@pytest.mark.asyncio
-async def test_dispatch_import_recognized():
-    model = _make_model()
-    reg = _make_registry()
-    result = await dispatch_mutation(model, reg, "import os @file:main.py @line:5")
-    assert "no workspace open" in result
-
-
-def test_file_uri_absolute():
-    model = _make_model()
-    assert file_uri(model, "file:///other/path.py") == "file:///other/path.py"
-
-
-def test_file_uri_relative():
-    model = _make_model()
-    assert file_uri(model, "src/main.py") == "file:///project/src/main.py"
+    for verb in ("extract", "import"):
+        result = await dispatch_mutation(model, reg, f"{verb} foo @file:server.py")
+        assert "unknown verb" in result

{fcp_python-0.1.5 → fcp_python-0.2.0}/tests/test_verbs.py

@@ -38,14 +38,14 @@ def test_session_verb_count():
 def test_register_mutation_verbs():
     reg = VerbRegistry()
     register_mutation_verbs(reg)
-    for name in ["rename", "extract", "import"]:
+    for name in ["rename"]:
         assert reg.lookup(name) is not None, f"missing mutation verb: {name}"
 
 
 def test_mutation_verb_count():
     reg = VerbRegistry()
     register_mutation_verbs(reg)
-    assert len(reg.verbs) == 3
+    assert len(reg.verbs) == 1
 
 
 def test_reference_card_has_categories():
@@ -65,4 +65,4 @@ def test_all_verbs_registered():
     register_query_verbs(reg)
     register_mutation_verbs(reg)
     register_session_verbs(reg)
-    assert len(reg.verbs) == 17  # 11 query + 3 mutation + 3 session
+    assert len(reg.verbs) == 15  # 11 query + 1 mutation + 3 session

{fcp_python-0.1.5 → fcp_python-0.2.0}/uv.lock

@@ -374,19 +374,19 @@ wheels = [
 
 [[package]]
 name = "fcp-core"
-version = "0.1.17"
+version = "0.2.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "mcp" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/66/58/1e99ab092a1cafba7c9ef91a422284bcb22501aed79e071b75158a3cee92/fcp_core-0.1.17.tar.gz", hash = "sha256:53eb542b0b8b5a308a0a6db41e49e7996f19a27a92d52e73c783807fb60bd3a5", size = 49364, upload-time = "2026-03-05T16:17:49.872Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/e1/89/39e9544fdf8126a7e7377f0936f4f4aca401cb63e749ff686a4550032a75/fcp_core-0.2.0.tar.gz", hash = "sha256:1179bf6f9be0cf2308bb4423b5daafe2e1e36c146216f82bd8097382859803a0", size = 53777, upload-time = "2026-07-06T15:51:53.009Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/e8/17/a3acff00705a94854513265861d03b406fb6b545eeee2ebca3aeb1204926/fcp_core-0.1.17-py3-none-any.whl", hash = "sha256:00234863120164c0cdc3f801d6d69ccb0881d14f4a35fb765b209614d448025f", size = 16935, upload-time = "2026-03-05T16:17:48.458Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/cf/d9366956f56f85e8efd6fbe8d1b3c6e4f65b54b2f497f440558620970298/fcp_core-0.2.0-py3-none-any.whl", hash = "sha256:1a1430a9bc4e4c8f7557113e2104290e3d7b2c2f9a61de617ab73e4674884fae", size = 17390, upload-time = "2026-07-06T15:51:51.882Z" },
 ]
 
 [[package]]
 name = "fcp-python"
-version = "0.1.5"
+version = "0.2.0"
 source = { editable = "." }
 dependencies = [
     { name = "fastmcp" },
@@ -405,7 +405,7 @@ dev = [
 [package.metadata]
 requires-dist = [
     { name = "fastmcp", specifier = ">=3.0" },
-    { name = "fcp-core", specifier = ">=0.1.17" },
+    { name = "fcp-core", specifier = ">=0.2.0" },
     { name = "python-lsp-server", extras = ["rope"], specifier = ">=1.12" },
 ]
 

fcp_python-0.1.5/src/fcp_python/domain/mutation.py

@@ -1,393 +0,0 @@
-"""Mutation dispatcher and handlers."""
-
-from __future__ import annotations
-
-from pathlib import Path
-from urllib.parse import unquote, urlparse
-
-from fcp_core import VerbRegistry, parse_op, suggest, ParseError
-
-from fcp_python.lsp.types import (
-    CodeAction,
-    WorkspaceEdit,
-)
-from fcp_python.lsp.workspace_edit import apply_workspace_edit, ApplyResult
-from fcp_python.resolver.selectors import (
-    SelectorType,
-    parse_line_range,
-    parse_selector,
-)
-
-from .format import (
-    format_code_action_choices,
-    format_disambiguation,
-    format_error,
-    format_mutation_result,
-)
-from .model import PythonModel
-from .query import resolve_with_fallback
-
-
-async def dispatch_mutation(
-    model: PythonModel,
-    registry: VerbRegistry,
-    input_str: str,
-) -> str:
-    """Dispatch a mutation operation string to the appropriate handler."""
-    op = parse_op(input_str)
-    if isinstance(op, ParseError):
-        return format_error(f"parse error: {op.error}", None)
-
-    if registry.lookup(op.verb) is None:
-        verb_names = [v.verb for v in registry.verbs]
-        suggestion = suggest(op.verb, verb_names)
-        return format_error(f"unknown verb '{op.verb}'.", suggestion)
-
-    if model.lsp_client is None:
-        return format_error("no workspace open. Use python_session open PATH first.", None)
-
-    match op.verb:
-        case "rename":
-            return await handle_rename(model, op.positionals, op.selectors)
-        case "extract":
-            return await handle_extract(model, op.positionals, op.selectors)
-        case "import":
-            return await handle_import(model, op.positionals, op.selectors)
-        case _:
-            return format_error(f"verb '{op.verb}' is not a mutation.", None)
-
-
-async def ensure_file_synced(model: PythonModel, uri: str) -> None:
-    """Open a file in LSP if not already open, to sync with disk."""
-    client = model.lsp_client
-    if client is None:
-        return
-    parsed = urlparse(uri)
-    if parsed.scheme != "file":
-        return
-    path = Path(unquote(parsed.path))
-    text = path.read_text()
-    await client.did_open(uri, text)
-
-
-async def sync_after_edit(model: PythonModel, result: ApplyResult) -> None:
-    """After applying a WorkspaceEdit, sync all changed files with LSP."""
-    for uri, _ in result.files_changed:
-        await ensure_file_synced(model, uri)
-    for uri in result.files_created:
-        await ensure_file_synced(model, uri)
-
-
-def file_uri(model: PythonModel, file_value: str) -> str:
-    """Build a file URI from a selector value, using model root as base."""
-    if file_value.startswith("file://"):
-        return file_value
-    return f"{model.root_uri.rstrip('/')}/{file_value}"
-
-
-# -- rename ---------------------------------------------------------------
-
-async def handle_rename(
-    model: PythonModel,
-    positionals: list[str],
-    selectors: list[str],
-) -> str:
-    if len(positionals) < 2:
-        return format_error("rename requires SYMBOL and NEW_NAME.", None)
-    old_name = positionals[0]
-    new_name = positionals[1]
-
-    parsed_selectors = [s for s in (parse_selector(sel) for sel in selectors) if s is not None]
-    resolved = await resolve_with_fallback(model, old_name, parsed_selectors)
-
-    if resolved.is_ambiguous:
-        return format_disambiguation(old_name, resolved.entries)
-    if resolved.is_not_found:
-        return format_error(f"symbol '{old_name}' not found.", None)
-    entry = resolved.entry
-
-    client = model.lsp_client
-    assert client is not None
-
-    params = {
-        "textDocument": {"uri": entry.uri},
-        "position": {
-            "line": entry.selection_range.start.line,
-            "character": entry.selection_range.start.character,
-        },
-        "newName": new_name,
-    }
-
-    try:
-        raw_edit = await client.request("textDocument/rename", params)
-    except Exception as e:
-        return format_error(f"rename failed: {e}", None)
-
-    if raw_edit is None:
-        return format_error("rename returned no edit.", None)
-
-    workspace_edit = WorkspaceEdit.from_dict(raw_edit)
-    try:
-        result = apply_workspace_edit(workspace_edit)
-    except Exception as e:
-        return format_error(f"failed to apply rename: {e}", None)
-
-    return format_mutation_result(
-        "rename", f"{old_name} → {new_name}", result, model.root_uri
-    )
-
-
-# -- extract ---------------------------------------------------------------
-
-async def handle_extract(
-    model: PythonModel,
-    positionals: list[str],
-    selectors: list[str],
-) -> str:
-    if not positionals:
-        return format_error("extract requires FUNC_NAME.", None)
-    func_name = positionals[0]
-
-    parsed_selectors = [s for s in (parse_selector(sel) for sel in selectors) if s is not None]
-
-    file_sel = next((s for s in parsed_selectors if s.selector_type == SelectorType.FILE), None)
-    lines_sel = next((s for s in parsed_selectors if s.selector_type == SelectorType.LINES), None)
-
-    if file_sel is None:
-        return format_error("extract requires @file:PATH selector.", None)
-    if lines_sel is None:
-        return format_error("extract requires @lines:N-M selector.", None)
-
-    line_range = parse_line_range(lines_sel.value)
-    if line_range is None:
-        return format_error(
-            f"invalid line range '{lines_sel.value}'. Use @lines:N-M.", None
-        )
-    start_line, end_line = line_range
-
-    uri = file_uri(model, file_sel.value)
-    # Convert 1-indexed user lines to 0-indexed LSP
-    lsp_start = start_line - 1 if start_line > 0 else start_line
-    lsp_end = end_line - 1 if end_line > 0 else end_line
-
-    client = model.lsp_client
-    assert client is not None
-
-    try:
-        await ensure_file_synced(model, uri)
-    except Exception as e:
-        return format_error(f"extract: {e}", None)
-
-    params = {
-        "textDocument": {"uri": uri},
-        "range": {
-            "start": {"line": lsp_start, "character": 0},
-            "end": {"line": lsp_end, "character": 999},
-        },
-        "context": {
-            "diagnostics": [],
-            "only": ["refactor.extract.function", "refactor.extract"],
-            "triggerKind": 1,
-        },
-    }
-
-    try:
-        raw_actions = await client.request("textDocument/codeAction", params)
-    except Exception as e:
-        return format_error(f"extract failed: {e}", None)
-
-    if not raw_actions:
-        raw_actions = []
-
-    actions = [CodeAction.from_dict(a) for a in raw_actions]
-    extract_actions = [
-        a for a in actions
-        if a.kind and a.kind.startswith("refactor.extract")
-    ]
-
-    if not extract_actions:
-        return format_error("no extract action available for the selected range.", None)
-
-    if len(extract_actions) == 1:
-        action = extract_actions[0]
-    else:
-        # Prefer "Extract into function" over others
-        func_action = next(
-            (a for a in extract_actions if "function" in a.title.lower()), None
-        )
-        if func_action:
-            action = func_action
-        else:
-            preferred = next((a for a in extract_actions if a.is_preferred), None)
-            if preferred:
-                action = preferred
-            else:
-                return format_code_action_choices(extract_actions)
-
-    if action.edit is None:
-        return format_error("extract action has no edit.", None)
-
-    try:
-        apply_result = apply_workspace_edit(action.edit)
-    except Exception as e:
-        return format_error(f"failed to apply extract: {e}", None)
-
-    # Sync changed files
-    try:
-        await sync_after_edit(model, apply_result)
-    except Exception:
-        pass
-
-    # Follow-up rename: pylsp/rope generates a placeholder name.
-    rename_result = await _follow_up_rename(model, uri, func_name)
-
-    if rename_result is not None:
-        return format_mutation_result("extract", func_name, rename_result, model.root_uri)
-    return format_mutation_result("extract", func_name, apply_result, model.root_uri)
-
-
-async def _follow_up_rename(
-    model: PythonModel,
-    uri: str,
-    desired_name: str,
-) -> ApplyResult | None:
-    """After extract, rename the generated function to the user's desired name."""
-    client = model.lsp_client
-    if client is None:
-        return None
-
-    parsed = urlparse(uri)
-    if parsed.scheme != "file":
-        return None
-    path = Path(unquote(parsed.path))
-    try:
-        content = path.read_text()
-    except Exception:
-        return None
-
-    # Rope generates "extracted_function" or similar placeholder names
-    for generated_name in ["extracted_function", "extracted_method", "extracted_variable"]:
-        fn_pattern = f"def {generated_name}"
-        byte_offset = content.find(fn_pattern)
-        if byte_offset >= 0:
-            name_offset = byte_offset + 4  # "def ".len()
-            line = content[:name_offset].count("\n")
-            last_newline = content.rfind("\n", 0, name_offset)
-            col = name_offset - (last_newline + 1) if last_newline >= 0 else name_offset
-
-            params = {
-                "textDocument": {"uri": uri},
-                "position": {"line": line, "character": col},
-                "newName": desired_name,
-            }
-            try:
-                raw_edit = await client.request("textDocument/rename", params)
-                if raw_edit:
-                    workspace_edit = WorkspaceEdit.from_dict(raw_edit)
-                    return apply_workspace_edit(workspace_edit)
-            except Exception:
-                pass
-            break
-
-    return None
-
-
-# -- import ---------------------------------------------------------------
-
-async def handle_import(
-    model: PythonModel,
-    positionals: list[str],
-    selectors: list[str],
-) -> str:
-    if not positionals:
-        return format_error("import requires SYMBOL.", None)
-    symbol_name = positionals[0]
-
-    parsed_selectors = [s for s in (parse_selector(sel) for sel in selectors) if s is not None]
-
-    file_sel = next((s for s in parsed_selectors if s.selector_type == SelectorType.FILE), None)
-    line_sel = next((s for s in parsed_selectors if s.selector_type == SelectorType.LINE), None)
-
-    if file_sel is None:
-        return format_error("import requires @file:PATH selector.", None)
-    if line_sel is None:
-        return format_error("import requires @line:N selector.", None)
-
-    try:
-        line_num = int(line_sel.value)
-    except ValueError:
-        return format_error("invalid line number.", None)
-
-    uri = file_uri(model, file_sel.value)
-    lsp_line = line_num - 1 if line_num > 0 else line_num
-
-    client = model.lsp_client
-    assert client is not None
-
-    try:
-        await ensure_file_synced(model, uri)
-    except Exception as e:
-        return format_error(f"import: {e}", None)
-
-    params = {
-        "textDocument": {"uri": uri},
-        "range": {
-            "start": {"line": lsp_line, "character": 0},
-            "end": {"line": lsp_line, "character": 999},
-        },
-        "context": {
-            "diagnostics": [],
-            "only": ["quickfix", "source", "source.organizeImports"],
-            "triggerKind": 1,
-        },
-    }
-
-    try:
-        raw_actions = await client.request("textDocument/codeAction", params)
-    except Exception as e:
-        return format_error(f"import failed: {e}", None)
-
-    if not raw_actions:
-        raw_actions = []
-
-    actions = [CodeAction.from_dict(a) for a in raw_actions]
-    symbol_lower = symbol_name.lower()
-
-    import_actions = [
-        a for a in actions
-        if (
-            (a.kind and (
-                "import" in a.kind
-                or a.kind == "quickfix"
-                or a.kind.startswith("source")
-            ))
-            or "import" in a.title.lower()
-            or "use " in a.title.lower()
-        )
-        and symbol_lower in a.title.lower()
-    ]
-
-    if not import_actions:
-        return format_error(
-            f"no import action for '{symbol_name}' at {file_sel.value}:{line_num}.",
-            None,
-        )
-
-    if len(import_actions) == 1:
-        action = import_actions[0]
-    else:
-        preferred = next((a for a in import_actions if a.is_preferred), None)
-        if preferred:
-            action = preferred
-        else:
-            return format_code_action_choices(import_actions)
-
-    if action.edit is None:
-        return format_error("import action has no edit.", None)
-
-    try:
-        result = apply_workspace_edit(action.edit)
-    except Exception as e:
-        return format_error(f"failed to apply import: {e}", None)
-
-    return format_mutation_result("import", symbol_name, result, model.root_uri)