bindai-cli 0.1.0__py3-none-any.whl

bindai_cli/commands/workflow.py

@@ -0,0 +1,112 @@
+from __future__ import annotations
+
+import subprocess
+import sys
+from pathlib import Path
+
+import typer
+from bindai_config import ProjectRuntime
+from rich import print
+
+app = typer.Typer()
+
+
+def resolve_workflow(
+    workflow: str | None,
+) -> Path:
+
+    runtime = ProjectRuntime(
+        Path.cwd(),
+    )
+
+    if workflow is None:
+        workflow = runtime.config.entrypoint
+
+    return Path(workflow)
+
+
+@app.command("run")
+def run(
+    workflow: str | None = typer.Argument(
+        None,
+        help="Workflow entrypoint.",
+    ),
+):
+
+    path = resolve_workflow(
+        workflow,
+    )
+
+    if not path.exists():
+        print(f"[red]{path} not found.[/red]")
+
+        raise typer.Exit(1)
+
+    subprocess.run(
+        [
+            sys.executable,
+            str(path),
+        ],
+        check=True,
+    )
+
+
+@app.command("validate")
+def validate(
+    workflow: str | None = typer.Argument(
+        None,
+    ),
+):
+
+    from bindai_cli.workflows.validator import (
+        WorkflowValidator,
+    )
+
+    path = resolve_workflow(
+        workflow,
+    )
+
+    errors = WorkflowValidator.validate(
+        path,
+    )
+
+    if errors:
+        print()
+
+        for error in errors:
+            print(f"[red]✗ {error}[/red]")
+
+        raise typer.Exit(1)
+
+    print()
+
+    print("[green]✓ Workflow is valid.[/green]")
+
+
+@app.command("graph")
+def graph(
+    workflow: str | None = typer.Argument(
+        None,
+    ),
+):
+
+    from bindai_cli.workflows.graph import (
+        WorkflowGraph,
+    )
+
+    path = resolve_workflow(
+        workflow,
+    )
+
+    if not path.exists():
+        print(f"[red]{path} not found.[/red]")
+
+        raise typer.Exit(1)
+
+    print()
+
+    print(
+        WorkflowGraph.generate(
+            path,
+        )
+    )

bindai_cli/generators/__init__.py

@@ -0,0 +1,9 @@
+from .agent import generate_agent
+from .tool import generate_tool
+from .workflow import generate_workflow
+
+__all__ = [
+    "generate_agent",
+    "generate_tool",
+    "generate_workflow",
+]

bindai_cli/generators/agent.py

@@ -0,0 +1,8 @@
+from pathlib import Path
+
+
+def generate_agent(
+    root: Path,
+    name: str,
+) -> None:
+    pass

bindai_cli/generators/directories.py

@@ -0,0 +1,23 @@
+from pathlib import Path
+
+DIRECTORIES = [
+    "agents",
+    "knowledge",
+    "memory",
+    "templates",
+    "tools",
+    "workflows",
+    "tests",
+]
+
+
+def generate_directories(root: Path):
+    for directory in DIRECTORIES:
+        path = root / directory
+
+        path.mkdir(
+            parents=True,
+            exist_ok=True,
+        )
+
+        (path / ".gitkeep").touch()

bindai_cli/generators/pyproject.py

@@ -0,0 +1,23 @@
+from pathlib import Path
+
+
+def generate_pyproject(
+    root: Path,
+    name: str,
+):
+    content = f"""
+[project]
+name = "{name.lower()}"
+version = "0.1.0"
+description = "{name}"
+requires-python = ">=3.11"
+
+dependencies = [
+    "bindai",
+]
+""".strip()
+
+    (root / "pyproject.toml").write_text(
+        content,
+        encoding="utf-8",
+    )

bindai_cli/generators/tool.py

@@ -0,0 +1,8 @@
+from pathlib import Path
+
+
+def generate_tool(
+    root: Path,
+    name: str,
+) -> None:
+    pass

bindai_cli/generators/workflow.py

@@ -0,0 +1,31 @@
+from pathlib import Path
+
+WORKFLOW_TEMPLATE = """from bindai_workflow import WorkflowBuilder
+
+
+workflow = (
+    WorkflowBuilder()
+    .name("{name}")
+    .build()
+)
+"""
+
+
+def generate_workflow(
+    root: Path,
+    name: str,
+) -> None:
+    workflows_dir = root / "workflows"
+    workflows_dir.mkdir(parents=True, exist_ok=True)
+
+    filename = name.replace(" ", "_").replace("-", "_").lower()
+
+    workflow_file = workflows_dir / f"{filename}.py"
+
+    if workflow_file.exists():
+        raise FileExistsError(f"Workflow '{name}' already exists.")
+
+    workflow_file.write_text(
+        WORKFLOW_TEMPLATE.format(name=name),
+        encoding="utf-8",
+    )

