orxtra 0.1.0__tar.gz

orxtra-0.1.0/.gitignore

@@ -0,0 +1,23 @@
+__pycache__/
+*.pyc
+.venv/
+*.egg-info/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+dist/
+build/
+docs/_build/
+.env
+node_modules/
+
+*.log
+.DS_Store
+coverage/
+.rlsbl-notes-*.tmp
+.rlsbl/lock
+.rlsbl-monorepo/lock
+.credentials.json
+.*-cache.json
+.env.local
+*.local-only

orxtra-0.1.0/LICENSE

@@ -0,0 +1,61 @@
+License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Parameters
+
+Licensor:             SMM-H
+Licensed Work:        orxtra. The Licensed Work is (c) 2026 SMM-H.
+Additional Use Grant: You may make non-production use of the Licensed Work
+                      for purposes of development, testing, evaluation, and
+                      education. Production use of the Licensed Work requires
+                      a commercial license from the Licensor.
+Change Date:          2030-06-19
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed
+Work, please contact i@smmh.dev.
+
+Notice
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.

orxtra-0.1.0/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: orxtra
+Version: 0.1.0
+Summary: Autonomous multi-agent AI workflows
+License-Expression: BUSL-1.1
+License-File: LICENSE
+Keywords: rlsbl
+Requires-Python: >=3.12
+Requires-Dist: asyncpg
+Requires-Dist: cognee
+Requires-Dist: httpx
+Requires-Dist: jsonschema
+Requires-Dist: pathspec
+Requires-Dist: pydantic>=2
+Requires-Dist: strictcli
+Requires-Dist: uuid6

