PyPI - superqode - Versions diffs - 0.1.5__py3-none-any.whl - Mend

superqode 0.1.5__py3-none-any.whl

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 (288) hide show

superqode/__init__.py +33 -0
superqode/acp/__init__.py +23 -0
superqode/acp/client.py +913 -0
superqode/acp/permission_screen.py +457 -0
superqode/acp/types.py +480 -0
superqode/acp_discovery.py +856 -0
superqode/agent/__init__.py +22 -0
superqode/agent/edit_strategies.py +334 -0
superqode/agent/loop.py +892 -0
superqode/agent/qe_report_templates.py +39 -0
superqode/agent/system_prompts.py +353 -0
superqode/agent_output.py +721 -0
superqode/agent_stream.py +953 -0
superqode/agents/__init__.py +59 -0
superqode/agents/acp_registry.py +305 -0
superqode/agents/client.py +249 -0
superqode/agents/data/augmentcode.com.toml +51 -0
superqode/agents/data/cagent.dev.toml +51 -0
superqode/agents/data/claude.com.toml +60 -0
superqode/agents/data/codeassistant.dev.toml +51 -0
superqode/agents/data/codex.openai.com.toml +57 -0
superqode/agents/data/fastagent.ai.toml +66 -0
superqode/agents/data/geminicli.com.toml +77 -0
superqode/agents/data/goose.block.xyz.toml +54 -0
superqode/agents/data/junie.jetbrains.com.toml +56 -0
superqode/agents/data/kimi.moonshot.cn.toml +57 -0
superqode/agents/data/llmlingagent.dev.toml +51 -0
superqode/agents/data/molt.bot.toml +49 -0
superqode/agents/data/opencode.ai.toml +60 -0
superqode/agents/data/stakpak.dev.toml +51 -0
superqode/agents/data/vtcode.dev.toml +51 -0
superqode/agents/discovery.py +266 -0
superqode/agents/messaging.py +160 -0
superqode/agents/persona.py +166 -0
superqode/agents/registry.py +421 -0
superqode/agents/schema.py +72 -0
superqode/agents/unified.py +367 -0
superqode/app/__init__.py +111 -0
superqode/app/constants.py +314 -0
superqode/app/css.py +366 -0
superqode/app/models.py +118 -0
superqode/app/suggester.py +125 -0
superqode/app/widgets.py +1591 -0
superqode/app_enhanced.py +399 -0
superqode/app_main.py +17187 -0
superqode/approval.py +312 -0
superqode/atomic.py +296 -0
superqode/commands/__init__.py +1 -0
superqode/commands/acp.py +965 -0
superqode/commands/agents.py +180 -0
superqode/commands/auth.py +278 -0
superqode/commands/config.py +374 -0
superqode/commands/init.py +826 -0
superqode/commands/providers.py +819 -0
superqode/commands/qe.py +1145 -0
superqode/commands/roles.py +380 -0
superqode/commands/serve.py +172 -0
superqode/commands/suggestions.py +127 -0
superqode/commands/superqe.py +460 -0
superqode/config/__init__.py +51 -0
superqode/config/loader.py +812 -0
superqode/config/schema.py +498 -0
superqode/core/__init__.py +111 -0
superqode/core/roles.py +281 -0
superqode/danger.py +386 -0
superqode/data/superqode-template.yaml +1522 -0
superqode/design_system.py +1080 -0
superqode/dialogs/__init__.py +6 -0
superqode/dialogs/base.py +39 -0
superqode/dialogs/model.py +130 -0
superqode/dialogs/provider.py +870 -0
superqode/diff_view.py +919 -0
superqode/enterprise.py +21 -0
superqode/evaluation/__init__.py +25 -0
superqode/evaluation/adapters.py +93 -0
superqode/evaluation/behaviors.py +89 -0
superqode/evaluation/engine.py +209 -0
superqode/evaluation/scenarios.py +96 -0
superqode/execution/__init__.py +36 -0
superqode/execution/linter.py +538 -0
superqode/execution/modes.py +347 -0
superqode/execution/resolver.py +283 -0
superqode/execution/runner.py +642 -0
superqode/file_explorer.py +811 -0
superqode/file_viewer.py +471 -0
superqode/flash.py +183 -0
superqode/guidance/__init__.py +58 -0
superqode/guidance/config.py +203 -0
superqode/guidance/prompts.py +71 -0
superqode/harness/__init__.py +54 -0
superqode/harness/accelerator.py +291 -0
superqode/harness/config.py +319 -0
superqode/harness/validator.py +147 -0
superqode/history.py +279 -0
superqode/integrations/superopt_runner.py +124 -0
superqode/logging/__init__.py +49 -0
superqode/logging/adapters.py +219 -0
superqode/logging/formatter.py +923 -0
superqode/logging/integration.py +341 -0
superqode/logging/sinks.py +170 -0
superqode/logging/unified_log.py +417 -0
superqode/lsp/__init__.py +26 -0
superqode/lsp/client.py +544 -0
superqode/main.py +1069 -0
superqode/mcp/__init__.py +89 -0
superqode/mcp/auth_storage.py +380 -0
superqode/mcp/client.py +1236 -0
superqode/mcp/config.py +319 -0
superqode/mcp/integration.py +337 -0
superqode/mcp/oauth.py +436 -0
superqode/mcp/oauth_callback.py +385 -0
superqode/mcp/types.py +290 -0
superqode/memory/__init__.py +31 -0
superqode/memory/feedback.py +342 -0
superqode/memory/store.py +522 -0
superqode/notifications.py +369 -0
superqode/optimization/__init__.py +5 -0
superqode/optimization/config.py +33 -0
superqode/permissions/__init__.py +25 -0
superqode/permissions/rules.py +488 -0
superqode/plan.py +323 -0
superqode/providers/__init__.py +33 -0
superqode/providers/gateway/__init__.py +165 -0
superqode/providers/gateway/base.py +228 -0
superqode/providers/gateway/litellm_gateway.py +1170 -0
superqode/providers/gateway/openresponses_gateway.py +436 -0
superqode/providers/health.py +297 -0
superqode/providers/huggingface/__init__.py +74 -0
superqode/providers/huggingface/downloader.py +472 -0
superqode/providers/huggingface/endpoints.py +442 -0
superqode/providers/huggingface/hub.py +531 -0
superqode/providers/huggingface/inference.py +394 -0
superqode/providers/huggingface/transformers_runner.py +516 -0
superqode/providers/local/__init__.py +100 -0
superqode/providers/local/base.py +438 -0
superqode/providers/local/discovery.py +418 -0
superqode/providers/local/lmstudio.py +256 -0
superqode/providers/local/mlx.py +457 -0
superqode/providers/local/ollama.py +486 -0
superqode/providers/local/sglang.py +268 -0
superqode/providers/local/tgi.py +260 -0
superqode/providers/local/tool_support.py +477 -0
superqode/providers/local/vllm.py +258 -0
superqode/providers/manager.py +1338 -0
superqode/providers/models.py +1016 -0
superqode/providers/models_dev.py +578 -0
superqode/providers/openresponses/__init__.py +87 -0
superqode/providers/openresponses/converters/__init__.py +17 -0
superqode/providers/openresponses/converters/messages.py +343 -0
superqode/providers/openresponses/converters/tools.py +268 -0
superqode/providers/openresponses/schema/__init__.py +56 -0
superqode/providers/openresponses/schema/models.py +585 -0
superqode/providers/openresponses/streaming/__init__.py +5 -0
superqode/providers/openresponses/streaming/parser.py +338 -0
superqode/providers/openresponses/tools/__init__.py +21 -0
superqode/providers/openresponses/tools/apply_patch.py +352 -0
superqode/providers/openresponses/tools/code_interpreter.py +290 -0
superqode/providers/openresponses/tools/file_search.py +333 -0
superqode/providers/openresponses/tools/mcp_adapter.py +252 -0
superqode/providers/registry.py +716 -0
superqode/providers/usage.py +332 -0
superqode/pure_mode.py +384 -0
superqode/qr/__init__.py +23 -0
superqode/qr/dashboard.py +781 -0
superqode/qr/generator.py +1018 -0
superqode/qr/templates.py +135 -0
superqode/safety/__init__.py +41 -0
superqode/safety/sandbox.py +413 -0
superqode/safety/warnings.py +256 -0
superqode/server/__init__.py +33 -0
superqode/server/lsp_server.py +775 -0
superqode/server/web.py +250 -0
superqode/session/__init__.py +25 -0
superqode/session/persistence.py +580 -0
superqode/session/sharing.py +477 -0
superqode/session.py +475 -0
superqode/sidebar.py +2991 -0
superqode/stream_view.py +648 -0
superqode/styles/__init__.py +3 -0
superqode/superqe/__init__.py +184 -0
superqode/superqe/acp_runner.py +1064 -0
superqode/superqe/constitution/__init__.py +62 -0
superqode/superqe/constitution/evaluator.py +308 -0
superqode/superqe/constitution/loader.py +432 -0
superqode/superqe/constitution/schema.py +250 -0
superqode/superqe/events.py +591 -0
superqode/superqe/frameworks/__init__.py +65 -0
superqode/superqe/frameworks/base.py +234 -0
superqode/superqe/frameworks/e2e.py +263 -0
superqode/superqe/frameworks/executor.py +237 -0
superqode/superqe/frameworks/javascript.py +409 -0
superqode/superqe/frameworks/python.py +373 -0
superqode/superqe/frameworks/registry.py +92 -0
superqode/superqe/mcp_tools/__init__.py +47 -0
superqode/superqe/mcp_tools/core_tools.py +418 -0
superqode/superqe/mcp_tools/registry.py +230 -0
superqode/superqe/mcp_tools/testing_tools.py +167 -0
superqode/superqe/noise.py +89 -0
superqode/superqe/orchestrator.py +778 -0
superqode/superqe/roles.py +609 -0
superqode/superqe/session.py +713 -0
superqode/superqe/skills/__init__.py +57 -0
superqode/superqe/skills/base.py +106 -0
superqode/superqe/skills/core_skills.py +899 -0
superqode/superqe/skills/registry.py +90 -0
superqode/superqe/verifier.py +101 -0
superqode/superqe_cli.py +76 -0
superqode/tool_call.py +358 -0
superqode/tools/__init__.py +93 -0
superqode/tools/agent_tools.py +496 -0
superqode/tools/base.py +324 -0
superqode/tools/batch_tool.py +133 -0
superqode/tools/diagnostics.py +311 -0
superqode/tools/edit_tools.py +653 -0
superqode/tools/enhanced_base.py +515 -0
superqode/tools/file_tools.py +269 -0
superqode/tools/file_tracking.py +45 -0
superqode/tools/lsp_tools.py +610 -0
superqode/tools/network_tools.py +350 -0
superqode/tools/permissions.py +400 -0
superqode/tools/question_tool.py +324 -0
superqode/tools/search_tools.py +598 -0
superqode/tools/shell_tools.py +259 -0
superqode/tools/todo_tools.py +121 -0
superqode/tools/validation.py +80 -0
superqode/tools/web_tools.py +639 -0
superqode/tui.py +1152 -0
superqode/tui_integration.py +875 -0
superqode/tui_widgets/__init__.py +27 -0
superqode/tui_widgets/widgets/__init__.py +18 -0
superqode/tui_widgets/widgets/progress.py +185 -0
superqode/tui_widgets/widgets/tool_display.py +188 -0
superqode/undo_manager.py +574 -0
superqode/utils/__init__.py +5 -0
superqode/utils/error_handling.py +323 -0
superqode/utils/fuzzy.py +257 -0
superqode/widgets/__init__.py +477 -0
superqode/widgets/agent_collab.py +390 -0
superqode/widgets/agent_store.py +936 -0
superqode/widgets/agent_switcher.py +395 -0
superqode/widgets/animation_manager.py +284 -0
superqode/widgets/code_context.py +356 -0
superqode/widgets/command_palette.py +412 -0
superqode/widgets/connection_status.py +537 -0
superqode/widgets/conversation_history.py +470 -0
superqode/widgets/diff_indicator.py +155 -0
superqode/widgets/enhanced_status_bar.py +385 -0
superqode/widgets/enhanced_toast.py +476 -0
superqode/widgets/file_browser.py +809 -0
superqode/widgets/file_reference.py +585 -0
superqode/widgets/issue_timeline.py +340 -0
superqode/widgets/leader_key.py +264 -0
superqode/widgets/mode_switcher.py +445 -0
superqode/widgets/model_picker.py +234 -0
superqode/widgets/permission_preview.py +1205 -0
superqode/widgets/prompt.py +358 -0
superqode/widgets/provider_connect.py +725 -0
superqode/widgets/pty_shell.py +587 -0
superqode/widgets/qe_dashboard.py +321 -0
superqode/widgets/resizable_sidebar.py +377 -0
superqode/widgets/response_changes.py +218 -0
superqode/widgets/response_display.py +528 -0
superqode/widgets/rich_tool_display.py +613 -0
superqode/widgets/sidebar_panels.py +1180 -0
superqode/widgets/slash_complete.py +356 -0
superqode/widgets/split_view.py +612 -0
superqode/widgets/status_bar.py +273 -0
superqode/widgets/superqode_display.py +786 -0
superqode/widgets/thinking_display.py +815 -0
superqode/widgets/throbber.py +87 -0
superqode/widgets/toast.py +206 -0
superqode/widgets/unified_output.py +1073 -0
superqode/workspace/__init__.py +75 -0
superqode/workspace/artifacts.py +472 -0
superqode/workspace/coordinator.py +353 -0
superqode/workspace/diff_tracker.py +429 -0
superqode/workspace/git_guard.py +373 -0
superqode/workspace/git_snapshot.py +526 -0
superqode/workspace/manager.py +750 -0
superqode/workspace/snapshot.py +357 -0
superqode/workspace/watcher.py +535 -0
superqode/workspace/worktree.py +440 -0
superqode-0.1.5.dist-info/METADATA +204 -0
superqode-0.1.5.dist-info/RECORD +288 -0
superqode-0.1.5.dist-info/WHEEL +5 -0
superqode-0.1.5.dist-info/entry_points.txt +3 -0
superqode-0.1.5.dist-info/licenses/LICENSE +648 -0
superqode-0.1.5.dist-info/top_level.txt +1 -0