bindai_cli/inspectors/project.py

@@ -0,0 +1,34 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+
+class ProjectInspector:
+    def __init__(
+        self,
+        root: Path,
+    ):
+        self.root = root
+
+    def inspect(self) -> dict:
+
+        return {
+            "agents": self._files("agents"),
+            "tools": self._files("tools"),
+            "workflows": self._files("workflows"),
+            "knowledge": self._files("knowledge"),
+            "memory": self._files("memory"),
+            "templates": self._files("templates"),
+        }
+
+    def _files(
+        self,
+        folder: str,
+    ) -> list[str]:
+
+        path = self.root / folder
+
+        if not path.exists():
+            return []
+
+        return sorted(file.stem for file in path.glob("*.py") if file.name != "__init__.py")

bindai_cli/scaffolds/basic/agents/assistant.py

@@ -0,0 +1,6 @@
+from bindai import Agent
+
+agent = Agent(
+    name="assistant",
+    provider="openai",
+)

bindai_cli/scaffolds/basic/main.py

@@ -0,0 +1,20 @@
+from agents.assistant import agent
+
+
+def main():
+
+    print("BindAI Project")
+
+    while True:
+        message = input("You: ")
+
+        if message.lower() == "exit":
+            break
+
+        response = agent.run(message)
+
+        print(f"Assistant: {response}")
+
+
+if __name__ == "__main__":
+    main()

bindai_cli/scaffolds/basic/tools/echo.py

@@ -0,0 +1,8 @@
+from bindai_tool import tool
+
+
+@tool
+def echo(
+    text: str,
+) -> str:
+    return text

bindai_cli/templates/installer.py

@@ -0,0 +1,58 @@
+from __future__ import annotations
+
+import shutil
+from pathlib import Path
+
+from .registry import TemplateRegistry
+from .validator import TemplateValidator
+
+
+class TemplateInstaller:
+    def __init__(self):
+
+        self.registry = TemplateRegistry()
+
+    def install(
+        self,
+        name: str,
+        destination: Path,
+    ):
+
+        template = self.registry.get(name)
+
+        if template is None:
+            raise ValueError(f"Unknown template '{name}'.")
+
+        source = Path(template.path)
+
+        errors = TemplateValidator.validate(source)
+
+        if errors:
+            raise ValueError("\n".join(errors))
+
+        shutil.copytree(
+            source,
+            destination,
+            dirs_exist_ok=True,
+            ignore=shutil.ignore_patterns(
+                "__pycache__",
+                ".pytest_cache",
+                "*.pyc",
+                ".env",
+            ),
+        )
+
+        example = destination / ".env.example"
+
+        env = destination / ".env"
+
+        if example.exists() and not env.exists():
+            shutil.copy2(
+                example,
+                env,
+            )
+
+        errors = TemplateValidator.validate(source)
+
+        if errors:
+            raise ValueError("\n".join(errors))

bindai_cli/templates/models.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass(slots=True)
+class Template:
+    name: str
+
+    title: str
+
+    description: str
+
+    version: str
+
+    author: str
+
+    category: str
+
+    status: str
+
+    tags: list[str]
+
+    path: str

bindai_cli/templates/registry.py

@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from .models import Template
+
+
+class TemplateRegistry:
+    def __init__(self):
+
+        current = Path(__file__).resolve()
+
+        while current.name != "bindai":
+            current = current.parent
+
+        self.root = current / "templates"
+
+    def list(self) -> list[Template]:
+
+        templates = []
+
+        for folder in sorted(self.root.iterdir()):
+            metadata = folder / "template.json"
+
+            if not metadata.exists():
+                continue
+
+            data = json.loads(metadata.read_text(encoding="utf-8"))
+
+            templates.append(
+                Template(
+                    **data,
+                    path=str(folder),
+                )
+            )
+
+        return templates
+
+    # <-- ADD THIS METHOD HERE
+
+    def get(
+        self,
+        name: str,
+    ) -> Template | None:
+
+        for template in self.list():
+            if template.name == name:
+                return template
+
+        return None

bindai_cli/templates/validator.py

@@ -0,0 +1,56 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+REQUIRED_FILES = {
+    "README.md",
+    "main.py",
+    "template.json",
+}
+
+
+class TemplateValidator:
+    @staticmethod
+    def validate(
+        path: Path,
+    ) -> list[str]:
+
+        errors: list[str] = []
+
+        # Required files
+        for filename in REQUIRED_FILES:
+            if not (path / filename).exists():
+                errors.append(f"Missing required file: {filename}")
+
+        # Stop early if template.json doesn't exist
+        metadata = path / "template.json"
+
+        if not metadata.exists():
+            return errors
+
+        # Validate metadata structure
+        try:
+            data = json.loads(
+                metadata.read_text(
+                    encoding="utf-8",
+                )
+            )
+
+        except Exception:
+            errors.append("Invalid template.json")
+
+            return errors
+
+        required_fields = [
+            "name",
+            "version",
+            "category",
+            "description",
+        ]
+
+        for field in required_fields:
+            if field not in data:
+                errors.append(f"template.json missing '{field}'.")
+
+        return errors

