macro-agent 0.1.1 → 0.1.3

package/references/acp-factory-ref/package.json

@@ -1,96 +0,0 @@
-{
-  "name": "acp-factory",
-  "version": "0.1.10",
-  "description": "A library for spawning and managing agents through the Agent Client Protocol (ACP)",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist/",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest",
-    "test:run": "vitest run",
-    "test:e2e": "RUN_E2E_TESTS=true vitest run test/e2e/",
-    "test:e2e:local": "RUN_E2E_TESTS=true USE_LOCAL_FORK=true vitest run test/e2e/",
-    "test:e2e:codex": "RUN_E2E_TESTS=true vitest run test/e2e/codex.e2e.test.ts",
-    "test:e2e:copilot-cli": "RUN_E2E_TESTS=true vitest run test/e2e/copilot-cli.e2e.test.ts",
-    "test:e2e:gemini": "RUN_E2E_TESTS=true vitest run test/e2e/gemini.e2e.test.ts",
-    "test:e2e:opencode": "RUN_E2E_TESTS=true vitest run test/e2e/opencode.e2e.test.ts",
-    "test:e2e:claude": "RUN_E2E_TESTS=true vitest run test/e2e/session-fork-resume.test.ts test/e2e/fork-with-flush.e2e.test.ts",
-    "lint": "eslint src --ext .ts",
-    "lint:fix": "eslint src --ext .ts --fix",
-    "clean": "rm -rf dist",
-    "prebuild": "npm run clean",
-    "pretest:run": "npm run build",
-    "prepublishOnly": "npm run test:run && npm run build",
-    "version": "npm run build",
-    "postversion": "git push && git push --tags",
-    "release:patch": "npm version patch",
-    "release:minor": "npm version minor",
-    "release:major": "npm version major",
-    "publish:dry": "npm publish --dry-run",
-    "publish:npm": "npm publish --access public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/sudocode-ai/acp-factory.git"
-  },
-  "bugs": {
-    "url": "https://github.com/sudocode-ai/acp-factory/issues"
-  },
-  "homepage": "https://github.com/sudocode-ai/acp-factory#readme",
-  "keywords": [
-    "acp",
-    "agent",
-    "agent-client-protocol",
-    "ai",
-    "llm",
-    "typescript",
-    "sdk"
-  ],
-  "author": "Sudocode AI",
-  "license": "MIT",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@agentclientprotocol/sdk": "^0.13.0"
-  },
-  "peerDependencies": {
-    "@sudocode-ai/claude-code-acp": "^0.13.9",
-    "@zed-industries/codex-acp": "^0.9.0",
-    "@github/copilot": ">0.0.388",
-    "@google/gemini-cli": "^0.21.0"
-  },
-  "peerDependenciesMeta": {
-    "@sudocode-ai/claude-code-acp": {
-      "optional": true
-    },
-    "@zed-industries/codex-acp": {
-      "optional": true
-    },
-    "@github/copilot": {
-      "optional": true
-    },
-    "@google/gemini-cli": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "typescript": "^5.7.0",
-    "vitest": "^2.0.0"
-  }
-}

package/references/acp-factory-ref/python/CHANGELOG.md

@@ -1,33 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-## [0.1.0] - 2025-01-06
-
-### Added
-
-- Initial release - 1:1 port from TypeScript implementation
-- `AgentFactory` for registering and spawning agents
-- `AgentHandle` for managing agent processes
-- `Session` for interacting with agent sessions
-- Pre-registered agents: `claude-code`, `codex`, `gemini`, `opencode`
-- Streaming responses via async iterators
-- Permission handling modes: `auto-approve`, `auto-deny`, `callback`, `interactive`
-- Interactive permission requests as session updates
-- `session.interrupt_with()` for interrupting and redirecting agents
-- `session.fork()` for creating independent session copies (experimental)
-- `agent_handle.fork_session()` for forking by session ID (experimental)
-- `session.flush()` for checkpointing sessions to disk
-- Custom file read/write handlers
-- Terminal operation handlers
-- MCP server support
-- Full type annotations (PEP 561 compliant)
-
-### Dependencies
-
-- `agent-client-protocol` >=0.7.0

package/references/acp-factory-ref/python/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Sudocode AI
-
-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.

package/references/acp-factory-ref/python/Makefile

