tamfis-code 0.2.3__tar.gz

tamfis_code-0.2.3/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: tamfis-code
+Version: 0.2.3
+Summary: TamfisGPT Code -- standalone terminal coding agent (calls HF/NVIDIA NIM/OpenRouter/Ollama directly; --remote for the legacy TamfisGPT Remote backend)
+Project-URL: Homepage, https://github.com/tamfitronics/tamfis-code
+Project-URL: Repository, https://github.com/tamfitronics/tamfis-code
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: rich>=13.0
+Requires-Dist: prompt_toolkit>=3.0
+Requires-Dist: openai>=1.30
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
+
+# tamfis-code
+
+A standalone terminal coding agent. By default it calls an LLM provider
+directly — Hugging Face, NVIDIA NIM, OpenRouter, or Ollama — and runs its
+own agent loop, tool execution, and local risk/approval/mutation-ledger
+safety layer, with no separate backend process required.
+
+`--remote` (or a persistent `default_backend = "remote"` config setting)
+switches to the original architecture: a thin client to the TamfisGPT
+Remote Workspace backend, for TamfisGPT tenants using their hosted account
+the same way Codex CLI uses a ChatGPT/OpenAI account, kimi-code uses a Kimi
+account, or Claude Code uses a Claude account.
+
+## Install
+
+```
+pipx install tamfis-code
+```
+
+See [USAGE_INSTALL_RELEASE.md](./USAGE_INSTALL_RELEASE.md) for installing
+from source, using a TamfisGPT tenancy, and the release process.
+
+## Quick start
+
+```
+export OLLAMA_BASE_URL=http://localhost:11434/v1   # or set HF_TOKEN / NVIDIA_API_KEY / OPENROUTER_API_KEY
+tamfis-code doctor                                  # check provider connectivity
+tamfis-code ask "explain what this repo does"
+tamfis-code agent "add a health-check endpoint"     # full read/write/execute loop
+tamfis-code                                         # interactive REPL
+```
+
+## Providers
+
+| Provider | Env var | Notes |
+|---|---|---|
+| Ollama | `OLLAMA_BASE_URL` (default `http://localhost:11434/v1`) | Runs fully on-device, no API key |
+| Hugging Face | `HF_TOKEN` | |
+| NVIDIA NIM | `NVIDIA_API_KEY` | |
+| OpenRouter | `OPENROUTER_API_KEY` | |
+
+Select one explicitly with `--provider hf|nvidia|openrouter|ollama`, or
+leave it as `auto` (default) to pick the best configured one.
+
+## Safety model
+
+Every mutating tool call (`write_file`, `edit_file`, `execute_command`) is
+risk-classified locally (`tamfis_code/safety.py`), gated by
+`--approval-policy` (or the `/mode` REPL command), and recorded in a local
+mutation ledger — see `tamfis-code diffs` / `tamfis-code diff` /
+`tamfis-code revert`. There is no sandboxing beyond risk classification;
+review dangerous commands yourself before approving them.
+
+## License
+
+TBD — decide before the first public PyPI release (a public package still
+needs a stated license; "all rights reserved"/proprietary is a valid choice
+if you don't want redistribution/modification, but it should be explicit
+rather than absent).

tamfis_code-0.2.3/README.md

@@ -0,0 +1,59 @@
+# tamfis-code
+
+A standalone terminal coding agent. By default it calls an LLM provider
+directly — Hugging Face, NVIDIA NIM, OpenRouter, or Ollama — and runs its
+own agent loop, tool execution, and local risk/approval/mutation-ledger
+safety layer, with no separate backend process required.
+
+`--remote` (or a persistent `default_backend = "remote"` config setting)
+switches to the original architecture: a thin client to the TamfisGPT
+Remote Workspace backend, for TamfisGPT tenants using their hosted account
+the same way Codex CLI uses a ChatGPT/OpenAI account, kimi-code uses a Kimi
+account, or Claude Code uses a Claude account.
+
+## Install
+
+```
+pipx install tamfis-code
+```
+
+See [USAGE_INSTALL_RELEASE.md](./USAGE_INSTALL_RELEASE.md) for installing
+from source, using a TamfisGPT tenancy, and the release process.
+
+## Quick start
+
+```
+export OLLAMA_BASE_URL=http://localhost:11434/v1   # or set HF_TOKEN / NVIDIA_API_KEY / OPENROUTER_API_KEY
+tamfis-code doctor                                  # check provider connectivity
+tamfis-code ask "explain what this repo does"
+tamfis-code agent "add a health-check endpoint"     # full read/write/execute loop
+tamfis-code                                         # interactive REPL
+```
+
+## Providers
+
+| Provider | Env var | Notes |
+|---|---|---|
+| Ollama | `OLLAMA_BASE_URL` (default `http://localhost:11434/v1`) | Runs fully on-device, no API key |
+| Hugging Face | `HF_TOKEN` | |
+| NVIDIA NIM | `NVIDIA_API_KEY` | |
+| OpenRouter | `OPENROUTER_API_KEY` | |
+
+Select one explicitly with `--provider hf|nvidia|openrouter|ollama`, or
+leave it as `auto` (default) to pick the best configured one.
+
+## Safety model
+
+Every mutating tool call (`write_file`, `edit_file`, `execute_command`) is
+risk-classified locally (`tamfis_code/safety.py`), gated by
+`--approval-policy` (or the `/mode` REPL command), and recorded in a local
+mutation ledger — see `tamfis-code diffs` / `tamfis-code diff` /
+`tamfis-code revert`. There is no sandboxing beyond risk classification;
+review dangerous commands yourself before approving them.
+
+## License
+
+TBD — decide before the first public PyPI release (a public package still
+needs a stated license; "all rights reserved"/proprietary is a valid choice
+if you don't want redistribution/modification, but it should be explicit
+rather than absent).