bindai_cli/utils/config.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from bindai_config import ProjectRuntime
+
+
+def load_config():
+
+    runtime = ProjectRuntime(
+        Path.cwd(),
+    )
+
+    return runtime.config

bindai_cli/utils/providers.py

@@ -0,0 +1,8 @@
+from __future__ import annotations
+
+from bindai_providers import ProviderRegistry
+
+
+def installed_providers():
+
+    return ProviderRegistry.list()

bindai_cli/utils/scaffold.py

@@ -0,0 +1,62 @@
+from __future__ import annotations
+
+import shutil
+from pathlib import Path
+
+
+def copy_scaffold(
+    scaffold: Path,
+    destination: Path,
+) -> None:
+
+    shutil.copytree(
+        scaffold,
+        destination,
+    )
+
+    replace_placeholders(
+        destination,
+        destination.name,
+    )
+
+    example = destination / ".env.example"
+    env = destination / ".env"
+
+    if example.exists() and not env.exists():
+        shutil.copy2(
+            example,
+            env,
+        )
+
+
+def replace_placeholders(
+    root: Path,
+    project_name: str,
+):
+
+    for file in root.rglob("*"):
+        if not file.is_file():
+            continue
+
+        if file.suffix not in {
+            ".py",
+            ".toml",
+            ".md",
+            ".txt",
+            ".example",
+        }:
+            continue
+
+        text = file.read_text(
+            encoding="utf-8",
+        )
+
+        text = text.replace(
+            "{{PROJECT_NAME}}",
+            project_name,
+        )
+
+        file.write_text(
+            text,
+            encoding="utf-8",
+        )

bindai_cli/workflows/graph.py

@@ -0,0 +1,34 @@
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+
+class WorkflowGraph:
+    @staticmethod
+    def generate(
+        path: Path,
+    ) -> str:
+
+        source = path.read_text(
+            encoding="utf-8",
+        )
+
+        nodes = re.findall(
+            r'\.step\(\s*"([^"]+)"',
+            source,
+        )
+
+        mermaid = [
+            "graph TD",
+        ]
+
+        for i, node in enumerate(nodes):
+            mermaid.append(f'    N{i}["{node}"]')
+
+            if i:
+                mermaid.append(f"    N{i - 1} --> N{i}")
+
+        return "\n".join(
+            mermaid,
+        )

bindai_cli/workflows/validator.py

@@ -0,0 +1,32 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+
+class WorkflowValidator:
+    @staticmethod
+    def validate(
+        path: Path,
+    ) -> list[str]:
+
+        errors: list[str] = []
+
+        if not path.exists():
+            errors.append("Workflow file does not exist.")
+
+            return errors
+
+        if path.suffix != ".py":
+            errors.append("Workflow must be a Python file.")
+
+        source = path.read_text(
+            encoding="utf-8",
+        )
+
+        if "WorkflowBuilder" not in source:
+            errors.append("WorkflowBuilder not found.")
+
+        if ".build(" not in source:
+            errors.append("Workflow is never built.")
+
+        return errors

bindai_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: bindai-cli
+Version: 0.1.0
+Summary: BindAI Command Line Interface
+Requires-Python: >=3.11
+Requires-Dist: typer>=0.16
+Requires-Dist: rich>=14.0