superqode/mcp/oauth_callback.py ADDED Viewed

@@ -0,0 +1,385 @@
+"""
+MCP OAuth Callback Server - Local HTTP Server for OAuth Redirects.
+Implements a lightweight HTTP server to handle OAuth callbacks
+during the authorization flow.
+Features:
+- Single-use callback handling
+- Timeout support
+- Success/error page display
+- Thread-safe operation
+"""
+from __future__ import annotations
+import asyncio
+import logging
+import urllib.parse
+from dataclasses import dataclass, field
+from http.server import HTTPServer, BaseHTTPRequestHandler
+from typing import Dict, Optional
+import threading
+logger = logging.getLogger(__name__)
+# HTML templates for callback responses
+SUCCESS_HTML = """<!DOCTYPE html>
+<html>
+<head>
+    <title>Authorization Successful</title>
+    <style>
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            display: flex;
+            justify-content: center;
+            align-items: center;
+            height: 100vh;
+            margin: 0;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+        }
+        .container {
+            text-align: center;
+            padding: 40px;
+            background: white;
+            border-radius: 12px;
+            box-shadow: 0 4px 20px rgba(0,0,0,0.15);
+            max-width: 400px;
+        }
+        .icon {
+            font-size: 64px;
+            margin-bottom: 20px;
+        }
+        h1 {
+            color: #22c55e;
+            margin: 0 0 10px 0;
+            font-size: 24px;
+        }
+        p {
+            color: #666;
+            margin: 0;
+            font-size: 14px;
+        }
+        .close-msg {
+            margin-top: 20px;
+            color: #999;
+            font-size: 12px;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="icon">✓</div>
+        <h1>Authorization Successful</h1>
+        <p>You have been authenticated with the MCP server.</p>
+        <p class="close-msg">You can close this window and return to SuperQode.</p>
+    </div>
+    <script>
+        // Try to close the window after a delay
+        setTimeout(function() {
+            window.close();
+        }, 3000);
+    </script>
+</body>
+</html>"""
+ERROR_HTML = """<!DOCTYPE html>
+<html>
+<head>
+    <title>Authorization Failed</title>
+    <style>
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            display: flex;
+            justify-content: center;
+            align-items: center;
+            height: 100vh;
+            margin: 0;
+            background: linear-gradient(135deg, #f093fb 0%, #f5576c 100%);
+        }
+        .container {
+            text-align: center;
+            padding: 40px;
+            background: white;
+            border-radius: 12px;
+            box-shadow: 0 4px 20px rgba(0,0,0,0.15);
+            max-width: 400px;
+        }
+        .icon {
+            font-size: 64px;
+            margin-bottom: 20px;
+        }
+        h1 {
+            color: #ef4444;
+            margin: 0 0 10px 0;
+            font-size: 24px;
+        }
+        p {
+            color: #666;
+            margin: 0;
+            font-size: 14px;
+        }
+        .error-detail {
+            margin-top: 15px;
+            padding: 10px;
+            background: #fef2f2;
+            border-radius: 6px;
+            color: #b91c1c;
+            font-size: 12px;
+            font-family: monospace;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="icon">✕</div>
+        <h1>Authorization Failed</h1>
+        <p>There was a problem authenticating with the MCP server.</p>
+        <div class="error-detail">{error}</div>
+    </div>
+</body>
+</html>"""
+@dataclass
+class CallbackResult:
+    """Result from an OAuth callback."""
+    code: Optional[str] = None
+    state: Optional[str] = None
+    error: Optional[str] = None
+    error_description: Optional[str] = None
+class OAuthCallbackHandler(BaseHTTPRequestHandler):
+    """HTTP request handler for OAuth callbacks."""
+    # Class-level storage for callback results
+    callback_results: Dict[str, asyncio.Future] = {}
+    server_lock = threading.Lock()
+    def log_message(self, format: str, *args) -> None:
+        """Suppress default logging."""
+        logger.debug(format % args)
+    def do_GET(self) -> None:
+        """Handle GET request (OAuth callback)."""
+        # Parse the URL
+        parsed = urllib.parse.urlparse(self.path)
+        # Only handle the callback path
+        if parsed.path != "/mcp/oauth/callback":
+            self.send_error(404, "Not Found")
+            return
+        # Parse query parameters
+        params = urllib.parse.parse_qs(parsed.query)
+        # Extract OAuth parameters
+        code = params.get("code", [None])[0]
+        state = params.get("state", [None])[0]
+        error = params.get("error", [None])[0]
+        error_description = params.get("error_description", [None])[0]
+        # Create result
+        result = CallbackResult(
+            code=code,
+            state=state,
+            error=error,
+            error_description=error_description,
+        )
+        # Store result and notify waiting future
+        with self.server_lock:
+            if state and state in self.callback_results:
+                future = self.callback_results[state]
+                if not future.done():
+                    # Use call_soon_threadsafe to set result from HTTP thread
+                    try:
+                        loop = future.get_loop()
+                        loop.call_soon_threadsafe(future.set_result, result)
+                    except Exception as e:
+                        logger.error(f"Error setting callback result: {e}")
+        # Send response
+        if error:
+            self._send_error_page(error, error_description)
+        else:
+            self._send_success_page()
+    def _send_success_page(self) -> None:
+        """Send success HTML page."""
+        content = SUCCESS_HTML.encode("utf-8")
+        self.send_response(200)
+        self.send_header("Content-Type", "text/html; charset=utf-8")
+        self.send_header("Content-Length", str(len(content)))
+        self.end_headers()
+        self.wfile.write(content)
+    def _send_error_page(self, error: str, description: Optional[str]) -> None:
+        """Send error HTML page."""
+        error_msg = error
+        if description:
+            error_msg = f"{error}: {description}"
+        content = ERROR_HTML.format(error=error_msg).encode("utf-8")
+        self.send_response(400)
+        self.send_header("Content-Type", "text/html; charset=utf-8")
+        self.send_header("Content-Length", str(len(content)))
+        self.end_headers()
+        self.wfile.write(content)
+class OAuthCallbackServer:
+    """
+    Local HTTP server for OAuth callbacks.
+    Runs a lightweight HTTP server on localhost to receive OAuth
+    authorization callbacks.
+    Usage:
+        server = OAuthCallbackServer()
+        await server.start()
+        # Start OAuth flow with state parameter
+        state = "random_state_value"
+        # Wait for callback
+        result = await server.wait_for_callback(state, timeout=300)
+        # result.code contains the authorization code
+        await server.stop()
+    """
+    DEFAULT_PORT = 19876
+    def __init__(self, port: int = DEFAULT_PORT):
+        self.port = port
+        self._server: Optional[HTTPServer] = None
+        self._server_thread: Optional[threading.Thread] = None
+        self._running = False
+    async def start(self) -> None:
+        """Start the callback server."""
+        if self._running:
+            return
+        # Create HTTP server
+        try:
+            self._server = HTTPServer(
+                ("localhost", self.port),
+                OAuthCallbackHandler,
+            )
+            self._server.timeout = 1  # Allow periodic checks
+            # Start server in background thread
+            self._running = True
+            self._server_thread = threading.Thread(
+                target=self._serve_forever,
+                daemon=True,
+            )
+            self._server_thread.start()
+            logger.info(f"OAuth callback server started on port {self.port}")
+        except OSError as e:
+            if "Address already in use" in str(e):
+                # Port in use, try next port
+                self.port += 1
+                await self.start()
+            else:
+                raise
+    def _serve_forever(self) -> None:
+        """Server loop running in background thread."""
+        while self._running:
+            self._server.handle_request()
+    async def stop(self) -> None:
+        """Stop the callback server."""
+        self._running = False
+        if self._server:
+            self._server.shutdown()
+            self._server = None
+        if self._server_thread:
+            self._server_thread.join(timeout=5)
+            self._server_thread = None
+        logger.info("OAuth callback server stopped")
+    async def wait_for_callback(
+        self,
+        state: str,
+        timeout: float = 300,
+    ) -> CallbackResult:
+        """
+        Wait for an OAuth callback with the given state.
+        Args:
+            state: The state parameter to wait for
+            timeout: Maximum time to wait in seconds
+        Returns:
+            CallbackResult with the authorization code or error
+        """
+        if not self._running:
+            await self.start()
+        # Create future for this state
+        loop = asyncio.get_event_loop()
+        future: asyncio.Future[CallbackResult] = loop.create_future()
+        with OAuthCallbackHandler.server_lock:
+            OAuthCallbackHandler.callback_results[state] = future
+        try:
+            result = await asyncio.wait_for(future, timeout=timeout)
+            return result
+        except asyncio.TimeoutError:
+            return CallbackResult(
+                error="timeout",
+                error_description="OAuth callback timed out",
+            )
+        finally:
+            # Clean up
+            with OAuthCallbackHandler.server_lock:
+                OAuthCallbackHandler.callback_results.pop(state, None)
+    def get_redirect_uri(self) -> str:
+        """Get the redirect URI for this server."""
+        return f"http://localhost:{self.port}/mcp/oauth/callback"
+    @property
+    def is_running(self) -> bool:
+        """Check if the server is running."""
+        return self._running
+# Global server instance for shared use
+_global_server: Optional[OAuthCallbackServer] = None
+async def get_callback_server() -> OAuthCallbackServer:
+    """Get or create the global callback server."""
+    global _global_server
+    if _global_server is None:
+        _global_server = OAuthCallbackServer()
+    if not _global_server.is_running:
+        await _global_server.start()
+    return _global_server
+async def shutdown_callback_server() -> None:
+    """Shutdown the global callback server."""
+    global _global_server
+    if _global_server is not None:
+        await _global_server.stop()
+        _global_server = None