tamfis_code-0.2.3/pyproject.toml

@@ -0,0 +1,44 @@
+[project]
+name = "tamfis-code"
+version = "0.2.3"
+description = "TamfisGPT Code -- standalone terminal coding agent (calls HF/NVIDIA NIM/OpenRouter/Ollama directly; --remote for the legacy TamfisGPT Remote backend)"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "click>=8.1",
+    "httpx>=0.27",
+    "rich>=13.0",
+    "prompt_toolkit>=3.0",
+    # Provider calls (providers.py) go through the openai SDK's client against
+    # each vendor's OpenAI-compatible endpoint (HF, NVIDIA NIM, OpenRouter,
+    # Ollama) -- this was imported but never declared, only working because a
+    # copy happened to already be installed system-wide.
+    "openai>=1.30",
+]
+
+[project.scripts]
+tamfis-code = "tamfis_code.cli:main"
+tamgpt-code = "tamfis_code.cli:main"
+tamfis = "tamfis_code.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/tamfitronics/tamfis-code"
+Repository = "https://github.com/tamfitronics/tamfis-code"
+
+[project.optional-dependencies]
+dev = [
+    "build>=1.0",
+    "twine>=5.0",
+    "pytest>=8.0",
+    # tests/test_agents.py and tests/test_mcp.py use @pytest.mark.asyncio --
+    # this was only working locally because a copy happened to already be
+    # installed system-wide (same class of gap as the openai dependency above).
+    "pytest-asyncio>=0.24",
+]
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = ["tamfis_code"]

tamfis_code-0.2.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tamfis_code-0.2.3/tamfis_code/__init__.py

@@ -0,0 +1,58 @@
+"""TamfisGPT Code -- a standalone terminal coding agent.
+
+By default, this package calls an LLM provider directly (Hugging Face,
+NVIDIA NIM, OpenRouter, or Ollama -- see providers.py/runner_local.py) and
+runs its own agent loop, tool execution (mcp.py), and local risk
+classification/approval/mutation ledger (safety.py) -- no separate backend
+process required. Every `ask`/`chat`/`audit`/`plan`/`agent`/`exec` command,
+and the interactive REPL, work this way unless `--remote` is passed.
+
+`--remote` still supports the original architecture this package started
+as: a thin client to the TamfisGPT Remote Workspace backend (same sessions/
+tasks/tools/approvals/events -- see tier_ii_gateway/api/remote.py), which
+does the equivalent work server-side. That path is kept for continuity but
+is not the primary, developed-going-forward one.
+
+See docs/REMOTE_AGENT_MASTER_SPEC.md, Phase 21, for the original --remote
+architecture's spec.
+"""
+
+__version__ = "0.2.3"
+
+# Bumped whenever a CLI release requires a minimum backend Remote API
+# contract version. Only meaningful for --remote; the standalone path has no
+# server to negotiate a contract version with. There is no server-side
+# version negotiation yet (`tamfis-code doctor --remote` just checks
+# reachability) -- this constant exists so that check has something concrete
+# to compare against once one is added, rather than silently assuming
+# compatibility forever.
+MIN_COMPATIBLE_API_VERSION = "remote-ai-v2"
+
+# New exports
+from .completion import ShellCompleter
+from .metrics import MetricsTracker, StreamMetrics
+from .sessions import SessionManager, Session, Message
+from .agents import AgentManager, SubAgent, CodeAnalyzer, TestGenerator, DocGenerator
+from .mcp import MCPServer, ToolDefinition, call_tool
+from .indexer import CodeIndexer, CodeSymbol, CodeFile
+
+__all__ = [
+    # Existing...
+    'ShellCompleter',
+    'MetricsTracker',
+    'StreamMetrics',
+    'SessionManager',
+    'Session',
+    'Message',
+    'AgentManager',
+    'SubAgent',
+    'CodeAnalyzer',
+    'TestGenerator',
+    'DocGenerator',
+    'MCPServer',
+    'ToolDefinition',
+    'call_tool',
+    'CodeIndexer',
+    'CodeSymbol',
+    'CodeFile',
+]