bindai_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,38 @@
+bindai_cli/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+bindai_cli/__main__.py,sha256=Gpn78kwiVDeNE0gIwM_6UHrxfbFtK4jWo7YhGyOXEo0,104
+bindai_cli/app.py,sha256=aT5GU0fRaAI8SWgFnxI9c5W9ZdbVznPs-om_NsCD2kI,923
+bindai_cli/commands/__init__.py,sha256=lg-8o1BiEbV_v56pvQFXp65EX44DHFoza_z5mVX4RTQ,33
+bindai_cli/commands/add.py,sha256=ZzSzstAxV54NWiexrsc31W1rfar0rIKelozbFPx8qE4,429
+bindai_cli/commands/doctor.py,sha256=Li4hthN504UMvxv6kLvITLfdxn3QxgWn6UcpR8cYZ6w,2350
+bindai_cli/commands/inspect.py,sha256=okKn0J-GcadjJR9ej3CEeJrAaHA9yBhbCj4xMA_2ctY,805
+bindai_cli/commands/new.py,sha256=o_MXFDBXL3aEVaGK4WbY5yhyXYv2kM0ARWaoix6Zh-E,1643
+bindai_cli/commands/run.py,sha256=ZAtYD9V8uKDpZYRs0-v1xHlV7cJAb7WNFHoDWxE65gs,1182
+bindai_cli/commands/template.py,sha256=4D-jS-JjHtsiLPcSt64KL7FEWNV3Prs8Fe-U0M7fqyQ,4999
+bindai_cli/commands/version.py,sha256=uKmW1CmHFhRrFQW3z5R2PDqIUEfkhxMyqpNcmqqfZVw,200
+bindai_cli/commands/workflow.py,sha256=u_Jc8eww7dkffhh9jkaZn8xoppqsEecCENt0OxnXTVk,1861
+bindai_cli/generators/__init__.py,sha256=Ob4IRmKVbdCZmXDa1mfJ7RcXPlpvxhgSaRl6tSpiEbI,198
+bindai_cli/generators/agent.py,sha256=vI7MkTRU06NrIS2Fkdj1mTZxy-ePNh8A8aiER-mPLtk,106
+bindai_cli/generators/directories.py,sha256=HQ9d8NQK9cXukHNs_j_cn2XCwKY2creM5mSCDM1HfBY,399
+bindai_cli/generators/knowledge.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+bindai_cli/generators/memory.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+bindai_cli/generators/pyproject.py,sha256=VTWXmrDvSfS8RjWlh29RRVCjVLYD1GViVurCywhsaSY,367
+bindai_cli/generators/tool.py,sha256=ArMSIt4iAuUJaYNTmn-wcSkysDJ5BpuWcjLy--bPrUk,105
+bindai_cli/generators/workflow.py,sha256=-LDBylzqHcVMZDrI-_yhIj90C8SLPX1HSSLSjWbj0rU,686
+bindai_cli/inspectors/project.py,sha256=TlADrUvinBDknYRXiP2vhlOdt89m357jrcpdlUxdZQA,805
+bindai_cli/scaffolds/basic/main.py,sha256=lmzY5xQ3kwsgPZGfDBnnHHwj91B_t6ey2UNn3WQNpH4,325
+bindai_cli/scaffolds/basic/agents/assistant.py,sha256=GPclvkb-AxwXDfEeOLdUEBOgsIxJHbknG8Z0QHmlSIM,94
+bindai_cli/scaffolds/basic/tools/echo.py,sha256=0yhBWarqt8ASbv4xNN5El0zZh8tqucxrtBvvjguNwsM,96
+bindai_cli/templates/installer.py,sha256=MNnWBdjGtmIve7Hv6-P2sbGgxqJpzfec5iVUDv34PGw,1313
+bindai_cli/templates/models.py,sha256=ffHS6rljWWm6iU2PEhCyTKvIKpjXuApzm1hLQ2JSTvE,294
+bindai_cli/templates/registry.py,sha256=3OOFtiXDw9IlFewZK7QFTWqafBcLQXnpLqQGPJThND0,1080
+bindai_cli/templates/validator.py,sha256=SOC8gHODWpAf_BIA0C_xnvClP_iNYe4SjdEzXd2jXKM,1266
+bindai_cli/utils/config.py,sha256=W6IwsKKLH57lxdkrIXajkZWHyrrCC99unx8qDLdeLDk,222
+bindai_cli/utils/providers.py,sha256=_DUW4SdOL4Xskfike2pyQPknPrH1bva47yJFUCAGB64,155
+bindai_cli/utils/scaffold.py,sha256=SYOJu6c-Zy7oJGso7DCP3FZr6f-je0KMOmrihtQV4VE,1129
+bindai_cli/workflows/graph.py,sha256=m9MmlXs0Ka45jycbA_r3v0nSVq2G8K7IAjH_jtYJAno,649
+bindai_cli/workflows/validator.py,sha256=C6vhFNOnQboEdrVaBScPg_l56GN-NI2NEBxUA7FU-08,729
+bindai_cli-0.1.0.dist-info/METADATA,sha256=EPFFPQj1FnSWU7c83boOvffvR-uEWiw0Rg6oCLC1aSs,177
+bindai_cli-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+bindai_cli-0.1.0.dist-info/entry_points.txt,sha256=3YDlkt-YcYlc0pGZi0Kvtn1ZW3ny9wElGwN5n1l8HTQ,52
+bindai_cli-0.1.0.dist-info/top_level.txt,sha256=kN1kzqAvwLSUkhdK7m88HL5ttWVvNRpRnclMeRWN7wM,11
+bindai_cli-0.1.0.dist-info/RECORD,,