spooling 0.1.6__tar.gz → 0.1.7__tar.gz

spooling-0.1.7/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: spooling
+Version: 0.1.7
+Summary: Local session tracker and semantic search for AI coding assistants
+Author: Parsed Analytics, Inc.
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: psycopg[binary]>=3.1
+Requires-Dist: sentence-transformers>=3.0
+Requires-Dist: fastapi>=0.111
+Requires-Dist: uvicorn[standard]>=0.30
+Requires-Dist: jinja2>=3.1
+Requires-Dist: watchdog>=4.0
+Requires-Dist: rich>=13.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: anthropic>=0.40
+Requires-Dist: strands-agents[ollama]>=1.35
+Requires-Dist: strands-agents-evals>=0.1
+Requires-Dist: mcp>=1.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.14; extra == "dev"
+Provides-Extra: connectors
+Requires-Dist: snowflake-connector-python>=3.0; extra == "connectors"
+Requires-Dist: google-cloud-bigquery>=3.0; extra == "connectors"
+Requires-Dist: mysql-connector-python>=8.0; extra == "connectors"
+Requires-Dist: clickhouse-connect>=0.5; extra == "connectors"
+Requires-Dist: motor>=3.0; extra == "connectors"
+Dynamic: license-file

spooling-0.1.6/spooling.egg-info/PKG-INFO → spooling-0.1.7/README.md

@@ -1,39 +1,3 @@
-Metadata-Version: 2.4
-Name: spooling
-Version: 0.1.6
-Summary: Local session tracker and semantic search for AI coding assistants
-Author: Parsed Analytics, Inc.
-License-Expression: MIT
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: click>=8.1
-Requires-Dist: psycopg[binary]>=3.1
-Requires-Dist: sentence-transformers>=3.0
-Requires-Dist: fastapi>=0.111
-Requires-Dist: uvicorn[standard]>=0.30
-Requires-Dist: jinja2>=3.1
-Requires-Dist: watchdog>=4.0
-Requires-Dist: rich>=13.0
-Requires-Dist: httpx>=0.27
-Requires-Dist: anthropic>=0.40
-Requires-Dist: strands-agents[ollama]>=1.35
-Requires-Dist: strands-agents-evals>=0.1
-Requires-Dist: mcp>=1.27
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: pytest-mock>=3.14; extra == "dev"
-Provides-Extra: connectors
-Requires-Dist: snowflake-connector-python>=3.0; extra == "connectors"
-Requires-Dist: google-cloud-bigquery>=3.0; extra == "connectors"
-Requires-Dist: mysql-connector-python>=8.0; extra == "connectors"
-Requires-Dist: clickhouse-connect>=0.5; extra == "connectors"
-Requires-Dist: motor>=3.0; extra == "connectors"
-Dynamic: license-file
-
 # Spooling
 
 Local session tracker and semantic search for AI coding assistants.