tamfis_code-0.2.3/tamfis_code/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

tamfis_code-0.2.3/tamfis_code/agents.py

@@ -0,0 +1,371 @@
+"""Subagent system for autonomous task execution"""
+
+from typing import Dict, Any, Optional, List, Callable
+from dataclasses import dataclass, field
+from enum import Enum
+import asyncio
+import subprocess
+import json
+import re
+import uuid
+from pathlib import Path  # <-- Add this import
+
+class AgentStatus(Enum):
+    IDLE = "idle"
+    RUNNING = "running"
+    COMPLETED = "completed"
+    FAILED = "failed"
+    WAITING = "waiting"
+
+@dataclass
+class AgentTask:
+    """A task for a subagent"""
+    id: str
+    description: str
+    parameters: Dict[str, Any] = field(default_factory=dict)
+    status: AgentStatus = AgentStatus.IDLE
+    result: Optional[Dict[str, Any]] = None
+    error: Optional[str] = None
+
+class SubAgent:
+    """Base class for subagents"""
+    
+    def __init__(self, name: str, description: str, capabilities: List[str]):
+        self.name = name
+        self.description = description
+        self.capabilities = capabilities
+        self.current_task: Optional[AgentTask] = None
+    
+    async def execute(self, task: AgentTask) -> Dict[str, Any]:
+        """Execute a task - to be overridden"""
+        raise NotImplementedError
+    
+    def can_handle(self, task_description: str) -> bool:
+        """Check if agent can handle this task"""
+        task_lower = task_description.lower()
+        for cap in self.capabilities:
+            if cap.lower() in task_lower:
+                return True
+        return False
+
+class CodeAnalyzer(SubAgent):
+    """Analyzes code structure and quality"""
+    
+    def __init__(self):
+        super().__init__(
+            name="code_analyzer",
+            description="Analyzes code for patterns, issues, and complexity",
+            capabilities=["analyze", "inspect", "complexity", "quality", "metrics"]
+        )
+    
+    async def execute(self, task: AgentTask) -> Dict[str, Any]:
+        """Analyze code based on task parameters"""
+        file_path = task.parameters.get('file')
+        if not file_path:
+            return {"error": "No file specified"}
+        
+        try:
+            with open(file_path, 'r') as f:
+                content = f.read()
+            
+            lines = content.split('\n')
+            result = {
+                "file": file_path,
+                "lines": len(lines),
+                "characters": len(content),
+                "functions": self._count_functions(content),
+                "classes": self._count_classes(content),
+                "imports": self._count_imports(content),
+                "complexity_score": self._calculate_complexity(content),
+                "issues": self._find_issues(content),
+            }
+            return result
+        except Exception as e:
+            return {"error": str(e)}
+    
+    def _count_functions(self, content: str) -> int:
+        return len(re.findall(r'^\s*def\s+\w+\s*\(', content, re.MULTILINE))
+    
+    def _count_classes(self, content: str) -> int:
+        return len(re.findall(r'^\s*class\s+\w+', content, re.MULTILINE))
+    
+    def _count_imports(self, content: str) -> int:
+        return len(re.findall(r'^\s*(?:from|import)\s+\w+', content, re.MULTILINE))
+    
+    def _calculate_complexity(self, content: str) -> float:
+        lines = content.split('\n')
+        complexity = 1
+        keywords = ['if', 'elif', 'else', 'for', 'while', 'except', 'case', 'switch', '?']
+        for line in lines:
+            if any(k in line for k in keywords):
+                complexity += 1
+        return complexity
+    
+    def _find_issues(self, content: str) -> List[Dict[str, Any]]:
+        issues = []
+        lines = content.split('\n')
+        
+        for i, line in enumerate(lines, 1):
+            if len(line) > 120:
+                issues.append({
+                    "line": i,
+                    "type": "line_too_long",
+                    "message": f"Line {i} exceeds 120 characters ({len(line)})"
+                })
+            if line.strip().startswith('#') and 'TODO' in line:
+                issues.append({
+                    "line": i,
+                    "type": "todo",
+                    "message": f"TODO: {line.strip()}"
+                })
+            if line.strip().startswith('#') and 'FIXME' in line:
+                issues.append({
+                    "line": i,
+                    "type": "fixme",
+                    "message": f"FIXME: {line.strip()}"
+                })
+        
+        return issues
+
+class TestGenerator(SubAgent):
+    """Generates tests for code"""
+    
+    def __init__(self):
+        super().__init__(
+            name="test_generator",
+            description="Generates unit tests for code",
+            capabilities=["test", "unit test", "coverage", "pytest"]
+        )
+    
+    async def execute(self, task: AgentTask) -> Dict[str, Any]:
+        """Generate tests for specified file"""
+        file_path = task.parameters.get('file')
+        if not file_path:
+            return {"error": "No file specified"}
+        
+        # In production, this would use LLM to generate tests
+        # For now, return a template
+        funcs = self._extract_functions(file_path)
+        return {
+            "file": file_path,
+            "functions_found": len(funcs),
+            "functions": funcs,
+            "test_file": f"test_{Path(file_path).name}",
+            "status": "ready_for_generation"
+        }
+    
+    def _extract_functions(self, file_path: str) -> List[str]:
+        try:
+            with open(file_path, 'r') as f:
+                content = f.read()
+            return re.findall(r'def\s+(\w+)\s*\(', content)
+        except:
+            return []
+
+class DocGenerator(SubAgent):
+    """Generates documentation for code"""
+    
+    def __init__(self):
+        super().__init__(
+            name="doc_generator",
+            description="Generates documentation for code",
+            capabilities=["doc", "documentation", "comment", "docstring"]
+        )
+    
+    async def execute(self, task: AgentTask) -> Dict[str, Any]:
+        """Generate documentation for specified file"""
+        file_path = task.parameters.get('file')
+        if not file_path:
+            return {"error": "No file specified"}
+        
+        funcs = self._extract_with_docstrings(file_path)
+        return {
+            "file": file_path,
+            "functions": funcs,
+            "missing_docs": [f for f in funcs if not f.get('docstring')],
+            "status": "ready_for_review"
+        }
+    
+    def _extract_with_docstrings(self, file_path: str) -> List[Dict[str, Any]]:
+        try:
+            with open(file_path, 'r') as f:
+                content = f.read()
+            
+            results = []
+            lines = content.split('\n')
+            i = 0
+            while i < len(lines):
+                line = lines[i]
+                func_match = re.match(r'^\s*def\s+(\w+)\s*\(', line)
+                if func_match:
+                    func_name = func_match.group(1)
+                    docstring = None
+                    # Look ahead for docstring
+                    j = i + 1
+                    while j < len(lines) and j < i + 3:
+                        if '"""' in lines[j] or "'''" in lines[j]:
+                            docstring = lines[j].strip()
+                            break
+                        j += 1
+                    results.append({
+                        'name': func_name,
+                        'line': i + 1,
+                        'docstring': docstring
+                    })
+                i += 1
+            return results
+        except:
+            return []
+
+class DelegatedCodingAgent(SubAgent):
+    """Delegates its task to the real standalone agent loop (runner_local.py --
+    the same one `tamfis-code agent`/`exec`/`ask` and the interactive REPL
+    drive), instead of a local heuristic.
+
+    Unlike CodeAnalyzer/TestGenerator/DocGenerator, this one can actually act
+    on an arbitrary objective via the model -- calling a provider directly
+    and executing tools locally, with its own workspace/session. It's never
+    selected by AgentManager's keyword-based `get_agent()` routing
+    (capabilities=[]) since it's only meant to be dispatched explicitly via
+    `execute_tasks`.
+    """
+
+    def __init__(
+        self, *, manager, provider, model, console, workspace_root: str, session_id: int,
+        approval_policy: str = "ask", mode: str = "agent",
+    ):
+        super().__init__(
+            name="delegated_coding_agent",
+            description="Delegates a sub-objective to the real standalone agent loop",
+            capabilities=[],
+        )
+        self._manager = manager
+        self._provider = provider
+        self._model = model
+        self._console = console
+        self._workspace_root = workspace_root
+        self._session_id = session_id
+        self._approval_policy = approval_policy
+        self._mode = mode
+
+    async def execute(self, task: AgentTask) -> Dict[str, Any]:
+        from .render import StreamRenderer
+        from .runner_local import run_local_agent_turn
+
+        renderer = StreamRenderer(self._console)
+        outcome = await run_local_agent_turn(
+            self._manager, self._provider, self._model, [{"role": "user", "content": task.description}],
+            self._console, renderer,
+            workspace_root=self._workspace_root, session_id=self._session_id,
+            approval_policy=self._approval_policy, interactive=False,
+            read_only=self._mode in {"chat", "audit", "plan"},
+        )
+        renderer.finish()
+        return {"status": outcome.status, "summary": outcome.summary, "error": outcome.error}
+
+
+class AgentManager:
+    """Manages subagents and task execution"""
+    
+    def __init__(self):
+        self.agents: Dict[str, SubAgent] = {}
+        self.tasks: Dict[str, AgentTask] = {}
+        self._register_default_agents()
+    
+    def _register_default_agents(self):
+        """Register default agents"""
+        self.register(CodeAnalyzer())
+        self.register(TestGenerator())
+        self.register(DocGenerator())
+    
+    def register(self, agent: SubAgent):
+        """Register a subagent"""
+        self.agents[agent.name] = agent
+    
+    def list_agents(self) -> List[Dict[str, Any]]:
+        """List all registered agents"""
+        return [
+            {
+                "name": agent.name,
+                "description": agent.description,
+                "capabilities": agent.capabilities,
+                "status": "ready"
+            }
+            for agent in self.agents.values()
+        ]
+    
+    def get_agent(self, task_description: str) -> Optional[SubAgent]:
+        """Find an agent that can handle the task"""
+        for agent in self.agents.values():
+            if agent.can_handle(task_description):
+                return agent
+        return None
+    
+    async def execute_task(self, description: str, parameters: Dict[str, Any]) -> Dict[str, Any]:
+        """Execute a task using the appropriate agent"""
+        import uuid
+        
+        task = AgentTask(
+            id=str(uuid.uuid4())[:8],
+            description=description,
+            parameters=parameters,
+            status=AgentStatus.RUNNING
+        )
+        
+        agent = self.get_agent(description)
+        if not agent:
+            task.status = AgentStatus.FAILED
+            task.error = "No agent can handle this task"
+            return {"error": task.error}
+        
+        try:
+            agent.current_task = task
+            result = await agent.execute(task)
+            task.result = result
+            task.status = AgentStatus.COMPLETED
+            return {"task_id": task.id, "agent": agent.name, "result": result}
+        except Exception as e:
+            task.status = AgentStatus.FAILED
+            task.error = str(e)
+            return {"error": str(e), "task_id": task.id}
+
+    async def execute_tasks(
+        self, descriptions: List[str], *,
+        manager, provider, model, console, workspace_root, approval_policy: str = "ask",
+        mode: str = "agent", max_concurrency: int = 1,
+    ) -> List[Dict[str, Any]]:
+        """Fan out N sub-objectives concurrently (bounded by max_concurrency),
+        each delegated to the standalone agent loop in its own local session.
+
+        Defaults to sequential (max_concurrency=1): whether concurrent tool
+        execution against the same workspace is safe in every case (two
+        sub-tasks editing overlapping files, concurrent state.json writers
+        from separate local sessions) hasn't been stress-tested -- raise the
+        cap only once you've validated that for your own workloads.
+        """
+        from .workspace import resolve_local_workspace
+
+        semaphore = asyncio.Semaphore(max(1, max_concurrency))
+
+        async def run_one(description: str) -> Dict[str, Any]:
+            async with semaphore:
+                task = AgentTask(id=f"delegated_{uuid.uuid4().hex[:8]}", description=description, status=AgentStatus.RUNNING)
+                self.tasks[task.id] = task
+                try:
+                    workspace = resolve_local_workspace(Path(workspace_root), discover=False)
+                    agent = DelegatedCodingAgent(
+                        manager=manager, provider=provider, model=model, console=console,
+                        workspace_root=workspace.workspace_root, session_id=workspace.session_id,
+                        approval_policy=approval_policy, mode=mode,
+                    )
+                    result = await agent.execute(task)
+                    task.result = result
+                    task.status = AgentStatus.COMPLETED if result.get("status") == "completed" else AgentStatus.FAILED
+                    task.error = result.get("error")
+                except Exception as e:
+                    result = {"error": str(e)}
+                    task.status = AgentStatus.FAILED
+                    task.error = str(e)
+                return {"task_id": task.id, "description": description, "status": task.status.value, "result": result}
+
+        return list(await asyncio.gather(*(run_one(description) for description in descriptions)))