superqode/mcp/types.py ADDED Viewed

@@ -0,0 +1,290 @@
+"""MCP type definitions for SuperQode.
+This module defines the data types used for MCP tool, resource, and prompt
+representations within SuperQode. Aligned with MCP protocol version 2025-03-26.
+"""
+from dataclasses import dataclass, field
+from enum import Enum
+from typing import Any, Literal
+class ServerCapability(Enum):
+    """Server capabilities that can be checked."""
+    EXPERIMENTAL = "experimental"
+    LOGGING = "logging"
+    PROMPTS = "prompts"
+    RESOURCES = "resources"
+    TOOLS = "tools"
+    COMPLETIONS = "completions"
+class LoggingLevel(Enum):
+    """MCP logging levels."""
+    DEBUG = "debug"
+    INFO = "info"
+    NOTICE = "notice"
+    WARNING = "warning"
+    ERROR = "error"
+    CRITICAL = "critical"
+    ALERT = "alert"
+    EMERGENCY = "emergency"
+@dataclass
+class ToolAnnotations:
+    """Annotations providing hints about tool behavior.
+    Attributes:
+        title: Human-readable title for the tool
+        read_only_hint: If true, the tool does not modify its environment
+        destructive_hint: If true, the tool may perform destructive updates
+        idempotent_hint: If true, calling repeatedly has no additional effect
+        open_world_hint: If true, tool may interact with external entities
+    """
+    title: str | None = None
+    read_only_hint: bool | None = None
+    destructive_hint: bool | None = None
+    idempotent_hint: bool | None = None
+    open_world_hint: bool | None = None
+@dataclass
+class MCPTool:
+    """Represents an MCP tool available from a server.
+    Attributes:
+        name: The tool's unique name
+        description: Human-readable description of what the tool does
+        input_schema: JSON Schema defining the tool's input parameters
+        output_schema: Optional JSON Schema for tool output
+        server_id: ID of the server providing this tool
+        annotations: Optional hints about tool behavior
+    """
+    name: str
+    description: str
+    input_schema: dict[str, Any]
+    server_id: str
+    output_schema: dict[str, Any] | None = None
+    annotations: ToolAnnotations | None = None
+@dataclass
+class MCPResource:
+    """Represents an MCP resource available from a server.
+    Attributes:
+        uri: The resource's unique URI
+        name: Human-readable name for the resource
+        description: Optional description of the resource
+        mime_type: Optional MIME type of the resource content
+        server_id: ID of the server providing this resource
+    """
+    uri: str
+    name: str
+    description: str | None = None
+    mime_type: str | None = None
+    server_id: str = ""
+@dataclass
+class MCPResourceTemplate:
+    """Represents an MCP resource template for dynamic resources.
+    Attributes:
+        uri_template: URI template with placeholders
+        name: Human-readable name for the template
+        description: Optional description
+        mime_type: Optional MIME type of generated resources
+        server_id: ID of the server providing this template
+    """
+    uri_template: str
+    name: str
+    description: str | None = None
+    mime_type: str | None = None
+    server_id: str = ""
+@dataclass
+class MCPPromptArgument:
+    """Argument definition for an MCP prompt.
+    Attributes:
+        name: Argument name
+        description: Optional description
+        required: Whether the argument is required
+    """
+    name: str
+    description: str | None = None
+    required: bool = False
+@dataclass
+class MCPPrompt:
+    """Represents an MCP prompt template from a server.
+    Attributes:
+        name: The prompt's unique name
+        description: Human-readable description of the prompt
+        arguments: List of argument definitions for the prompt
+        server_id: ID of the server providing this prompt
+    """
+    name: str
+    description: str | None = None
+    arguments: list[MCPPromptArgument] = field(default_factory=list)
+    server_id: str = ""
+@dataclass
+class MCPToolResult:
+    """Result from executing an MCP tool.
+    Attributes:
+        content: The tool's output content (text, images, etc.)
+        is_error: Whether the tool execution resulted in an error
+        error_message: Error message if is_error is True
+        structured_content: Optional structured output data
+    """
+    content: list[dict[str, Any]]
+    is_error: bool = False
+    error_message: str | None = None
+    structured_content: dict[str, Any] | None = None
+@dataclass
+class MCPResourceContent:
+    """Content retrieved from an MCP resource.
+    Attributes:
+        uri: The resource URI
+        mime_type: MIME type of the content
+        text: Text content (if text-based)
+        blob: Binary content as base64 (if binary)
+    """
+    uri: str
+    mime_type: str | None = None
+    text: str | None = None
+    blob: str | None = None
+@dataclass
+class MCPPromptMessage:
+    """A message from an MCP prompt.
+    Attributes:
+        role: The message role (user, assistant)
+        content: The message content
+    """
+    role: Literal["user", "assistant"]
+    content: str | dict[str, Any]
+@dataclass
+class MCPPromptResult:
+    """Result from getting an MCP prompt.
+    Attributes:
+        description: Optional description of the prompt
+        messages: List of messages in the prompt
+    """
+    description: str | None = None
+    messages: list[MCPPromptMessage] = field(default_factory=list)
+@dataclass
+class MCPCompletionResult:
+    """Result from a completion request.
+    Attributes:
+        values: List of completion values
+        total: Total number of completions (if known)
+        has_more: Whether more completions are available
+    """
+    values: list[str]
+    total: int | None = None
+    has_more: bool | None = None
+@dataclass
+class MCPRoot:
+    """Represents a root directory for the MCP client.
+    Attributes:
+        uri: The root URI
+        name: Optional human-readable name
+    """
+    uri: str
+    name: str | None = None
+@dataclass
+class MCPServerCapabilities:
+    """Server capabilities reported during initialization.
+    Attributes:
+        experimental: Experimental capabilities
+        logging: Logging capability
+        prompts: Prompts capability with list_changed support
+        resources: Resources capability with subscribe and list_changed
+        tools: Tools capability with list_changed support
+        completions: Completions capability
+    """
+    experimental: dict[str, Any] | None = None
+    logging: bool = False
+    prompts: bool = False
+    prompts_list_changed: bool = False
+    resources: bool = False
+    resources_subscribe: bool = False
+    resources_list_changed: bool = False
+    tools: bool = False
+    tools_list_changed: bool = False
+    completions: bool = False
+@dataclass
+class MCPServerInfo:
+    """Information about an MCP server.
+    Attributes:
+        name: Server name
+        version: Server version
+        capabilities: Server capabilities
+        protocol_version: MCP protocol version
+    """
+    name: str
+    version: str
+    capabilities: MCPServerCapabilities
+    protocol_version: str = ""
+@dataclass
+class MCPProgress:
+    """Progress notification data.
+    Attributes:
+        progress_token: Token identifying the operation
+        progress: Current progress value (0.0 to 1.0 or absolute)
+        total: Optional total value for absolute progress
+        message: Optional progress message
+    """
+    progress_token: str | int
+    progress: float
+    total: float | None = None
+    message: str | None = None

superqode/memory/__init__.py ADDED Viewed

@@ -0,0 +1,31 @@
+"""
+Memory Package - Persistent learning from QE sessions.
+Provides:
+- QEMemory store for project-specific learnings
+- Issue pattern tracking
+- False positive suppressions
+- File risk scoring
+- Role effectiveness metrics
+"""
+from .store import (
+    QEMemory,
+    IssuePattern,
+    Suppression,
+    FixPattern,
+    RoleMetrics,
+    MemoryStore,
+)
+from .feedback import FeedbackCollector, FindingFeedback
+__all__ = [
+    "QEMemory",
+    "IssuePattern",
+    "Suppression",
+    "FixPattern",
+    "RoleMetrics",
+    "MemoryStore",
+    "FeedbackCollector",
+    "FindingFeedback",
+]