agent-shell-py 0.5.0__tar.gz → 0.5.1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- agent_shell_py-0.5.1/.github/dependabot.yml +44 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/.github/workflows/build.yml +3 -3
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/.github/workflows/ci.yml +2 -2
- agent_shell_py-0.5.1/.github/workflows/nix-cache.yml +91 -0
- agent_shell_py-0.5.1/.github/workflows/nix-check.yml +36 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/.github/workflows/publish.yml +2 -2
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/.gitignore +7 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/AGENTS.md +39 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/PKG-INFO +6 -1
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/README.md +5 -0
- agent_shell_py-0.5.1/default.nix +11 -0
- agent_shell_py-0.5.1/docs/nix.md +124 -0
- agent_shell_py-0.5.1/flake.lock +161 -0
- agent_shell_py-0.5.1/flake.nix +376 -0
- agent_shell_py-0.5.1/shell.nix +2 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/_version.py +2 -2
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_execution_host.py +1 -1
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_herdr_execution_host.py +10 -10
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_interactive_agents.py +1 -1
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_interactive_terminal.py +5 -3
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_process_lifecycle.py +1 -1
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_session_resources.py +2 -1
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_terminal_window_execution_host.py +3 -3
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_tmux_execution_host.py +3 -3
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/uv.lock +4 -4
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/.python-version +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/LICENSE +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/docs/architecture/class_diagram.md +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/docs/architecture/dependency_boundaries.md +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/docs/assets/agentshell-banner.png +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/docs/assets/agentshell-banner.svg +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/docs/development/agent_parameter_comparison.md +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/docs/development/disabled_tools.md +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/docs/development/import_linter_audit.md +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/docs/development/info.md +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/docs/development/issue_25_plan.md +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/docs/development/package_management.md +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/docs/development/total_token_count.md +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/docs/examples.md +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/examples/interactive_demo.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/pyproject.toml +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/skills/delegating-code-review/SKILL.md +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/skills/invoking-cli-agents/SKILL.md +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/skills/invoking-cli-agents/api-reference.md +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/__init__.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/__init__.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/agent_adapter_protocol.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/claude_code_adapter.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/codex_adapter.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/copilot_cli_adapter.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/cursor_adapter.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/grok_adapter.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/health.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/model_discovery.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/opencode_adapter.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/outcome.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/pi_adapter.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/pi_resources.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/process_failure.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/response.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/stderr_format.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/adapters/tool_denial.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/execution.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/herdr.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/herdr_protocol.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/herdr_worker.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/interactive.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/interactive_event_writer.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/interactive_terminal.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/interactive_worker.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/models/__init__.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/models/agent.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/models/resources.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/ports/__init__.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/ports/agent.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/ports/execution.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/ports/interactive.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/ports/resources.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/process_cleanup.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/process_guardian.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/resources.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/shell.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/terminal_protocol.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/terminal_window.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/terminal_worker.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/tmux.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/tmux_bridge.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/tmux_ownership.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/src/agent_shell/tmux_protocol.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/__init__.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/conftest.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/__init__.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_claude_code_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_codex_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_copilot_cli_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_cursor_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_execution_host_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_grok_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_health_check_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_interactive_attachment_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_interactive_harness_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_model_discovery_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_opencode_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_pi_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_pi_packages_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_session_resources_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_terminal_window_execution_host_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/e2e/test_tmux_execution_host_e2e.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/__init__.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_architecture.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_claude_code_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_claude_code_mcp_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_codex_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_codex_mcp_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_copilot_cli_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_copilot_cli_mcp_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_cursor_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_cursor_mcp_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_grok_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_grok_mcp_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_health_check_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_interactive_attachment.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_model_discovery_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_opencode_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_opencode_mcp_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_packages_unsupported.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_pi_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_pi_mcp_integration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/integration/test_pi_packages.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/__init__.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/adapter_matrix.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/codex_fixtures.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/copilot_fixtures.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/cursor_fixtures.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/fixtures.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/grok_fixtures.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/opencode_fixtures.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/pi_fixtures.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_adapter_transport.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_cancel.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_codex_cancel.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_codex_execute.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_codex_parse_event.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_codex_warnings.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_copilot_cli_cancel.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_copilot_cli_execute.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_copilot_cli_parse_event.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_copilot_cli_stream.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_cursor_cancel.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_cursor_execute.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_cursor_parse_event.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_cursor_warnings.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_execute.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_execute_outcome.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_grok_cancel.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_grok_execute.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_grok_parse_event.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_grok_warnings.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_health_probe.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_interactive_attachment.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_mcp_server_spec.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_model_discovery.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_models.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_opencode_cancel.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_opencode_execute.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_opencode_parse_event.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_opencode_spawn.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_opencode_stream.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_package_spec.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_parse_event.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_pi_cancel.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_pi_execute.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_pi_parse_event.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_pi_warnings.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_port_exports.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_process_cleanup.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_process_group_registration.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_public_exports.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_response_aggregation.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_shell.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_shell_cancellation.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_shell_mcp.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_stderr_format.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_stream.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_terminal_window_execution_host.py +0 -0
- {agent_shell_py-0.5.0 → agent_shell_py-0.5.1}/tests/unit/test_tool_denial.py +0 -0
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# Dependabot version updates for the flake inputs and pinned Actions.
|
|
2
|
+
#
|
|
3
|
+
# Python dependencies are deliberately NOT listed for scheduled version
|
|
4
|
+
# updates. The package has zero runtime requirements; Nix consumes the locked
|
|
5
|
+
# dev group from uv.lock, so routine bumps churn that closure without changing
|
|
6
|
+
# the library's runtime. Dependabot security updates require the repository's
|
|
7
|
+
# dependency graph and Dependabot alerts to be enabled, and target known
|
|
8
|
+
# advisories.
|
|
9
|
+
#
|
|
10
|
+
# Two limits of the `nix` ecosystem, so a future reader does not rediscover
|
|
11
|
+
# them: it updates flake.lock only and never a ref pinned in flake.nix, and it
|
|
12
|
+
# does not run on private repositories.
|
|
13
|
+
#
|
|
14
|
+
# For github-actions updates, Dependabot rewrites a trailing version comment
|
|
15
|
+
# when it recognizes the existing version and the new SHA maps to a recognized
|
|
16
|
+
# version tag. Otherwise it may leave the old annotation unchanged.
|
|
17
|
+
#
|
|
18
|
+
# Docs: https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
|
|
19
|
+
version: 2
|
|
20
|
+
updates:
|
|
21
|
+
# nix flake inputs: flake.nix and flake.lock
|
|
22
|
+
- package-ecosystem: "nix"
|
|
23
|
+
directory: "/"
|
|
24
|
+
schedule:
|
|
25
|
+
interval: "weekly"
|
|
26
|
+
# Group all input bumps into one PR per week so a routine refresh costs one
|
|
27
|
+
# review rather than one per input. The pyproject-nix trio is follows-linked,
|
|
28
|
+
# so bumping them together is also the only way to test a compatible set.
|
|
29
|
+
groups:
|
|
30
|
+
flake-inputs:
|
|
31
|
+
patterns:
|
|
32
|
+
- "*"
|
|
33
|
+
open-pull-requests-limit: 5
|
|
34
|
+
commit-message:
|
|
35
|
+
prefix: "chore(deps)"
|
|
36
|
+
|
|
37
|
+
# GitHub Actions, including the SHA-pinned actions in the publishing jobs.
|
|
38
|
+
- package-ecosystem: "github-actions"
|
|
39
|
+
directory: "/.github/workflows"
|
|
40
|
+
schedule:
|
|
41
|
+
interval: "weekly"
|
|
42
|
+
open-pull-requests-limit: 5
|
|
43
|
+
commit-message:
|
|
44
|
+
prefix: "chore(deps)"
|
|
@@ -16,13 +16,13 @@ jobs:
|
|
|
16
16
|
runs-on: ubuntu-latest
|
|
17
17
|
|
|
18
18
|
steps:
|
|
19
|
-
- uses: actions/checkout@
|
|
19
|
+
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
|
20
20
|
with:
|
|
21
21
|
fetch-depth: 0
|
|
22
22
|
persist-credentials: false
|
|
23
23
|
|
|
24
24
|
- name: Install uv
|
|
25
|
-
uses: astral-sh/setup-uv@
|
|
25
|
+
uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
|
|
26
26
|
|
|
27
27
|
- name: Set up Python 3.12
|
|
28
28
|
run: uv python install 3.12
|
|
@@ -40,7 +40,7 @@ jobs:
|
|
|
40
40
|
run: uv build
|
|
41
41
|
|
|
42
42
|
- name: Upload build artifacts
|
|
43
|
-
uses: actions/upload-artifact@
|
|
43
|
+
uses: actions/upload-artifact@v7
|
|
44
44
|
with:
|
|
45
45
|
name: dist
|
|
46
46
|
path: dist/
|
|
@@ -22,12 +22,12 @@ jobs:
|
|
|
22
22
|
python-version: ["3.12"]
|
|
23
23
|
|
|
24
24
|
steps:
|
|
25
|
-
- uses: actions/checkout@
|
|
25
|
+
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
|
26
26
|
with:
|
|
27
27
|
persist-credentials: false
|
|
28
28
|
|
|
29
29
|
- name: Install uv
|
|
30
|
-
uses: astral-sh/setup-uv@
|
|
30
|
+
uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
|
|
31
31
|
|
|
32
32
|
- name: Set up Python ${{ matrix.python-version }}
|
|
33
33
|
run: uv python install ${{ matrix.python-version }}
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
name: Nix Cache
|
|
2
|
+
|
|
3
|
+
# Publishes the Nix-built package and the `nix flake check` closures to Cachix so
|
|
4
|
+
# contributor dev shells and later CI jobs substitute instead of rebuilding the
|
|
5
|
+
# uv2nix Python environment.
|
|
6
|
+
#
|
|
7
|
+
# Pull requests never publish here: forks have no token, and unmerged artifacts
|
|
8
|
+
# should not land in a shared cache.
|
|
9
|
+
on:
|
|
10
|
+
push:
|
|
11
|
+
branches:
|
|
12
|
+
- main
|
|
13
|
+
workflow_dispatch: null
|
|
14
|
+
|
|
15
|
+
permissions: {}
|
|
16
|
+
|
|
17
|
+
concurrency:
|
|
18
|
+
group: nix-cache
|
|
19
|
+
cancel-in-progress: false
|
|
20
|
+
|
|
21
|
+
jobs:
|
|
22
|
+
publish:
|
|
23
|
+
# Forks never have the token and must not publish; a manual dispatch only
|
|
24
|
+
# publishes when it runs on the default branch of the upstream repository.
|
|
25
|
+
if: >-
|
|
26
|
+
github.repository == 'ScottRBK/agent-shell' &&
|
|
27
|
+
(github.event_name == 'push' || github.ref == 'refs/heads/main')
|
|
28
|
+
runs-on: ubuntu-latest
|
|
29
|
+
# Cold cache builds the uv2nix closure plus the check environments.
|
|
30
|
+
timeout-minutes: 60
|
|
31
|
+
permissions:
|
|
32
|
+
contents: read
|
|
33
|
+
steps:
|
|
34
|
+
# This job receives the CACHIX_AUTH_TOKEN write secret, so the actions it
|
|
35
|
+
# runs are pinned by commit SHA rather than by mutable tag.
|
|
36
|
+
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
|
|
37
|
+
with:
|
|
38
|
+
persist-credentials: false
|
|
39
|
+
|
|
40
|
+
# v31.11.3: the bundled installer certificate bundle was updated to drop
|
|
41
|
+
# compromised certificates. Pinned by SHA for the same reason as above.
|
|
42
|
+
- name: Install Nix
|
|
43
|
+
uses: cachix/install-nix-action@3dc140bfc76c49fbd4dd958429132e3746bcb086 # v31.11.5
|
|
44
|
+
with:
|
|
45
|
+
extra_nix_config: |
|
|
46
|
+
experimental-features = nix-command flakes
|
|
47
|
+
|
|
48
|
+
# Fail loudly instead of silently "publishing" nothing: cachix-action
|
|
49
|
+
# falls back to a read-only pull when the token is absent.
|
|
50
|
+
- name: Check CACHIX_AUTH_TOKEN
|
|
51
|
+
env:
|
|
52
|
+
CACHIX_AUTH_TOKEN: ${{ secrets.CACHIX_AUTH_TOKEN }}
|
|
53
|
+
run: |
|
|
54
|
+
if [ -z "$CACHIX_AUTH_TOKEN" ]; then
|
|
55
|
+
echo "::error::repository secret CACHIX_AUTH_TOKEN is not set"
|
|
56
|
+
exit 1
|
|
57
|
+
fi
|
|
58
|
+
|
|
59
|
+
# cachix-action otherwise uses a cachix already on PATH or installs one
|
|
60
|
+
# from the mutable https://cachix.org/api/v1/install endpoint. Pinning the
|
|
61
|
+
# action alone leaves that executable unpinned while it holds the write
|
|
62
|
+
# token, so resolve one from the nixpkgs revision this flake locks: it is
|
|
63
|
+
# content-addressed, reviewable in flake.lock, and substituted rather than
|
|
64
|
+
# downloaded from an endpoint that can change under us.
|
|
65
|
+
- name: Resolve pinned cachix
|
|
66
|
+
id: cachix
|
|
67
|
+
run: |
|
|
68
|
+
set -euo pipefail
|
|
69
|
+
rev=$(nix eval --raw --impure \
|
|
70
|
+
--expr '(builtins.fromJSON (builtins.readFile ./flake.lock)).nodes.nixpkgs.locked.rev')
|
|
71
|
+
out=$(nix build --no-link --print-out-paths "github:NixOS/nixpkgs/${rev}#cachix")
|
|
72
|
+
echo "cachix from nixpkgs ${rev}: ${out}"
|
|
73
|
+
echo "bin=${out}/bin/cachix" >> "$GITHUB_OUTPUT"
|
|
74
|
+
|
|
75
|
+
# Installs a post-build hook, so every store path built below is pushed
|
|
76
|
+
# as it is produced.
|
|
77
|
+
- name: Publish to Cachix
|
|
78
|
+
uses: cachix/cachix-action@38b082610b782e7e93e209c35fd730d399dee866 # v17
|
|
79
|
+
with:
|
|
80
|
+
name: agent-shell
|
|
81
|
+
authToken: ${{ secrets.CACHIX_AUTH_TOKEN }}
|
|
82
|
+
cachixBin: ${{ steps.cachix.outputs.bin }}
|
|
83
|
+
|
|
84
|
+
- name: Build and publish the package
|
|
85
|
+
run: nix build .#agent-shell-py
|
|
86
|
+
|
|
87
|
+
# The check closures are the valuable half of the cache: they carry the
|
|
88
|
+
# uv2nix-built environment and pinned tool set that every later
|
|
89
|
+
# `nix flake check` would otherwise rebuild from scratch.
|
|
90
|
+
- name: Build and publish the check environments
|
|
91
|
+
run: nix flake check
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
name: Nix check
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
branches: [main]
|
|
6
|
+
pull_request:
|
|
7
|
+
branches: [main]
|
|
8
|
+
|
|
9
|
+
permissions:
|
|
10
|
+
contents: read
|
|
11
|
+
|
|
12
|
+
concurrency:
|
|
13
|
+
group: ${{ github.workflow }}-${{ github.ref }}
|
|
14
|
+
cancel-in-progress: true
|
|
15
|
+
|
|
16
|
+
jobs:
|
|
17
|
+
flake-check:
|
|
18
|
+
runs-on: ubuntu-latest
|
|
19
|
+
# The publisher allows 60 minutes for a cold Nix closure build; use the same
|
|
20
|
+
# budget here so a lock refresh does not turn a slow check into a false fail.
|
|
21
|
+
timeout-minutes: 60
|
|
22
|
+
steps:
|
|
23
|
+
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
|
24
|
+
with:
|
|
25
|
+
persist-credentials: false
|
|
26
|
+
|
|
27
|
+
# No project Cachix substituter is configured in this workflow, so its
|
|
28
|
+
# project-specific check outputs, including tests, must be built here.
|
|
29
|
+
- name: Install Nix
|
|
30
|
+
uses: cachix/install-nix-action@75c75c31ebece974e48ebc36b4ad125bd97bd97b1 # v31.11.3
|
|
31
|
+
with:
|
|
32
|
+
extra_nix_config: |
|
|
33
|
+
experimental-features = nix-command flakes
|
|
34
|
+
|
|
35
|
+
- name: Run flake checks
|
|
36
|
+
run: nix flake check
|
|
@@ -12,12 +12,12 @@ jobs:
|
|
|
12
12
|
id-token: write # Required for trusted publishing
|
|
13
13
|
|
|
14
14
|
steps:
|
|
15
|
-
- uses: actions/checkout@
|
|
15
|
+
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
|
16
16
|
with:
|
|
17
17
|
fetch-depth: 0
|
|
18
18
|
|
|
19
19
|
- name: Install uv
|
|
20
|
-
uses: astral-sh/setup-uv@
|
|
20
|
+
uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
|
|
21
21
|
|
|
22
22
|
- name: Build package
|
|
23
23
|
run: uv build
|
|
@@ -109,6 +109,45 @@ uv run --locked pytest tests/unit tests/integration -v
|
|
|
109
109
|
uv run pytest -v
|
|
110
110
|
```
|
|
111
111
|
|
|
112
|
+
## Nix
|
|
113
|
+
|
|
114
|
+
The repository ships a flake (flake-parts + uv2nix) that builds the locked `uv.lock`
|
|
115
|
+
environment reproducibly. The `uv` workflow above remains the primary dev loop; Nix adds
|
|
116
|
+
reproducibility and checks, it does not replace `uv`.
|
|
117
|
+
|
|
118
|
+
```bash
|
|
119
|
+
nix develop # locked python 3.12 + pytest + uv + ruff, hooks auto-installed
|
|
120
|
+
nix build .#agent-shell-py # the library, installed into a python3.12 site-packages
|
|
121
|
+
nix flake check # pre-commit hooks + zero-runtime-deps + built-import + unit & integration tests (with import contracts)
|
|
122
|
+
nix fmt # format gate (default stage only: nixfmt, deadnix, statix)
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
Rules that are easy to get wrong:
|
|
126
|
+
|
|
127
|
+
- **Inside `nix develop`, `uv` is for lockfile operations only** (`uv add`, `uv lock`).
|
|
128
|
+
`UV_NO_SYNC=1` stops uv syncing packages *into* a venv; it does not stop uv creating one. `uv run`
|
|
129
|
+
also resolves its own interpreter rather than the shell's, so it can build a stray,
|
|
130
|
+
dependency-free `.venv` around a different Python. Run `pytest` directly in the shell.
|
|
131
|
+
- **`tests/e2e` never runs in a Nix build or check.** It calls real agent CLIs and incurs API
|
|
132
|
+
cost. Checks scope to `tests/unit` + `tests/integration` and pass `-m "not e2e"`; the sandbox
|
|
133
|
+
has no network, so a test that needs one fails closed.
|
|
134
|
+
- **`ruff` and `typos` are wired at the `manual` stage**, so a green `nix flake check` does not
|
|
135
|
+
mean they ran. The repo has no lint config yet; run them deliberately with
|
|
136
|
+
`pre-commit run ruff --hook-stage manual --all-files` and do not promote them to a default
|
|
137
|
+
stage without deciding the lint configuration with the maintainer.
|
|
138
|
+
- **No FHS paths in tests, with two recorded exceptions.** There is no `/usr/bin/env` or
|
|
139
|
+
`/bin/true` inside the Nix sandbox, and `/bin/true` is absent on NixOS outright — use
|
|
140
|
+
`sys.executable` for generated shebangs and `shutil.which` for binaries. Generated fake binaries
|
|
141
|
+
written into `tmp_path` as payload and put on `PATH` may use `#!/bin/sh`, which does exist in the
|
|
142
|
+
sandbox and on NixOS. The two `#!/usr/bin/env node` shebangs in `test_interactive_agents.py` are
|
|
143
|
+
guarded by a `shutil.which("node")` skip, so they pass by skipping rather than by portability.
|
|
144
|
+
- **Version stamping**: pure builds report `0.0.0+dev` because the flake source carries no `.git`.
|
|
145
|
+
Releases stamp the tag with `AGENT_SHELL_VERSION=$(git describe --tags --abbrev=0)` — the
|
|
146
|
+
`--abbrev=0` is required, raw `git describe` output is not a valid PEP 440 version.
|
|
147
|
+
- **Do not add version literals to `flake.nix`.**
|
|
148
|
+
|
|
149
|
+
See [docs/nix.md](docs/nix.md) for the full guide and the practice-matrix decisions.
|
|
150
|
+
|
|
112
151
|
## CI/CD
|
|
113
152
|
|
|
114
153
|
- **CI**: Runs architecture contracts and unit + integration tests on every push and PR
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: agent-shell-py
|
|
3
|
-
Version: 0.5.
|
|
3
|
+
Version: 0.5.1
|
|
4
4
|
Summary: A lightweight abstraction for executing CLI coding agents headlessly
|
|
5
5
|
License-Expression: MIT
|
|
6
6
|
License-File: LICENSE
|
|
@@ -118,3 +118,8 @@ follow_up = await shell.execute(
|
|
|
118
118
|
|
|
119
119
|
See [more examples](docs/examples.md) for isolation and execution hosts, failure handling,
|
|
120
120
|
streaming, model discovery, health checks, tool restrictions, MCP servers, packages, and logging.
|
|
121
|
+
|
|
122
|
+
## Guides
|
|
123
|
+
|
|
124
|
+
- [Nix](docs/nix.md) — reproducible dev shell, build and checks from `uv.lock`, plus
|
|
125
|
+
`nix-build` / `nix-shell` entry points for Nix without flakes enabled.
|
|
@@ -109,3 +109,8 @@ follow_up = await shell.execute(
|
|
|
109
109
|
|
|
110
110
|
See [more examples](docs/examples.md) for isolation and execution hosts, failure handling,
|
|
111
111
|
streaming, model discovery, health checks, tool restrictions, MCP servers, packages, and logging.
|
|
112
|
+
|
|
113
|
+
## Guides
|
|
114
|
+
|
|
115
|
+
- [Nix](docs/nix.md) — reproducible dev shell, build and checks from `uv.lock`, plus
|
|
116
|
+
`nix-build` / `nix-shell` entry points for Nix without flakes enabled.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# nix-build entry point (flake-compat); the flake is the source of truth.
|
|
2
|
+
(import (
|
|
3
|
+
let
|
|
4
|
+
lock = builtins.fromJSON (builtins.readFile ./flake.lock);
|
|
5
|
+
node = lock.nodes.${lock.nodes.root.inputs.flake-compat}.locked;
|
|
6
|
+
in
|
|
7
|
+
fetchTarball {
|
|
8
|
+
url = "https://github.com/${node.owner}/${node.repo}/archive/${node.rev}.tar.gz";
|
|
9
|
+
sha256 = node.narHash;
|
|
10
|
+
}
|
|
11
|
+
) { src = ./.; }).defaultNix
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
# Nix
|
|
2
|
+
|
|
3
|
+
This repository is built with Nix (flake-parts + uv2nix). The Python
|
|
4
|
+
development loop (`uv`) keeps working unchanged; Nix adds a reproducible
|
|
5
|
+
package, a locked dev shell, and checks.
|
|
6
|
+
|
|
7
|
+
## Prerequisites
|
|
8
|
+
|
|
9
|
+
Nix with flakes enabled. Optionally `nix-direnv` / `direnv` for an
|
|
10
|
+
auto-activated shell (`.envrc` is not committed).
|
|
11
|
+
|
|
12
|
+
## Development
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
nix develop # locked env from uv.lock: python 3.12, pytest, uv, ruff
|
|
16
|
+
pytest tests/unit tests/integration
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
The dev shell owns the environment; `uv` is present for lockfile
|
|
20
|
+
operations only (`uv add`, `uv lock`). `UV_NO_SYNC=1` stops `uv` from
|
|
21
|
+
syncing packages into a venv, but does not prevent venv creation. `uv run`
|
|
22
|
+
resolves its own interpreter and can create a dependency-free `.venv` with a
|
|
23
|
+
different Python; run `pytest` directly in the Nix shell.
|
|
24
|
+
|
|
25
|
+
`tests/e2e` is deliberately excluded from Nix builds and checks: those
|
|
26
|
+
tests invoke real agent CLIs and incur API costs. Run them locally with
|
|
27
|
+
`uv run pytest -m e2e` as before.
|
|
28
|
+
|
|
29
|
+
## Build
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
nix build .#agent-shell-py # the library, installed into a python3.12 site-packages
|
|
33
|
+
nix build .#env # a python interpreter with the library already inside it
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
`#env` is what to install when something must actually run python against the
|
|
37
|
+
library. `python3.withPackages` will not pick up `#agent-shell-py`: uv2nix
|
|
38
|
+
packages carry no `pythonModule` marker, so an environment built that way
|
|
39
|
+
imports nothing. Use `#env`, or put `#agent-shell-py` on `PYTHONPATH` when you
|
|
40
|
+
are composing your own environment.
|
|
41
|
+
|
|
42
|
+
## Versioning
|
|
43
|
+
|
|
44
|
+
Pure builds always report `0.0.0+dev` and never fail on missing git
|
|
45
|
+
metadata. Release builds stamp the real tag (run on a clean checkout of
|
|
46
|
+
the tag):
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
AGENT_SHELL_VERSION=$(git describe --tags --abbrev=0) nix build --impure
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
`--abbrev=0` matters: raw `git describe --tags` output
|
|
53
|
+
(`v0.4.0-3-g42dd27b`) is not PEP 440 and hatch-vcs rejects it; the bare
|
|
54
|
+
tag normalizes cleanly (`v0.4.0` -> `0.4.0`).
|
|
55
|
+
|
|
56
|
+
## Checks
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
nix flake check
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
- `pre-commit` — provided by git-hooks.nix; runs the default-stage hooks
|
|
63
|
+
(`nixfmt`, `deadnix`, `statix`).
|
|
64
|
+
- `zero-runtime-deps` — asserts the installed distribution declares no
|
|
65
|
+
`Requires-Dist` entries and imports cleanly. The package is stdlib-only
|
|
66
|
+
by contract.
|
|
67
|
+
- `built-import` — imports the packaged module tree with no source directory on
|
|
68
|
+
`sys.path`, and checks that every module in `src/` also exists in the build. The
|
|
69
|
+
suite below runs against the sources, so this is what catches a module the build
|
|
70
|
+
omits or a package that does not import as installed.
|
|
71
|
+
- `tests` — the unit and integration suites in the Nix sandbox: no network,
|
|
72
|
+
no credentials, no `e2e` marker. `tests/e2e` is excluded by design because
|
|
73
|
+
those tests invoke real agent CLIs and incur API cost. Run them locally with
|
|
74
|
+
`uv run pytest -m e2e` as before. Tests of real PID-namespace behavior may
|
|
75
|
+
also skip when the check environment cannot create the namespace.
|
|
76
|
+
|
|
77
|
+
The Python and spell hooks (`ruff`, `typos`) are wired but pinned to the
|
|
78
|
+
`manual` stage, because the repository has no lint configuration yet and a
|
|
79
|
+
default-stage hook would fail `nix flake check` on a clean checkout. Run them
|
|
80
|
+
on demand:
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
pre-commit run ruff --hook-stage manual --all-files
|
|
84
|
+
pre-commit run typos --hook-stage manual --all-files
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## Non-flake usage
|
|
88
|
+
|
|
89
|
+
`default.nix` and `shell.nix` are provided via
|
|
90
|
+
[flake-compat](https://github.com/NixOS/flake-compat), so the project also
|
|
91
|
+
works under stable Nix without the `nix-command` and `flakes`
|
|
92
|
+
experimental-features, and under tooling with no native flake support:
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
nix-build . # builds the package (same store path as `nix build .#agent-shell-py`)
|
|
96
|
+
nix-shell . # enters the dev shell above
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
## Practice decisions
|
|
100
|
+
|
|
101
|
+
Each row below is a decision with the reason beside it, so this table is the
|
|
102
|
+
whole record - there is nothing else to consult. The rule applied throughout is
|
|
103
|
+
that a non-obvious choice needs a one-line justification, and so does a
|
|
104
|
+
departure from what the surrounding project already does.
|
|
105
|
+
|
|
106
|
+
| Decision | Choice | Why |
|
|
107
|
+
|------|--------|-----|
|
|
108
|
+
| Channel | `nixos-unstable` | zero runtime deps; instability ages only the build-time toolchain, never a consumer's runtime |
|
|
109
|
+
| Release | tags | existing `v*` tag history; consumers pin tags |
|
|
110
|
+
| Follows | `git-hooks.nix`, `flake-parts -> nixpkgs-lib`, pyproject-nix trio -> shared `nixpkgs` | single nixpkgs in the closure; shared tooling substitutes |
|
|
111
|
+
| Hooks | git-hooks.nix: `nixfmt`, `deadnix`, `statix` at the default stage; `ruff` and `typos` wired but `manual` | the repo has no lint config yet, so auto-running Python linters would fail a clean-checkout `nix flake check` and impose enforcement upstream never opted into; the Nix hooks are safe because they have no project configuration to get wrong |
|
|
112
|
+
| Version identity | `scm-stamp` — `SETUPTOOLS_SCM_PRETEND_VERSION` from `AGENT_SHELL_VERSION`, default `0.0.0+dev` | the flake source carries no `.git`; pure builds must not fail. Release recipe needs `git describe --tags --abbrev=0` — raw describe output is not PEP 440 |
|
|
113
|
+
| Test tiers | unit + integration as a sandboxed check; `e2e` never in a check | e2e needs real CLIs, credentials and API spend; the sandbox has no network, so anything needing it fails closed |
|
|
114
|
+
| Architectures | `x86_64-linux`, `aarch64-linux`, `aarch64-darwin` | `x86_64-darwin` omitted as deprecated upstream. No aarch64 builder exists today, so `nix flake check` reports those two as omitted systems — listing them is intent, not verification |
|
|
115
|
+
| Non-flake entry point | `flake-compat` (`default.nix` + `shell.nix`) | costs a flake-native user nothing, and the entry points delegate rather than duplicate |
|
|
116
|
+
| Source filtering | allow-list `lib.fileset.toSource` (`pyproject.toml`, `README.md`, `LICENSE`, `src/`) | tree is ours; docs-only commits leave the package drv hash stable |
|
|
117
|
+
| Binary cache | public Cachix cache `agent-shell` | `.github/workflows/nix-cache.yml` installs a post-build hook, so `nix build .#agent-shell-py` and the `nix flake check` closures are pushed as they are produced. Publication runs on `main` only — a `push`, or a manual dispatch whose ref is `main` — and never on a PR: forks hold no token, and unmerged artifacts should not reach a shared cache. A missing `CACHIX_AUTH_TOKEN` fails the job rather than silently publishing nothing, and the `cachix` binary is taken from the locked nixpkgs revision so the write token never runs an unpinned download |
|
|
118
|
+
| Binary cache consumption | advertised by the flake, applied only on consent | `nixConfig` carries the cache as `extra-substituters` and `extra-trusted-public-keys`, so a consumer's own substituters and keys survive rather than being replaced. Nix still treats flake configuration as opt-in (`accept-flake-config`, or answering the prompt), so nobody inherits the cache silently and `cachix use agent-shell` remains available for a machine-wide choice. Advertising it is the cheaper default: the alternative is that every fresh checkout rebuilds the uv2nix environment the cache already holds |
|
|
119
|
+
| CI | existing GitHub workflows, plus a `nix flake check` job and the cache job above | the check job runs on pull requests and pushes to the default branch, so a `flake.lock` bump is validated before merge rather than after; it runs the full check rather than an evaluation-only pass, because proving the flake parses says nothing about whether the tests still pass. Publication is gated on the upstream repository and `main`, so it never runs from a fork |
|
|
120
|
+
|
|
121
|
+
`flake.lock` node count: **8**, with a single `nixpkgs` node — every input
|
|
122
|
+
that can follow our nixpkgs does, including `flake-parts -> nixpkgs-lib` and
|
|
123
|
+
`pyproject-nix`. (`git-hooks.nix` follows our `flake-compat` edge for the same
|
|
124
|
+
reason: one node per input, not one per consumer.)
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
{
|
|
2
|
+
"nodes": {
|
|
3
|
+
"flake-compat": {
|
|
4
|
+
"flake": false,
|
|
5
|
+
"locked": {
|
|
6
|
+
"lastModified": 1767039857,
|
|
7
|
+
"narHash": "sha256-vNpUSpF5Nuw8xvDLj2KCwwksIbjua2LZCqhV1LNRDns=",
|
|
8
|
+
"owner": "NixOS",
|
|
9
|
+
"repo": "flake-compat",
|
|
10
|
+
"rev": "5edf11c44bc78a0d334f6334cdaf7d60d732daab",
|
|
11
|
+
"type": "github"
|
|
12
|
+
},
|
|
13
|
+
"original": {
|
|
14
|
+
"owner": "NixOS",
|
|
15
|
+
"repo": "flake-compat",
|
|
16
|
+
"type": "github"
|
|
17
|
+
}
|
|
18
|
+
},
|
|
19
|
+
"flake-parts": {
|
|
20
|
+
"inputs": {
|
|
21
|
+
"nixpkgs-lib": [
|
|
22
|
+
"nixpkgs"
|
|
23
|
+
]
|
|
24
|
+
},
|
|
25
|
+
"locked": {
|
|
26
|
+
"lastModified": 1793576659,
|
|
27
|
+
"narHash": "sha256-V1h85lUaJBQoHFrB2vpXZOE0Ju1MYSnIpsehoVZYlDo=",
|
|
28
|
+
"owner": "hercules-ci",
|
|
29
|
+
"repo": "flake-parts",
|
|
30
|
+
"rev": "ea2630b7470978622c7689a1ff75d2b389175399",
|
|
31
|
+
"type": "github"
|
|
32
|
+
},
|
|
33
|
+
"original": {
|
|
34
|
+
"owner": "hercules-ci",
|
|
35
|
+
"repo": "flake-parts",
|
|
36
|
+
"type": "github"
|
|
37
|
+
}
|
|
38
|
+
},
|
|
39
|
+
"git-hooks-nix": {
|
|
40
|
+
"inputs": {
|
|
41
|
+
"flake-compat": [
|
|
42
|
+
"flake-compat"
|
|
43
|
+
],
|
|
44
|
+
"nixpkgs": [
|
|
45
|
+
"nixpkgs"
|
|
46
|
+
]
|
|
47
|
+
},
|
|
48
|
+
"locked": {
|
|
49
|
+
"lastModified": 1793686154,
|
|
50
|
+
"narHash": "sha256-Zb/0L3soxrkfcrywpfp0J++0WFLB3tzh0Xtx9up+VNc=",
|
|
51
|
+
"owner": "cachix",
|
|
52
|
+
"repo": "git-hooks.nix",
|
|
53
|
+
"rev": "204b6977e00caac19e2313015a598543ca7be150",
|
|
54
|
+
"type": "github"
|
|
55
|
+
},
|
|
56
|
+
"original": {
|
|
57
|
+
"owner": "cachix",
|
|
58
|
+
"repo": "git-hooks.nix",
|
|
59
|
+
"type": "github"
|
|
60
|
+
}
|
|
61
|
+
},
|
|
62
|
+
"nixpkgs": {
|
|
63
|
+
"locked": {
|
|
64
|
+
"lastModified": 1794537146,
|
|
65
|
+
"narHash": "sha256-Wpz/7x/YWnDIBu7yj6ixe8j6fIMsidd9Y+o1PqPF3iM=",
|
|
66
|
+
"owner": "NixOS",
|
|
67
|
+
"repo": "nixpkgs",
|
|
68
|
+
"rev": "d5cc6833999746cffdfe0598f7bc801a57b887a9",
|
|
69
|
+
"type": "github"
|
|
70
|
+
},
|
|
71
|
+
"original": {
|
|
72
|
+
"owner": "NixOS",
|
|
73
|
+
"ref": "nixos-unstable",
|
|
74
|
+
"repo": "nixpkgs",
|
|
75
|
+
"type": "github"
|
|
76
|
+
}
|
|
77
|
+
},
|
|
78
|
+
"pyproject-build-systems": {
|
|
79
|
+
"inputs": {
|
|
80
|
+
"nixpkgs": [
|
|
81
|
+
"nixpkgs"
|
|
82
|
+
],
|
|
83
|
+
"pyproject-nix": [
|
|
84
|
+
"pyproject-nix"
|
|
85
|
+
],
|
|
86
|
+
"uv2nix": [
|
|
87
|
+
"uv2nix"
|
|
88
|
+
]
|
|
89
|
+
},
|
|
90
|
+
"locked": {
|
|
91
|
+
"lastModified": 1794012432,
|
|
92
|
+
"narHash": "sha256-zBKFTg7tEGApNt+CEKI5+WNNomD5MZqYNBr+r6/Bmdg=",
|
|
93
|
+
"owner": "pyproject-nix",
|
|
94
|
+
"repo": "build-system-pkgs",
|
|
95
|
+
"rev": "bdbc5f8dd2ad6136bb2ccecb14f6ec343965b194",
|
|
96
|
+
"type": "github"
|
|
97
|
+
},
|
|
98
|
+
"original": {
|
|
99
|
+
"owner": "pyproject-nix",
|
|
100
|
+
"repo": "build-system-pkgs",
|
|
101
|
+
"type": "github"
|
|
102
|
+
}
|
|
103
|
+
},
|
|
104
|
+
"pyproject-nix": {
|
|
105
|
+
"inputs": {
|
|
106
|
+
"nixpkgs": [
|
|
107
|
+
"nixpkgs"
|
|
108
|
+
]
|
|
109
|
+
},
|
|
110
|
+
"locked": {
|
|
111
|
+
"lastModified": 1793820880,
|
|
112
|
+
"narHash": "sha256-NUMabnvaL/0Ah9WM9pBMXEp+dQjMSYjezZ/fNjXouLQ=",
|
|
113
|
+
"owner": "pyproject-nix",
|
|
114
|
+
"repo": "pyproject.nix",
|
|
115
|
+
"rev": "d43f0e74444c1f266c640fc49ce6ce6fb69d33c3",
|
|
116
|
+
"type": "github"
|
|
117
|
+
},
|
|
118
|
+
"original": {
|
|
119
|
+
"owner": "pyproject-nix",
|
|
120
|
+
"repo": "pyproject.nix",
|
|
121
|
+
"type": "github"
|
|
122
|
+
}
|
|
123
|
+
},
|
|
124
|
+
"root": {
|
|
125
|
+
"inputs": {
|
|
126
|
+
"flake-compat": "flake-compat",
|
|
127
|
+
"flake-parts": "flake-parts",
|
|
128
|
+
"git-hooks-nix": "git-hooks-nix",
|
|
129
|
+
"nixpkgs": "nixpkgs",
|
|
130
|
+
"pyproject-build-systems": "pyproject-build-systems",
|
|
131
|
+
"pyproject-nix": "pyproject-nix",
|
|
132
|
+
"uv2nix": "uv2nix"
|
|
133
|
+
}
|
|
134
|
+
},
|
|
135
|
+
"uv2nix": {
|
|
136
|
+
"inputs": {
|
|
137
|
+
"nixpkgs": [
|
|
138
|
+
"nixpkgs"
|
|
139
|
+
],
|
|
140
|
+
"pyproject-nix": [
|
|
141
|
+
"pyproject-nix"
|
|
142
|
+
]
|
|
143
|
+
},
|
|
144
|
+
"locked": {
|
|
145
|
+
"lastModified": 1793272761,
|
|
146
|
+
"narHash": "sha256-3CE1CEwprYlHRlRVkXDkhqec0jjF9Cti7tdk8vVDsCM=",
|
|
147
|
+
"owner": "pyproject-nix",
|
|
148
|
+
"repo": "uv2nix",
|
|
149
|
+
"rev": "c361746c7d630d98b972378290547c8d35542a7a",
|
|
150
|
+
"type": "github"
|
|
151
|
+
},
|
|
152
|
+
"original": {
|
|
153
|
+
"owner": "pyproject-nix",
|
|
154
|
+
"repo": "uv2nix",
|
|
155
|
+
"type": "github"
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
},
|
|
159
|
+
"root": "root",
|
|
160
|
+
"version": 7
|
|
161
|
+
}
|