optio-grok 0.1.0__tar.gz

optio_grok-0.1.0/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: optio-grok
+Version: 0.1.0
+Summary: Run Grok Build (xAI) as an optio task; local subprocess or remote via SSH; ttyd-served TUI iframe.
+Author-email: Kristof Csillag <kristof.csillag@deai-labs.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/deai-network/optio
+Project-URL: Repository, https://github.com/deai-network/optio
+Project-URL: Issues, https://github.com/deai-network/optio/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: optio-core<0.4,>=0.3
+Requires-Dist: optio-host<0.3,>=0.2
+Requires-Dist: optio-agents<0.4,>=0.3
+Requires-Dist: asyncssh>=2.14
+Requires-Dist: aiohttp>=3.9
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+
+# optio-grok
+
+Run Grok Build (xAI) as an `optio` task — either as a local subprocess
+or on a remote host over SSH — with the interactive TUI embedded in the
+optio dashboard via an iframe widget served by `ttyd`.
+
+## Install
+
+```bash
+pip install optio-grok
+```
+
+Requires Python 3.11+. Pulls `optio-core`, `optio-host`, `optio-agents`,
+`asyncssh`, and `aiohttp`.
+
+## What it does
+
+Grok Build is a near-twin of Claude Code. optio-grok adapts the
+`optio-claudecode` machinery: it launches `grok` inside a detached tmux
+session, serves the TUI over `ttyd`, and coordinates with the host
+harness through the `optio.log` keyword channel (STATUS / DELIVERABLE /
+DONE / ERROR). The agent reads its task from an `AGENTS.md` file planted
+in the workdir.
+
+### Isolation
+
+Each task runs under an isolated `HOME` (`<workdir>/home`) with
+`GROK_HOME` pointing at `<workdir>/home/.grok`. Grok ships a
+claude-compat layer, so `CLAUDE_CONFIG_DIR` is pinned at
+`<workdir>/home/.claude` to keep the operator's real `~/.claude`
+configuration, hooks, and instructions from leaking into the task.
+`--no-leader` is always passed so tasks never share a grok backend.
+
+## Status
+
+Stage 0 (MVP): iframe/ttyd mode, local host. Resume, seeds,
+conversation mode, and filesystem isolation arrive in later stages.

optio_grok-0.1.0/README.md

@@ -0,0 +1,37 @@
+# optio-grok
+
+Run Grok Build (xAI) as an `optio` task — either as a local subprocess
+or on a remote host over SSH — with the interactive TUI embedded in the
+optio dashboard via an iframe widget served by `ttyd`.
+
+## Install
+
+```bash
+pip install optio-grok
+```
+
+Requires Python 3.11+. Pulls `optio-core`, `optio-host`, `optio-agents`,
+`asyncssh`, and `aiohttp`.
+
+## What it does
+
+Grok Build is a near-twin of Claude Code. optio-grok adapts the
+`optio-claudecode` machinery: it launches `grok` inside a detached tmux
+session, serves the TUI over `ttyd`, and coordinates with the host
+harness through the `optio.log` keyword channel (STATUS / DELIVERABLE /
+DONE / ERROR). The agent reads its task from an `AGENTS.md` file planted
+in the workdir.
+
+### Isolation
+
+Each task runs under an isolated `HOME` (`<workdir>/home`) with
+`GROK_HOME` pointing at `<workdir>/home/.grok`. Grok ships a
+claude-compat layer, so `CLAUDE_CONFIG_DIR` is pinned at
+`<workdir>/home/.claude` to keep the operator's real `~/.claude`
+configuration, hooks, and instructions from leaking into the task.
+`--no-leader` is always passed so tasks never share a grok backend.
+
+## Status
+
+Stage 0 (MVP): iframe/ttyd mode, local host. Resume, seeds,
+conversation mode, and filesystem isolation arrive in later stages.

optio_grok-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "optio-grok"
+version = "0.1.0"
+description = "Run Grok Build (xAI) as an optio task; local subprocess or remote via SSH; ttyd-served TUI iframe."
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.11"
+authors = [
+    { name = "Kristof Csillag", email = "kristof.csillag@deai-labs.com" },
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Code Generators",
+    "Framework :: AsyncIO",
+]
+dependencies = [
+    "optio-core>=0.3,<0.4",
+    "optio-host>=0.2,<0.3",
+    "optio-agents>=0.3,<0.4",
+    "asyncssh>=2.14",
+    "aiohttp>=3.9",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+]
+
+[project.urls]
+Homepage = "https://github.com/deai-network/optio"
+Repository = "https://github.com/deai-network/optio"
+Issues = "https://github.com/deai-network/optio/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

optio_grok-0.1.0/setup.cfg

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

optio_grok-0.1.0/src/optio_grok/__init__.py

@@ -0,0 +1,60 @@
+"""optio-grok — run Grok Build (xAI) as an optio task."""
+
+import logging as _logging
+
+from optio_agents import HookContext, HookContextProtocol
+from optio_host import (
+    HostCommandError,
+    RunResult,
+    SSHConfig,
+)
+
+from optio_grok.seed_manifest import (
+    GROK_CRED_MANIFEST,
+    GROK_SEED_MANIFEST,
+    GROK_SEED_SUFFIX,
+    delete_seed,
+    list_seeds,
+    purge_seed,
+)
+from optio_grok.session import create_grok_task, run_grok_session
+from optio_grok.verify import verify_and_refresh_seed
+from optio_grok.types import (
+    AllowedDir,
+    DeliverableCallback,
+    GrokTaskConfig,
+    HookCallback,
+    PermissionMode,
+    SeedProvider,
+    SeedUnavailableError,
+)
+
+
+# asyncssh emits per-connection INFO lines that flood worker stdout
+# once an SSH-backed session starts. Quiet by default.
+_logging.getLogger("asyncssh").setLevel(_logging.WARNING)
+
+
+__all__ = [
+    "create_grok_task",
+    "run_grok_session",
+    "GrokTaskConfig",
+    "DeliverableCallback",
+    "HookCallback",
+    "PermissionMode",
+    "SSHConfig",
+    "HookContext",
+    "HookContextProtocol",
+    "HostCommandError",
+    "RunResult",
+    "GROK_SEED_MANIFEST",
+    "GROK_CRED_MANIFEST",
+    "GROK_SEED_SUFFIX",
+    "delete_seed",
+    "list_seeds",
+    "purge_seed",
+    "verify_and_refresh_seed",
+    "SeedProvider",
+    "SeedUnavailableError",
+    "AllowedDir",
+]