@@ -227,6 +191,110 @@ spooling mcp              # streamable-HTTP at http://127.0.0.1:3004/mcp (defaul
 spooling mcp --stdio      # stdio transport, for stdio-only clients
 ```
 
+### `spooling tunnel`
+
+Create a Cloudflare quick tunnel (no account required) to expose your local MCP server to the internet. Once started, it prints a public HTTPS URL you can drop straight into any remote MCP client config. Requires [`cloudflared`](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/) to be installed.
+
+```bash
+spooling tunnel                    # Expose Spooling MCP (port 3004, default)
+spooling tunnel --port 8090        # Expose a custom local port
+spooling tunnel -p 3000 -n my-api  # Named tunnel on port 3000
+```
+
+Options:
+- `-p, --port` - Local port to expose (default: 3004)
+- `-n, --name` - Label for display purposes
+
+After the tunnel starts, it prints the public URL and an MCP config snippet ready to paste:
+
+```json
+{"mcpServers": {"spooling": {"type": "http", "url": "https://<random>.trycloudflare.com/mcp"}}}
+```
+
+Install `cloudflared` if not already present:
+
+```bash
+# macOS
+brew install cloudflared
+
+# Linux
+curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 \
+  -o /usr/local/bin/cloudflared && chmod +x /usr/local/bin/cloudflared
+
+# Windows
+winget install cloudflare.cloudflared
+```
+
+### `spooling cost`
+
+Detailed cost tracking and spend analysis. All subcommands read from the local database — no network calls.
+
+```bash
+spooling cost overview                          # Total spend: input/output/cache breakdown
+spooling cost overview --provider cursor        # Filter to one provider
+spooling cost overview --days 7                 # Last 7 days only
+
+spooling cost breakdown                         # Cost by provider (default)
+spooling cost breakdown --by model              # Cost by model
+spooling cost breakdown --by project            # Cost by project
+spooling cost breakdown --by model --days 30    # Model breakdown, last 30 days
+
+spooling cost daily                             # Daily trend (last 30 days)
+spooling cost daily --days 14                   # Last 14 days
+spooling cost daily --provider codex            # Filter by provider
+
+spooling cost monthly                           # Monthly trend (last 12 months)
+spooling cost monthly --months 6                # Last 6 months
+
+spooling cost session <session-id>              # Detailed cost for a single session
+
+spooling cost recalc                            # Dry-run: re-price all sessions against current rates
+spooling cost recalc --apply                    # Actually persist the repriced values
+spooling cost recalc --session <id> --apply     # Reprice one session
+spooling cost recalc --provider cursor --apply  # Reprice all sessions for a provider
+```
+
+### `spooling eval`
+
+Run LLM-as-judge rubrics against your session traces.
+
+```bash
+spooling eval list                              # List all configured rubrics
+spooling eval run --rubric <id> --trace <id>    # Score one trace
+spooling eval run --rubric <id> --days 7        # Batch-score traces from the last 7 days
+```
+
+### `spooling experiment`
+
+Create and run Strands-style experiments — a set of test cases evaluated by one or more rubrics.
+
+```bash
+spooling experiment list                        # List all experiments
+spooling experiment create --file spec.json     # Register an experiment from a JSON spec
+spooling experiment run --id <experiment-id>    # Run an experiment and persist the report
+spooling experiment show --run <run-id>         # Show the results of a past run
+```
+
+### `spooling otel`
+
+Ingest OpenTelemetry / Strands span exports from external sources into Spooling.
+
+```bash
+spooling otel ingest --file spans.json                         # Ingest an OTLP JSON export
+spooling otel ingest --file spans.json --provider my-agent     # Tag with a custom provider id
+spooling otel ingest --file spans.json --project myproject     # Tag with a project name
+```
+
+### `spooling pricing`
+
+Manage the LiteLLM-backed model pricing table used for cost calculations.
+
+```bash
+spooling pricing show                           # Show cache status and source info
+spooling pricing show claude-sonnet-4-5         # Show per-component rates for a model ($/Mtok)
+spooling pricing refresh                        # Force-fetch latest rates into ~/.spool/model_prices.json
+```
+
 ---
 
 ## Spooling Cloud (optional)
@@ -463,6 +531,7 @@ spooling/
 │   ├── stats.py             # Usage statistics
 │   ├── watcher.py           # File watcher (watchdog)
 │   ├── agent.py             # Chat agent (Ollama + Anthropic)
+│   ├── tunnel.py            # Cloudflare quick tunnel support
 │   └── server.py            # FastAPI API server
 └── ui/                      # Next.js frontend
     ├── next.config.js       # API proxy to :3002
@@ -527,3 +596,4 @@ All optional - defaults work out of the box for local development.
 Run `spooling init` to see which providers are detected on your system.
 
 No data is sent to external servers. Everything runs locally.
+

{spooling-0.1.6 → spooling-0.1.7}/pyproject.toml

@@ -1,17 +1,15 @@
 [project]
 name = "spooling"
-version = "0.1.6"
+version = "0.1.7"
 description = "Local session tracker and semantic search for AI coding assistants"
-readme = "README.md"
-license = "MIT"
-license-files = ["LICENSE"]
 authors = [{ name = "Parsed Analytics, Inc." }]
+license = { text = "MIT" }
+requires-python = ">=3.11"
 classifiers = [
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
 ]
-requires-python = ">=3.11"
 dependencies = [
     "click>=8.1",
     "psycopg[binary]>=3.1",
@@ -28,12 +26,6 @@ dependencies = [
     "mcp>=1.27",
 ]
 
-[project.scripts]
-spooling = "spooling.cli:cli"
-
-[tool.setuptools.packages.find]
-include = ["spooling*"]
-
 [project.optional-dependencies]
 dev = [
     "pytest>=8.0",
@@ -47,9 +39,16 @@ connectors = [
     "motor>=3.0",
 ]
 
-[tool.pytest.ini_options]
-testpaths = ["tests"]
+[project.scripts]
+spooling = "spooling.cli:cli"
 
 [build-system]
-requires = ["setuptools>=68"]
+requires = ["setuptools>=68", "wheel"]
 build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["spooling*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

{spooling-0.1.6 → spooling-0.1.7}/spooling/cli.py

@@ -678,6 +678,36 @@ def pricing_show(model):
     console.print(table)
 
 
+@cli.command()
+@click.option("--port", "-p", default=3004, type=int, help="Local port to tunnel (default: 3004 for Spooling MCP)")
+@click.option("--name", "-n", default=None, help="Name for this tunnel (for display)")
+def tunnel(port, name):
+    """Start a Cloudflare tunnel to expose a local MCP server.
+
+    Creates a quick tunnel (no account required) that exposes your local
+    MCP server to the internet. The tunnel URL can be used by any
+    MCP-compatible client.
+
+    Examples:
+    \b
+    spooling tunnel                    # Tunnel Spooling MCP (port 3004)
+    spooling tunnel --port 8090        # Tunnel a custom MCP server
+    spooling tunnel -p 3000 -n my-api  # Named tunnel
+    """
+    from spooling.tunnel import start_tunnel
+
+    display_name = name or f"port {port}"
+    console.print(f"[bold]Starting tunnel for {display_name}...[/bold]")
+
+    url = start_tunnel(port=port, name=name)
+    if url:
+        # Print MCP config snippet for easy copy-paste
+        console.print()
+        console.print("[dim]Add this to your MCP client config:[/dim]")
+        console.print(f'[bold]{{"mcpServers": {{"custom": {{"type": "http", "url": "{url}/mcp"}}}}}}[/bold]')
+        console.print()
+
+
 @cli.command()
 @click.option("--stdio", is_flag=True, help="Use stdio transport (default is streamable-HTTP)")
 @click.option("--local", "local_mode", flag_value="local", default=True, help="Local DB only, no cloud fallback")

spooling-0.1.7/spooling/tunnel.py

@@ -0,0 +1,185 @@
+"""Cloudflare tunnel support for exposing local MCP servers."""
+
+import re
+import subprocess
+import time
+from typing import Optional, Tuple
+
+from rich.console import Console
+
+console = Console()
+
+# Pattern to match Cloudflare tunnel URL (strict: only lowercase alphanumeric + hyphens)
+TUNNEL_URL_PATTERN = re.compile(r"^https://[a-z0-9]{2,63}-[a-z0-9]{2,63}-[a-z0-9]{2,63}\.trycloudflare\.com$")
+
+
+def check_cloudflared() -> bool:
+    """Check if cloudflared is installed."""
+    try:
+        result = subprocess.run(
+            ["cloudflared", "version"],
+            capture_output=True,
+            text=True,
+            timeout=5,
+        )
+        return result.returncode == 0
+    except (FileNotFoundError, subprocess.TimeoutExpired):
+        return False
+
+
+def _validate_port(port: int) -> bool:
+    """Validate port number is in valid range."""
+    return 1 <= port <= 65535
+
+
+def start_tunnel(
+    port: int,
+    name: Optional[str] = None,
+    no_autoupdate: bool = True,
+) -> Optional[str]:
+    """Start a Cloudflare quick tunnel and return the public URL.
+
+    Args:
+        port: Local port to expose (1-65535)
+        name: Optional name for the tunnel (for display purposes)
+        no_autoupdate: Disable cloudflared auto-updates
+
+    Returns:
+        The tunnel URL if successful, None otherwise
+    """
+    if not _validate_port(port):
+        console.print(f"[red]Invalid port: {port}. Must be 1-65535.[/red]")
+        return None
+
+    if not check_cloudflared():
+        console.print("[red]cloudflared is not installed.[/red]")
+        console.print("Install it:")
+        console.print("  macOS:   [bold]brew install cloudflared[/bold]")
+        console.print("  Linux:   [bold]curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -o /usr/local/bin/cloudflared && chmod +x /usr/local/bin/cloudflared[/bold]")
+        console.print("  Windows: [bold]winget install cloudflare.cloudflared[/bold]")
+        console.print("  Docs:    https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/")
+        return None
+
+    cmd = ["cloudflared", "tunnel", "--url", f"http://localhost:{port}"]
+    if no_autoupdate:
+        cmd.append("--no-autoupdate")
+
+    console.print(f"[bold]Starting Cloudflare tunnel to localhost:{port}...[/bold]")
+
+    process = None
+    try:
+        process = subprocess.Popen(
+            cmd,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.STDOUT,
+            text=True,
+            bufsize=1,
+        )
+
+        # Read output until we find the URL or process exits
+        url = None
+        start_time = time.time()
+        timeout = 30  # seconds
+
+        while time.time() - start_time < timeout:
+            line = process.stdout.readline()
+            if not line:
+                break
+
+            # Print cloudflared output for visibility
+            console.print(f"[dim]{line.rstrip()}[/dim]")
+
+            # Check for tunnel URL
+            match = TUNNEL_URL_PATTERN.search(line.strip())
+            if match:
+                url = match.group(0)
+                break
+
+        if url:
+            console.print()
+            console.print(f"[green]Tunnel started![/green]")
+            console.print(f"  URL: [bold]{url}[/bold]")
+            console.print(f"  Local: http://localhost:{port}")
+            console.print()
+            console.print("Press [bold]Ctrl+C[/bold] to stop the tunnel")
+
+            # Wait for Ctrl+C
+            try:
+                process.wait()
+            except KeyboardInterrupt:
+                console.print("\n[yellow]Stopping tunnel...[/yellow]")
+                process.terminate()
+                try:
+                    process.wait(timeout=5)
+                except subprocess.TimeoutExpired:
+                    process.kill()
+                console.print("[green]Tunnel stopped.[/green]")
+        else:
+            console.print("[red]Failed to get tunnel URL within timeout.[/red]")
+            process.terminate()
+            process.wait(timeout=5)
+            return None
+
+        return url
+
+    except FileNotFoundError:
+        console.print("[red]cloudflared not found in PATH.[/red]")
+        return None
+    except Exception as e:
+        console.print(f"[red]Tunnel error:[/red] {e}")
+        if process and process.poll() is None:
+            process.terminate()
+            try:
+                process.wait(timeout=5)
+            except subprocess.TimeoutExpired:
+                process.kill()
+        return None
+
+
+def start_tunnel_background(
+    port: int,
+    no_autoupdate: bool = True,
+) -> Tuple[Optional[subprocess.Popen], Optional[str]]:
+    """Start a tunnel in the background and return the process and URL.
+
+    Args:
+        port: Local port to expose (1-65535)
+        no_autoupdate: Disable cloudflared auto-updates
+
+    Returns:
+        A tuple of (process, url) if successful, (None, None) otherwise
+    """
+    if not _validate_port(port):
+        return None, None
+
+    if not check_cloudflared():
+        return None, None
+
+    cmd = ["cloudflared", "tunnel", "--url", f"http://localhost:{port}"]
+    if no_autoupdate:
+        cmd.append("--no-autoupdate")
+
+    process = subprocess.Popen(
+        cmd,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.STDOUT,
+        text=True,
+        bufsize=1,
+    )
+
+    # Read output until we find the URL
+    url = None
+    start_time = time.time()
+    timeout = 30
+
+    while time.time() - start_time < timeout:
+        line = process.stdout.readline()
+        if not line:
+            break
+
+        match = TUNNEL_URL_PATTERN.search(line.strip())
+        if match:
+            url = match.group(0)
+            break
+
+    return process, url

spooling-0.1.7/spooling.egg-info/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: spooling
+Version: 0.1.7
+Summary: Local session tracker and semantic search for AI coding assistants
+Author: Parsed Analytics, Inc.
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: psycopg[binary]>=3.1
+Requires-Dist: sentence-transformers>=3.0
+Requires-Dist: fastapi>=0.111
+Requires-Dist: uvicorn[standard]>=0.30
+Requires-Dist: jinja2>=3.1
+Requires-Dist: watchdog>=4.0
+Requires-Dist: rich>=13.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: anthropic>=0.40
+Requires-Dist: strands-agents[ollama]>=1.35
+Requires-Dist: strands-agents-evals>=0.1
+Requires-Dist: mcp>=1.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.14; extra == "dev"
+Provides-Extra: connectors
+Requires-Dist: snowflake-connector-python>=3.0; extra == "connectors"
+Requires-Dist: google-cloud-bigquery>=3.0; extra == "connectors"
+Requires-Dist: mysql-connector-python>=8.0; extra == "connectors"
+Requires-Dist: clickhouse-connect>=0.5; extra == "connectors"
+Requires-Dist: motor>=3.0; extra == "connectors"
+Dynamic: license-file

{spooling-0.1.6 → spooling-0.1.7}/spooling.egg-info/SOURCES.txt

@@ -23,6 +23,7 @@ spooling/server.py
 spooling/stats.py
 spooling/subscription_pricing.py
 spooling/tracing.py
+spooling/tunnel.py
 spooling/watcher.py
 spooling.egg-info/PKG-INFO
 spooling.egg-info/SOURCES.txt
@@ -56,7 +57,4 @@ spooling/providers/gitlab.py
 spooling/providers/kiro.py
 spooling/providers/opencode.py
 spooling/providers/session_file.py
-spooling/providers/windsurf.py
-tests/test_parser.py
-tests/test_pricing.py
-tests/test_redact.py
+spooling/providers/windsurf.py