agent-runtime-cockpit 0.1.0a0__tar.gz

agent_runtime_cockpit-0.1.0a0/.gitignore

@@ -0,0 +1,5 @@
+*.coverage
+coverage.xml
+python/.arc/*.db
+python/.arc/*.db
+coverage.json

agent_runtime_cockpit-0.1.0a0/.importlinter

@@ -0,0 +1,43 @@
+# Import-linter architecture contracts (audit P1-1 / HAN-199).
+#
+# Enforces the layering the architecture audit recommended: domain/infrastructure
+# modules must NOT depend on the interface layer (CLI / TUI / web daemon routes).
+# These "forbidden" contracts encode invariants that hold TODAY and will fail CI
+# on any future violation. Run: `lint-imports --config .importlinter`.
+
+[importlinter]
+root_package = agent_runtime_cockpit
+# The private SwarmGraph SDK is an external, optional git dependency; ignore its
+# bridge submodule graph so the linter can build the import graph without it.
+include_external_packages = False
+
+[importlinter:contract:domain-no-interfaces]
+name = Domain/infra modules must not import interface layers (cli/tui/web)
+type = forbidden
+source_modules =
+    agent_runtime_cockpit.security
+    agent_runtime_cockpit.audit
+    agent_runtime_cockpit.protocol
+    agent_runtime_cockpit.isolation
+    agent_runtime_cockpit.budget
+    agent_runtime_cockpit.evals
+    agent_runtime_cockpit.capabilities
+    agent_runtime_cockpit.run_diff
+    agent_runtime_cockpit.providers
+    agent_runtime_cockpit.storage
+forbidden_modules =
+    agent_runtime_cockpit.cli
+    agent_runtime_cockpit.tui
+    agent_runtime_cockpit.web
+
+[importlinter:contract:protocol-is-foundational]
+name = Protocol must not depend on higher layers
+type = forbidden
+source_modules =
+    agent_runtime_cockpit.protocol
+forbidden_modules =
+    agent_runtime_cockpit.cli
+    agent_runtime_cockpit.tui
+    agent_runtime_cockpit.web
+    agent_runtime_cockpit.adapters
+    agent_runtime_cockpit.integrations

agent_runtime_cockpit-0.1.0a0/LICENSE

@@ -0,0 +1,134 @@
+ARC STUDIO PROPRIETARY LICENSE
+
+Copyright (c) 2025–2026 Hans Vilund. All rights reserved.
+
+NOTICE: THIS IS NOT AN OPEN SOURCE LICENSE.
+
+This license governs the use of ARC Studio and all associated source code,
+documentation, assets, scripts, configuration files, and other materials
+contained in this repository (collectively, the "Software").
+
+--------------------------------------------------------------------------------
+1. GRANT OF LIMITED VIEW ACCESS
+--------------------------------------------------------------------------------
+
+Subject to the terms and conditions of this License, the copyright holder
+grants you a limited, non-exclusive, non-transferable, revocable right to view
+the source code of the Software solely for the purpose of personal evaluation
+on your own device.
+
+This grant does NOT include any right to:
+
+  (a) copy, reproduce, or duplicate the Software or any portion thereof,
+      except as strictly necessary for local evaluation purposes;
+  (b) modify, adapt, translate, alter, transform, or create derivative works
+      based on the Software;
+  (c) merge the Software or any portion thereof into any other software,
+      product, or service;
+  (d) distribute, publish, transmit, sublicense, or make available the
+      Software or any portion thereof to any third party by any means;
+  (e) sell, resell, rent, lease, lend, or otherwise transfer the Software
+      or any rights therein;
+  (f) rebrand, rename, or otherwise present the Software or any derivative
+      work under a different name, identity, or branding;
+  (g) use the Software, in whole or in part, as the basis for any product or
+      service offered to third parties, whether commercially or otherwise;
+  (h) upload, mirror, fork (for redistribution), or otherwise copy the
+      Software to any external system, repository, service, or platform for
+      distribution or public access;
+  (i) remove, alter, obscure, or circumvent any copyright notice, license
+      notice, attribution, or other proprietary marking in the Software;
+  (j) reverse engineer, decompile, disassemble, or attempt to extract the
+      source code of any compiled component of the Software, except to the
+      extent expressly permitted by applicable law and only then upon prior
+      written notice to the copyright holder.
+
+--------------------------------------------------------------------------------
+2. COMMERCIAL USE
+--------------------------------------------------------------------------------
+
+Any commercial use of the Software — including but not limited to use in a
+commercial product, service, SaaS offering, internal enterprise tooling, or
+consulting engagement — requires a separate, written commercial license
+agreement executed by the copyright holder.
+
+To inquire about commercial licensing, contact the copyright holder directly.
+
+--------------------------------------------------------------------------------
+3. NO IMPLIED LICENSES
+--------------------------------------------------------------------------------
+
+Nothing in this License grants any right, license, or interest in any
+trademark, trade name, service mark, or logo of the copyright holder. No
+implied licenses are granted by this License.
+
+--------------------------------------------------------------------------------
+4. RESERVATION OF RIGHTS
+--------------------------------------------------------------------------------
+
+All rights not expressly granted in Section 1 are reserved by the copyright
+holder. Making this source code publicly viewable on GitHub does not waive any
+rights or create any open source or public domain dedication.
+
+--------------------------------------------------------------------------------
+5. TERMINATION
+--------------------------------------------------------------------------------
+
+This License and the limited view access granted hereunder terminate
+automatically and immediately upon any breach of its terms by you. Upon
+termination, you must destroy all copies of the Software in your possession
+or control. The copyright holder may also terminate this License at any time
+upon written notice.
+
+--------------------------------------------------------------------------------
+6. DISCLAIMER OF WARRANTIES
+--------------------------------------------------------------------------------
+
+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, TITLE, AND NON-INFRINGEMENT. THE COPYRIGHT
+HOLDER MAKES NO WARRANTY THAT THE SOFTWARE WILL MEET YOUR REQUIREMENTS, OPERATE
+WITHOUT INTERRUPTION, OR BE FREE OF ERRORS OR DEFECTS.
+
+--------------------------------------------------------------------------------
+7. LIMITATION OF LIABILITY
+--------------------------------------------------------------------------------
+
+TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, PUNITIVE, OR CONSEQUENTIAL DAMAGES (INCLUDING BUT NOT LIMITED TO
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
+BUSINESS INTERRUPTION; OR LOSS OF GOODWILL) HOWEVER CAUSED AND ON ANY THEORY
+OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE), ARISING OUT OF OR IN CONNECTION WITH THE SOFTWARE,
+EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+--------------------------------------------------------------------------------
+8. GOVERNING LAW
+--------------------------------------------------------------------------------
+
+This License shall be governed by and construed in accordance with the laws of
+the jurisdiction of the copyright holder's residence, without regard to conflict
+of law principles. Any disputes arising under or in connection with this License
+shall be subject to the exclusive jurisdiction of the courts of that
+jurisdiction.
+
+--------------------------------------------------------------------------------
+9. ENTIRE AGREEMENT
+--------------------------------------------------------------------------------
+
+This License constitutes the entire agreement between you and the copyright
+holder with respect to the subject matter hereof and supersedes all prior or
+contemporaneous understandings, agreements, representations, or warranties,
+whether written or oral, relating to such subject matter.
+
+If any provision of this License is held to be invalid or unenforceable, the
+remaining provisions shall continue in full force and effect.
+
+--------------------------------------------------------------------------------
+
+For permissions beyond the scope of this License, contact:
+  Hans Vilund — via GitHub at https://github.com/Hansuqwer
+
+THIS IS NOT LEGAL ADVICE. If you need legal guidance regarding this software,
+consult a qualified attorney.

agent_runtime_cockpit-0.1.0a0/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: agent-runtime-cockpit
+Version: 0.1.0a0
+Summary: ARC — Agent Runtime Cockpit: Python daemon, adapters, context retrieval
+Author: ARC Studio Contributors
+License: ARC Studio Proprietary License — see LICENSE
+Keywords: agent,ide,langgraph,runtime,swarmgraph,theia
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: aiofiles>=23.2
+Requires-Dist: aiohttp>=3.14.0
+Requires-Dist: idna>=3.15
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pygments>=2.17
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.7
+Requires-Dist: textual>=0.80
+Requires-Dist: tiktoken>=0.8
+Requires-Dist: typer>=0.12
+Provides-Extra: all
+Requires-Dist: anthropic>=0.30; extra == 'all'
+Requires-Dist: docker>=7.1; extra == 'all'
+Requires-Dist: httpx>=0.27; extra == 'all'
+Requires-Dist: langgraph>=0.2; extra == 'all'
+Requires-Dist: openai>=1.0; extra == 'all'
+Requires-Dist: tiktoken>=0.12; extra == 'all'
+Provides-Extra: arena
+Requires-Dist: anthropic>=0.30; extra == 'arena'
+Requires-Dist: openai>=1.0; extra == 'arena'
+Provides-Extra: context
+Requires-Dist: httpx>=0.27; extra == 'context'
+Provides-Extra: dev
+Requires-Dist: httpx>=0.27; extra == 'dev'
+Requires-Dist: hypothesis>=6.100; extra == 'dev'
+Requires-Dist: import-linter>=2.0; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pip-audit>=2.7; extra == 'dev'
+Requires-Dist: pyinstaller>=6.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-benchmark>=4.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest-textual-snapshot>=0.4; extra == 'dev'
+Requires-Dist: pytest>=8.2; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Provides-Extra: docker
+Requires-Dist: docker>=7.1; extra == 'docker'
+Provides-Extra: langgraph
+Requires-Dist: langgraph>=0.2; extra == 'langgraph'
+Provides-Extra: optimizer
+Requires-Dist: tiktoken>=0.12; extra == 'optimizer'
+Provides-Extra: swarmgraph
+Requires-Dist: swarmgraph-sdk; extra == 'swarmgraph'
+Provides-Extra: vz
+Requires-Dist: pyobjc-framework-virtualization>=10.0; (platform_system == 'Darwin') and extra == 'vz'
+Description-Content-Type: text/markdown
+
+# ARC — Agent Runtime Cockpit Python Package

agent_runtime_cockpit-0.1.0a0/README.md

@@ -0,0 +1 @@
+# ARC — Agent Runtime Cockpit Python Package

agent_runtime_cockpit-0.1.0a0/benchmarks/README.md

@@ -0,0 +1,202 @@
+# ARC Adapter Benchmarks
+
+Performance benchmarks for ARC runtime adapters. These benchmarks are **off-gate** (not required for CI to pass) and are used for performance monitoring and regression detection.
+
+## Overview
+
+The benchmark suite covers:
+
+- **Adapter Detection**: Performance of runtime detection across different workspace sizes
+- **Workflow Operations**: Export and inspection performance
+- **Registry Operations**: Multi-adapter coordination and lookup performance
+- **Initialization**: Adapter and registry initialization overhead
+
+## Running Benchmarks
+
+### Prerequisites
+
+Install benchmark dependencies:
+
+```bash
+cd python
+uv pip install -e ".[dev]"
+```
+
+### Basic Usage
+
+Run all benchmarks:
+
+```bash
+pytest benchmarks/ --benchmark-only
+```
+
+Run specific benchmark file:
+
+```bash
+pytest benchmarks/test_adapter_detection.py --benchmark-only
+```
+
+Run specific benchmark group:
+
+```bash
+pytest benchmarks/ --benchmark-only -k "detection-swarmgraph"
+```
+
+### Saving Baselines
+
+Save a baseline for comparison:
+
+```bash
+pytest benchmarks/ --benchmark-only --benchmark-save=baseline
+```
+
+Compare against baseline:
+
+```bash
+pytest benchmarks/ --benchmark-only --benchmark-compare=baseline
+```
+
+### Advanced Options
+
+Generate histogram:
+
+```bash
+pytest benchmarks/ --benchmark-only --benchmark-histogram
+```
+
+Adjust number of rounds:
+
+```bash
+pytest benchmarks/ --benchmark-only --benchmark-min-rounds=10
+```
+
+Disable GC during benchmarks:
+
+```bash
+pytest benchmarks/ --benchmark-only --benchmark-disable-gc
+```
+
+## Benchmark Groups
+
+### Detection Benchmarks
+
+- `detection-swarmgraph`: SwarmGraph detection performance
+- `detection-langgraph`: LangGraph detection performance
+- `detection-crewai`: CrewAI detection performance
+- `detection-openai`: OpenAI Agents detection performance
+
+### Workflow Benchmarks
+
+- `inspect-workspace`: Workspace inspection performance
+- `export-workflow`: Workflow export performance
+- `export-schemas`: Schema export performance
+- `combined-operations`: Full inspection pipeline
+
+### Registry Benchmarks
+
+- `registry-init`: Registry initialization
+- `registry-lookup`: Adapter lookup operations
+- `multi-detection`: Multi-adapter detection
+- `registry-capabilities`: Capability queries
+- `registry-registration`: Adapter registration/unregistration
+- `concurrent-simulation`: Concurrent detection simulation
+- `registry-filtering`: Adapter filtering operations
+
+### Initialization Benchmarks
+
+- `initialization`: Adapter initialization overhead
+- `capabilities`: Capability query performance
+
+## Performance Targets
+
+These are aspirational targets, not hard requirements:
+
+| Operation | Target | Notes |
+|-----------|--------|-------|
+| Adapter detection (empty workspace) | < 10ms | Should be fast for negative cases |
+| Adapter detection (small workspace) | < 50ms | 10-100 files |
+| Adapter detection (medium workspace) | < 200ms | 100-1000 files |
+| Adapter detection (large workspace) | < 1s | 1000+ files |
+| Capability report | < 20ms | Includes detection |
+| Registry initialization (4 adapters) | < 50ms | One-time cost |
+| Adapter lookup | < 1ms | Should be O(1) |
+| Multi-adapter detection (4 adapters) | < 100ms | Empty workspace |
+
+## Interpreting Results
+
+### Statistics
+
+- **Min**: Fastest execution time (best case)
+- **Max**: Slowest execution time (worst case)
+- **Mean**: Average execution time
+- **StdDev**: Standard deviation (consistency indicator)
+- **Median**: Middle value (50th percentile)
+- **IQR**: Interquartile range (middle 50% spread)
+- **Outliers**: Runs significantly slower/faster than typical
+
+### What to Watch For
+
+- **Regressions**: Mean time increases significantly between runs
+- **High StdDev**: Inconsistent performance (may indicate caching issues)
+- **Outliers**: May indicate GC pauses or system interference
+- **Scaling**: Performance should scale sub-linearly with workspace size
+
+## CI Integration
+
+Benchmarks are marked as **off-gate** using pytest markers. They:
+
+- Do NOT block PR merges
+- Run on a schedule (nightly/weekly)
+- Generate performance reports for monitoring
+- Alert on significant regressions (>20% slowdown)
+
+To run benchmarks in CI:
+
+```bash
+pytest benchmarks/ --benchmark-only --benchmark-json=benchmark-results.json
+```
+
+## Adding New Benchmarks
+
+1. Create a new test file in `benchmarks/`
+2. Use `@pytest.mark.benchmark(group="group-name")` decorator
+3. Use `benchmark` fixture to wrap the operation
+4. Add assertions to verify correctness
+5. Document the benchmark in this README
+
+Example:
+
+```python
+@pytest.mark.benchmark(group="my-operation")
+def test_my_operation(benchmark):
+    """Benchmark my operation."""
+    adapter = MyAdapter()
+    result = benchmark(adapter.my_operation, arg1, arg2)
+    assert result is not None
+```
+
+## Troubleshooting
+
+### Benchmarks are slow
+
+- Reduce workspace sizes in fixtures
+- Use `--benchmark-min-rounds=1` for quick checks
+- Run specific groups instead of all benchmarks
+
+### High variance in results
+
+- Close other applications
+- Disable CPU frequency scaling
+- Use `--benchmark-disable-gc`
+- Increase `--benchmark-min-rounds`
+
+### Import errors
+
+- Ensure dev dependencies are installed: `uv pip install -e ".[dev]"`
+- Check that adapters are importable: `python -c "from agent_runtime_cockpit.adapters import SwarmGraphAdapter"`
+
+## References
+
+- [pytest-benchmark documentation](https://pytest-benchmark.readthedocs.io/)
+- [ARC Adapter Base Class](../src/agent_runtime_cockpit/adapters/base.py)
+- [ARC Adapter Registry](../src/agent_runtime_cockpit/adapters/registry.py)

agent_runtime_cockpit-0.1.0a0/benchmarks/__init__.py

@@ -0,0 +1,8 @@
+"""
+ARC Adapter Benchmarks
+
+Performance benchmarks for runtime adapters.
+These are marked as off-gate (not required for CI to pass).
+
+Run with: pytest benchmarks/ --benchmark-only
+"""

agent_runtime_cockpit-0.1.0a0/benchmarks/pytest.ini

@@ -0,0 +1,13 @@
+# pytest configuration for benchmarks
+[tool:pytest]
+# Benchmark-specific settings
+benchmark_min_rounds = 5
+benchmark_warmup = true
+benchmark_disable_gc = false
+benchmark_sort = "mean"
+benchmark_columns = "min, max, mean, stddev, median, iqr, outliers, rounds, iterations"
+benchmark_group_by = "group"
+
+# Off-gate marker - benchmarks don't block CI
+markers =
+    benchmark: Performance benchmarks (off-gate)