jarvix-core 0.1.0__tar.gz

jarvix_core-0.1.0/.gitignore

@@ -0,0 +1,30 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+*.egg
+build/
+dist/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Tooling caches
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# Environment
+.env
+.env.*
+!.env.example
+
+# Editors / OS
+.idea/
+.vscode/
+.DS_Store

jarvix_core-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 loctvl842
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

jarvix_core-0.1.0/Makefile

@@ -0,0 +1,34 @@
+APP_NAME := `sed -n 's/^ *name.*=.*"\([^"]*\)".*/\1/p' pyproject.toml`
+APP_VERSION := `sed -n 's/^ *version.*=.*"\([^"]*\)".*/\1/p' pyproject.toml`
+
+# Makefile help
+
+.PHONY: header
+header:
+	@printf "\033[34mEnvironment\033[0m"
+	@printf "\n"
+	@printf "\033[34m---------------------------------------------------------------\033[0m"
+	@printf "\n"
+	@printf "\033[33mAPP_NAME: \033[0m"
+	@printf "\033[35m$(APP_NAME)\033[0m"
+	@printf "\n"
+	@printf "\033[33mAPP_VERSION: \033[0m"
+	@printf "\033[35m$(APP_VERSION)\033[0m"
+	@printf "\n\n"
+
+.PHONY: usage
+usage:
+	@printf "\033[034mUsage\033[0m"
+	@printf "\n"
+	@printf "\033[34m---------------------------------------------------------------\033[0m"
+	@printf "\n"
+	@printf "\033[37mmake [options] \033[0m"
+	@printf "\n\n"
+
+.PHONY: options
+options:
+	@printf "\033[34mOptions\033[0m"
+	@printf "\n"
+	@printf "\033[34m---------------------------------------------------------------\033[0m"
+	@printf "\n"
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-22s\033[0m %s\n", $$1, $$2}' | sort

jarvix_core-0.1.0/PKG-INFO

@@ -0,0 +1,23 @@
+Metadata-Version: 2.5
+Name: jarvix-core
+Version: 0.1.0
+Summary: Jarvix core: graph primitives
+Project-URL: Homepage, https://github.com/loctvl842/jarvix
+Project-URL: Repository, https://github.com/loctvl842/jarvix
+Project-URL: Issues, https://github.com/loctvl842/jarvix/issues
+Author-email: loctvl842 <loclepnvx@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,ai,cli,multiplexer,tmux
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# Jarvix Core

jarvix_core-0.1.0/README.md

@@ -0,0 +1 @@
+# Jarvix Core

jarvix_core-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/jarvix"]
+
+[project]
+name = "jarvix-core"
+version = "0.1.0"
+description = "Jarvix core: graph primitives"
+authors = [{ name = "loctvl842", email = "loclepnvx@gmail.com" }]
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["ai", "agents", "tmux", "multiplexer", "cli"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Operating System :: MacOS",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/loctvl842/jarvix"
+Repository = "https://github.com/loctvl842/jarvix"
+Issues = "https://github.com/loctvl842/jarvix/issues"

jarvix_core-0.1.0/src/jarvix/core/__init__.py

@@ -0,0 +1,2 @@
+def hello() -> str:
+    return "Hello from Jarvix Core!"

jarvix_core-0.1.0/src/jarvix/core/graph/__init__.py

@@ -0,0 +1,3 @@
+from .base import Branch, Condition, ConditionalBranch, Edge, Graph, Node
+
+__all__ = ["Branch", "Condition", "ConditionalBranch", "Edge", "Graph", "Node"]

jarvix_core-0.1.0/src/jarvix/core/graph/base.py

@@ -0,0 +1,175 @@
+from __future__ import annotations
+
+import abc
+from collections.abc import Mapping
+from dataclasses import dataclass
+from typing import Any, overload
+
+
+@dataclass(frozen=True)
+class Condition:
+    """Membership of an edge in one arm of a conditional: it is taken only when that arm is chosen."""
+
+    group: ConditionalBranch
+    arm: int
+
+
+@dataclass(frozen=True)
+class Edge:
+    """A link to `target`. Solid (no conditions) when the target always runs.
+
+    Dashed (conditions, outermost first) when the target belongs to arms of
+    conditionals. Only the edges into a conditional are tagged; where the arms
+    join again is implied by the graph shape.
+    """
+
+    target: Node
+    conditions: tuple[Condition, ...] = ()
+
+
+class Graph(abc.ABC):
+    @property
+    @abc.abstractmethod
+    def nodes(self) -> Mapping[str, Node]:
+        """All nodes inside graph"""
+
+    @property
+    @abc.abstractmethod
+    def sources(self) -> set[Node]:
+        """Identify source nodes (nodes with no imcoming edges)"""
+
+    @property
+    @abc.abstractmethod
+    def sinks(self) -> set[Node]:
+        """Identify sink nodes (nodes with no outgoing edges)"""
+
+    @abc.abstractmethod
+    def compile(self) -> None:
+        """Validate graph and prepare it to run"""
+
+    @abc.abstractmethod
+    async def arun(self, input: Any, *, max_steps: int = 100): ...
+
+    @abc.abstractmethod
+    def run(self, input: Any, *, max_steps: int = 100): ...
+
+    @overload
+    def __rshift__(self, other: Node) -> Graph: ...
+
+    @overload
+    def __rshift__(self, other: Graph) -> Graph: ...
+
+    @overload
+    def __rshift__(self, other: Branch) -> Graph: ...
+
+    @overload
+    def __rshift__(self, other: ConditionalBranch) -> Graph: ...
+
+    @abc.abstractmethod
+    def __rshift__(self, other: Node | Graph | Branch | ConditionalBranch) -> Graph: ...
+
+    @abc.abstractmethod
+    def __and__(self, other: Node | Graph | Branch | ConditionalBranch) -> Branch: ...
+
+    @abc.abstractmethod
+    def __or__(self, other: Node | Graph | Branch | ConditionalBranch) -> ConditionalBranch: ...
+
+    def __getattr__(self, node_name: str) -> Graph: ...
+
+
+class Node(abc.ABC):
+    alias: str
+    call: callable[..., Any]
+    edges: set[Edge]
+
+    def __init__(self, name: str):
+        self._name = name
+
+    @property
+    def name(self) -> str:
+        return self._name
+
+    def __eq__(self, other: object) -> bool:
+        if not isinstance(other, Node):
+            return NotImplemented
+        return self.name == other.name
+
+    def __hash__(self) -> int:
+        return hash(self.name)
+
+    def __repr__(self) -> str:
+        return f"{type(self).__name__}({self.name})"
+
+    @overload
+    def __rshift__(self, other: Node) -> Graph: ...
+
+    @overload
+    def __rshift__(self, other: Graph) -> Graph: ...
+
+    @overload
+    def __rshift__(self, other: Branch) -> Graph: ...
+
+    @overload
+    def __rshift__(self, other: ConditionalBranch) -> Graph: ...
+
+    @overload
+    def __and__(self, other: Node | Graph | Branch | ConditionalBranch) -> Branch: ...
+
+    @overload
+    def __or__(self, other: Node | Graph | Branch | ConditionalBranch) -> ConditionalBranch: ...
+
+
+class Branch(abc.ABC):
+    """Members that all run. A member is a Node, a Graph or a ConditionalBranch, never a Branch."""
+
+    @property
+    @abc.abstractmethod
+    def members(self) -> tuple[Node | Graph | ConditionalBranch, ...]:
+        """Direct members of the branch, never what they point to"""
+
+    @property
+    @abc.abstractmethod
+    def sources(self) -> frozenset[Node]:
+        """Nodes a predecessor connects to"""
+
+    @property
+    @abc.abstractmethod
+    def sinks(self) -> frozenset[Node]:
+        """Nodes a successor connects from"""
+
+    @abc.abstractmethod
+    def __rshift__(self, other: Node | Graph | Branch | ConditionalBranch) -> Graph: ...
+
+    @abc.abstractmethod
+    def __and__(self, other: Node | Graph | Branch | ConditionalBranch) -> Branch: ...
+
+    @abc.abstractmethod
+    def __or__(self, other: Node | Graph | Branch | ConditionalBranch) -> ConditionalBranch: ...
+
+
+class ConditionalBranch(abc.ABC):
+    """Alternatives of which exactly one runs. An arm is a Node, a Graph or a Branch, never a ConditionalBranch."""
+
+    @property
+    @abc.abstractmethod
+    def arms(self) -> tuple[Node | Graph | Branch, ...]:
+        """Direct arms of the conditional, never what they point to"""
+
+    @property
+    @abc.abstractmethod
+    def sources(self) -> frozenset[Node]:
+        """Nodes a predecessor connects to (the first nodes of every arm)"""
+
+    @property
+    @abc.abstractmethod
+    def sinks(self) -> frozenset[Node]:
+        """Nodes a successor connects from (the last nodes of every arm)"""
+
+    @abc.abstractmethod
+    def __rshift__(self, other: Node | Graph | Branch | ConditionalBranch) -> Graph: ...
+
+    @abc.abstractmethod
+    def __and__(self, other: Node | Graph | Branch | ConditionalBranch) -> Branch: ...
+
+    @abc.abstractmethod
+    def __or__(self, other: Node | Graph | Branch | ConditionalBranch) -> ConditionalBranch: ...