orxtra-0.1.0/agent/pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "orxtra-agent"
+version = "0.1.1"
+license = "BUSL-1.1"
+description = "Agent definition loader. TOML + composable .md prompts, strict validation, category resolution."
+requires-python = ">=3.12"
+dependencies = [
+    "pydantic>=2",
+]
+keywords = ["rlsbl"]
+
+[dependency-groups]
+dev = ["pytest>=9.1.0"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/orxtra"]

orxtra-0.1.0/agent/src/orxtra/agent/__init__.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+from orxtra.agent._categories import load_categories, resolve_category
+from orxtra.agent._loader import load_agent, load_agents
+from orxtra.agent._prompt import resolve_includes, resolve_prompt
+from orxtra.agent._types import Agent, ExecToolConfig, ShellConfig
+
+__all__ = [
+    "Agent",
+    "ExecToolConfig",
+    "ShellConfig",
+    "load_agent",
+    "load_agents",
+    "load_categories",
+    "resolve_category",
+    "resolve_includes",
+    "resolve_prompt",
+]

orxtra-0.1.0/agent/src/orxtra/agent/_categories.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+import tomllib
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+    from orxtra.agent._types import Agent
+
+
+def load_categories(path: Path) -> dict[str, str]:
+    if not path.is_file():
+        msg = f"Categories file not found: {path}"
+        raise FileNotFoundError(msg)
+    with path.open("rb") as f:
+        data = tomllib.load(f)
+    if "categories" not in data:
+        msg = f"Missing [categories] section in {path}"
+        raise ValueError(msg)
+    categories: dict[str, str] = data["categories"]
+    return categories
+
+
+def resolve_category(agent: Agent, categories: dict[str, str]) -> str:
+    if agent.category not in categories:
+        msg = f"Unknown category: {agent.category}"
+        raise ValueError(msg)
+    return categories[agent.category]

orxtra-0.1.0/agent/src/orxtra/agent/_loader.py

@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+import tomllib
+from typing import TYPE_CHECKING, Any
+
+from orxtra.agent._prompt import resolve_includes
+from orxtra.agent._types import Agent
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+
+def load_agent(path: Path) -> Agent:
+    if not path.is_file():
+        msg = f"Agent file not found: {path}"
+        raise FileNotFoundError(msg)
+    with path.open("rb") as f:
+        data = tomllib.load(f)
+
+    agent_section: dict[str, Any] = dict(data.get("agent", {}))
+    if "tools" not in data:
+        msg = f"Missing [tools] section in {path}"
+        raise ValueError(msg)
+    tools_section: dict[str, Any] = data["tools"]
+
+    prompt_rel = agent_section.pop("prompt", "")
+    prompt_path = (path.parent / prompt_rel).resolve()
+    if not prompt_path.is_file():
+        msg = f"Prompt file not found: {prompt_path}"
+        raise FileNotFoundError(msg)
+    prompt_text = prompt_path.read_text()
+    prompt_text = resolve_includes(prompt_text, prompt_path.parent)
+
+    agent_section["prompt"] = prompt_text
+    if "allow" not in tools_section:
+        msg = f"Missing 'allow' key in [tools] section in {path}"
+        raise ValueError(msg)
+    unknown_keys = set(tools_section.keys()) - {"allow"}
+    if unknown_keys:
+        names = ", ".join(sorted(unknown_keys))
+        msg = f"Unknown keys in [tools] section: {names}"
+        raise ValueError(msg)
+    agent_section["allow"] = tools_section["allow"]
+
+    exec_configs: list[dict[str, Any]] = data.get("exec", [])
+    shell_section: dict[str, Any] | None = data.get("shell")
+    agent_section["exec_tools"] = exec_configs
+    agent_section["shell_config"] = shell_section
+
+    return Agent(**agent_section)
+
+
+def load_agents(directory: Path) -> dict[str, Agent]:
+    agents: dict[str, Agent] = {}
+    for toml_path in sorted(directory.glob("*.toml")):
+        agent = load_agent(toml_path)
+        if agent.name in agents:
+            msg = f"Duplicate agent name: {agent.name}"
+            raise ValueError(msg)
+        agents[agent.name] = agent
+    return agents

orxtra-0.1.0/agent/src/orxtra/agent/_prompt.py

@@ -0,0 +1,57 @@
+from __future__ import annotations
+
+import re
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+_INCLUDE_RE = re.compile(r"\{include:([^}]+)\}")
+_VAR_RE = re.compile(r"\{([a-zA-Z_][a-zA-Z0-9_]*)\}")
+
+
+def resolve_includes(template: str, base_dir: Path) -> str:
+    return _resolve_includes(template, base_dir, frozenset())
+
+
+def _resolve_includes(
+    template: str, base_dir: Path, seen: frozenset[Path]
+) -> str:
+    def replacer(match: re.Match[str]) -> str:
+        rel_path = match.group(1)
+        abs_path = (base_dir / rel_path).resolve()
+        if abs_path in seen:
+            msg = f"Circular include detected: {abs_path}"
+            raise ValueError(msg)
+        if not abs_path.is_file():
+            msg = f"Include file not found: {abs_path}"
+            raise FileNotFoundError(msg)
+        content = abs_path.read_text()
+        return _resolve_includes(content, abs_path.parent, seen | {abs_path})
+
+    return _INCLUDE_RE.sub(replacer, template)
+
+
+def resolve_prompt(template: str, variables: dict[str, str]) -> str:
+    placeholders = set(_VAR_RE.findall(template))
+    var_keys = set(variables.keys())
+
+    unresolved = placeholders - var_keys
+    if unresolved:
+        name = sorted(unresolved)[0]
+        msg = f"Unresolved placeholder: {{{name}}}"
+        raise ValueError(msg)
+
+    unused = var_keys - placeholders
+    if unused:
+        name = sorted(unused)[0]
+        msg = f"Unused variable: {name}"
+        raise ValueError(msg)
+
+    if not placeholders:
+        return template
+
+    def replacer(match: re.Match[str]) -> str:
+        return variables[match.group(1)]
+
+    return _VAR_RE.sub(replacer, template)

orxtra-0.1.0/agent/src/orxtra/agent/_types.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+from pydantic import BaseModel, ConfigDict
+
+
+class ExecToolConfig(BaseModel):
+    model_config = ConfigDict(frozen=True, strict=True, extra="forbid")
+    name: str
+    executable: str
+    description: str
+    timeout_ceiling: int = 300
+
+
+class ShellConfig(BaseModel):
+    model_config = ConfigDict(frozen=True, strict=True, extra="forbid")
+    allowed_binaries: list[str]
+    description: str = "Execute shell commands with whitelisted binaries"
+    timeout_ceiling: int = 300
+
+
+class Agent(BaseModel):
+    model_config = ConfigDict(frozen=True, strict=True, extra="forbid")
+    name: str
+    description: str
+    prompt: str
+    category: str
+    allow: list[str]
+    exec_tools: list[ExecToolConfig] = []
+    shell_config: ShellConfig | None = None

orxtra-0.1.0/cli/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "orxtra-cli"
+version = "0.1.1"
+license = "BUSL-1.1"
+description = "strictcli CLI frontend. Agents are the primary users."
+requires-python = ">=3.12"
+dependencies = [
+    "strictcli",
+    "orxtra-services",
+    "orxtra-trace",
+]
+keywords = ["rlsbl"]
+
+[project.scripts]
+orxtra = "orxtra.cli._cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/orxtra"]
+
+[tool.uv.sources]
+orxtra-services = { workspace = true }
+orxtra-trace = { workspace = true }