@@ -1,57 +0,0 @@
-.PHONY: install dev test lint format typecheck clean build publish publish-test
-
-# Install package
-install:
-	pip install .
-
-# Install with dev dependencies
-dev:
-	pip install -e ".[dev]"
-
-# Run tests
-test:
-	pytest
-
-# Run linter
-lint:
-	ruff check src tests
-
-# Format code
-format:
-	ruff format src tests
-	ruff check --fix src tests
-
-# Run type checker
-typecheck:
-	mypy src
-
-# Clean build artifacts
-clean:
-	rm -rf dist build *.egg-info src/*.egg-info
-	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
-	find . -type f -name "*.pyc" -delete
-
-# Build package
-build: clean
-	python -m build
-
-# Publish to TestPyPI (for testing)
-publish-test: build
-	python -m twine upload --repository testpypi dist/*
-
-# Publish to PyPI
-publish: build
-	python -m twine upload dist/*
-
-# Version bump helpers
-version-patch:
-	@echo "Update version in pyproject.toml and src/acp_factory/__init__.py"
-	@echo "Then run: git tag v<version> && git push --tags"
-
-version-minor:
-	@echo "Update version in pyproject.toml and src/acp_factory/__init__.py"
-	@echo "Then run: git tag v<version> && git push --tags"
-
-version-major:
-	@echo "Update version in pyproject.toml and src/acp_factory/__init__.py"
-	@echo "Then run: git tag v<version> && git push --tags"

package/references/acp-factory-ref/python/README.md

@@ -1,253 +0,0 @@
-# acp-factory
-
-A Python library for spawning and managing AI agents through the [Agent Client Protocol (ACP)](https://agentclientprotocol.com/).
-
-## Installation
-
-```bash
-pip install acp-factory
-```
-
-## Prerequisites
-
-- Python 3.10+
-- [Claude Code](https://claude.ai/claude-code) installed and authenticated (run `claude` once to set up)
-- Or set `ANTHROPIC_API_KEY` environment variable
-
-## Quick Start
-
-```python
-import asyncio
-from acp_factory import AgentFactory
-
-async def main():
-    # Spawn a Claude Code agent
-    agent = await AgentFactory.spawn("claude-code", {
-        "permission_mode": "auto-approve",
-    })
-
-    # Create a session
-    session = await agent.create_session(".")
-
-    # Send a prompt and stream responses
-    async for update in session.prompt("What files are in this directory?"):
-        if update.get("session_update") == "agent_message_chunk":
-            content = update.get("content", {})
-            if content.get("type") == "text":
-                print(content.get("text", ""), end="")
-
-    # Clean up
-    await agent.close()
-
-asyncio.run(main())
-```
-
-## API Reference
-
-### AgentFactory
-
-Static class for managing agent types and spawning agents.
-
-```python
-# List available agents
-AgentFactory.list_agents()  # ["claude-code", "codex", "gemini", "opencode"]
-
-# Register a custom agent
-AgentFactory.register("my-agent", AgentConfig(
-    command="my-agent",
-    args=["--acp"],
-    env={"MY_VAR": "value"},
-))
-
-# Spawn an agent
-agent = await AgentFactory.spawn("claude-code", options)
-```
-
-### AgentHandle
-
-Represents a running agent process.
-
-```python
-# Agent capabilities
-agent.capabilities  # {"loadSession": True, ...}
-
-# Create a new session
-session = await agent.create_session("/path/to/cwd", SessionOptions(
-    mode="code",
-    mcp_servers=[],
-))
-
-# Load an existing session
-session = await agent.load_session(session_id, "/path/to/cwd")
-
-# Close the agent
-await agent.close()
-
-# Check if running
-agent.is_running()  # True/False
-```
-
-### Session
-
-High-level interface for interacting with an agent session.
-
-```python
-# Session properties
-session.id       # Session ID
-session.modes    # Available modes ["code", "ask", ...]
-session.models   # Available models ["claude-sonnet-4-...", ...]
-
-# Send a prompt (returns async iterator)
-async for update in session.prompt("Hello!"):
-    # Handle updates
-    pass
-
-# Cancel the current prompt
-await session.cancel()
-
-# Set the session mode
-await session.set_mode("ask")
-
-# Interrupt and redirect with new context
-async for update in session.interrupt_with("Focus on tests only"):
-    # Handle updates from new prompt
-    pass
-```
-
-## Permission Modes
-
-Control how permission requests are handled:
-
-```python
-from acp_factory import SpawnOptions
-
-# Auto-approve all requests (default)
-await AgentFactory.spawn("claude-code", SpawnOptions(
-    permission_mode="auto-approve",
-))
-
-# Auto-deny all requests
-await AgentFactory.spawn("claude-code", SpawnOptions(
-    permission_mode="auto-deny",
-))
-
-# Use a callback handler
-async def handle_permission(request):
-    return {"outcome": {"outcome": "selected", "option_id": "allow"}}
-
-await AgentFactory.spawn("claude-code", SpawnOptions(
-    permission_mode="callback",
-    on_permission_request=handle_permission,
-))
-
-# Interactive mode - permissions emitted as session updates
-await AgentFactory.spawn("claude-code", SpawnOptions(
-    permission_mode="interactive",
-))
-```
-
-## Development
-
-### Setup
-
-```bash
-# Clone the repository
-git clone https://github.com/sudocode-ai/acp-factory.git
-cd acp-factory/python
-
-# Install with dev dependencies
-make dev
-# or
-pip install -e ".[dev]"
-```
-
-### Commands
-
-```bash
-# Run tests
-make test
-
-# Run linter
-make lint
-
-# Format code
-make format
-
-# Type check
-make typecheck
-
-# Clean build artifacts
-make clean
-```
-
-## Publishing to PyPI
-
-### Prerequisites
-
-1. Create accounts on [PyPI](https://pypi.org/) and [TestPyPI](https://test.pypi.org/)
-2. Create API tokens for both
-3. Configure `~/.pypirc`:
-
-```ini
-[distutils]
-index-servers =
-    pypi
-    testpypi
-
-[pypi]
-username = __token__
-password = pypi-YOUR_PYPI_TOKEN
-
-[testpypi]
-username = __token__
-password = pypi-YOUR_TESTPYPI_TOKEN
-```
-
-### Release Process
-
-1. **Update version** in both files:
-   - `pyproject.toml` → `version = "X.Y.Z"`
-   - `src/acp_factory/__init__.py` → `__version__ = "X.Y.Z"`
-
-2. **Update CHANGELOG.md** with release notes
-
-3. **Test on TestPyPI first:**
-   ```bash
-   make publish-test
-
-   # Test installation from TestPyPI
-   pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ acp-factory
-   ```
-
-4. **Publish to PyPI:**
-   ```bash
-   make publish
-   ```
-
-5. **Create git tag:**
-   ```bash
-   git tag v0.0.1
-   git push --tags
-   ```
-
-### Manual Publishing
-
-If you prefer not to use Make:
-
-```bash
-# Install build tools
-pip install build twine
-
-# Build package
-python -m build
-
-# Upload to TestPyPI
-python -m twine upload --repository testpypi dist/*
-
-# Upload to PyPI
-python -m twine upload dist/*
-```
-
-## License
-
-MIT

package/references/acp-factory-ref/python/pyproject.toml

@@ -1,73 +0,0 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "acp-factory"
-version = "0.1.1"
-description = "A library for spawning and managing agents through the Agent Client Protocol (ACP)"
-readme = "README.md"
-license = "MIT"
-requires-python = ">=3.10"
-authors = [
-    { name = "Sudocode AI" }
-]
-keywords = [
-    "acp",
-    "agent",
-    "agent-client-protocol",
-    "ai",
-    "llm",
-    "sdk"
-]
-classifiers = [
-    "Development Status :: 3 - Alpha",
-    "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Typing :: Typed",
-]
-dependencies = [
-    "agent-client-protocol>=0.7.0",
-]
-
-[project.optional-dependencies]
-dev = [
-    "pytest>=8.0.0",
-    "pytest-asyncio>=0.23.0",
-    "ruff>=0.4.0",
-    "mypy>=1.10.0",
-    "build>=1.0.0",
-    "twine>=5.0.0",
-]
-
-[project.urls]
-Homepage = "https://github.com/sudocode-ai/acp-factory"
-Documentation = "https://github.com/sudocode-ai/acp-factory/tree/main/python#readme"
-Repository = "https://github.com/sudocode-ai/acp-factory"
-Issues = "https://github.com/sudocode-ai/acp-factory/issues"
-Changelog = "https://github.com/sudocode-ai/acp-factory/blob/main/python/CHANGELOG.md"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/acp_factory"]
-
-[tool.ruff]
-target-version = "py310"
-line-length = 100
-
-[tool.ruff.lint]
-select = ["E", "F", "I", "W"]
-
-[tool.mypy]
-python_version = "3.10"
-strict = true
-warn_return_any = true
-warn_unused_configs = true
-
-[tool.pytest.ini_options]
-asyncio_mode = "auto"
-testpaths = ["tests"]

package/references/acp-factory-ref/python/tests/e2e/__init__.py

@@ -1 +0,0 @@
-"""E2E tests for acp-factory Python port."""