pilot-workers 0.2.0__py3-none-any.whl

pilot_workers/scripts/install_runtime.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# The pinned version has a single source of truth:
+# src/pilot_workers/runners/opencode_runner.py (PINNED_OPENCODE_VERSION).
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+OPENCODE_VERSION="$(python3 -c "from pilot_workers.runners.opencode_runner import PINNED_OPENCODE_VERSION as v; print(v)")"
+if [[ -z "${OPENCODE_VERSION}" ]]; then
+  echo "error: could not read PINNED_OPENCODE_VERSION from runners/opencode_runner.py" >&2
+  exit 1
+fi
+
+readonly CODEX_ROOT="${CODEX_HOME:-${HOME}/.codex}"
+readonly INSTALL_ROOT="${CODEX_ROOT}/worker-runtime/opencode/${OPENCODE_VERSION}"
+readonly OPENCODE_BIN="${INSTALL_ROOT}/node_modules/.bin/opencode"
+
+if ! command -v npm >/dev/null 2>&1; then
+  echo "error: npm is required to install the pinned OpenCode runtime" >&2
+  exit 1
+fi
+
+if [[ -x "${OPENCODE_BIN}" ]]; then
+  actual_version="$(${OPENCODE_BIN} --version 2>&1)"
+  if [[ "${actual_version}" == "${OPENCODE_VERSION}" ]]; then
+    echo "OpenCode ${OPENCODE_VERSION} is already installed at ${OPENCODE_BIN}"
+    exit 0
+  fi
+fi
+
+mkdir -p "${INSTALL_ROOT}"
+chmod 700 "${CODEX_ROOT}/worker-runtime" "${CODEX_ROOT}/worker-runtime/opencode" "${INSTALL_ROOT}"
+
+npm install \
+  --prefix "${INSTALL_ROOT}" \
+  --no-package-lock \
+  --no-save \
+  --ignore-scripts=false \
+  "opencode-ai@${OPENCODE_VERSION}"
+
+if [[ ! -x "${OPENCODE_BIN}" ]]; then
+  echo "error: npm completed but did not create ${OPENCODE_BIN}" >&2
+  exit 1
+fi
+
+actual_version="$(${OPENCODE_BIN} --version 2>&1)"
+if [[ "${actual_version}" != "${OPENCODE_VERSION}" ]]; then
+  echo "error: expected OpenCode ${OPENCODE_VERSION}, got ${actual_version}" >&2
+  exit 1
+fi
+
+echo "Installed OpenCode ${OPENCODE_VERSION} at ${OPENCODE_BIN}"

pilot_workers-0.2.0.dist-info/METADATA

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: pilot-workers
+Version: 0.2.0
+Summary: Dispatch bounded tasks to isolated LLM workers (GLM, Kimi, and more)
+License-Expression: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: yaml
+Requires-Dist: pyyaml>=6.0; extra == "yaml"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pyyaml>=6.0; extra == "dev"
+Dynamic: license-file
+
+# pilot-workers
+
+Dispatch bounded tasks to isolated LLM workers. Your main AI agent (Claude, Codex, or any planner) stays in control of requirements, planning, and verification — the worker only executes what it's told.
+
+## What it does
+
+- **Provider isolation**: each model (GLM, Kimi, or your own) gets its own credentials, XDG directories, logs, and session storage. No cross-contamination.
+- **Fixed routing**: provider, model, and endpoint are locked per YAML config. Tasks cannot override them.
+- **Security by default**: API keys never appear in CLI args, environment variables, task contracts, or logs. Output is auto-redacted.
+- **Five modes**: `code` (edit), `explore` (read-only), `test` (run tests), `review` (read-only audit), `resume` (continue a prior code session).
+- **Observable**: `worker_runner.started` → heartbeats → `worker_runner.summary`. Human-readable live log at `latest.log` for `tail -f`.
+- **Pluggable runners**: currently wraps [OpenCode](https://opencode.ai) via `@ai-sdk/openai-compatible`; the runner interface is designed for future alternatives (Aider, Continue, etc.).
+
+## Quick start
+
+```bash
+# 1. Install the pinned OpenCode runtime
+pilot-workers runtime install
+
+# 2. Add a provider (YAML files in src/pilot_workers/data/providers/)
+# GLM and Kimi are included; add your own by copying the template
+
+# 3. Configure credentials (interactive, key never displayed)
+python3 -m pilot_workers.credentials glm
+python3 -m pilot_workers.credentials kimi-k3
+
+# 4. Verify
+python3 -m pilot_workers.cli.run --provider glm --mode explore --workdir . --task "hello" --dry-run
+
+# 5. Run a real task
+python3 -m pilot_workers.cli.run \
+  --provider glm --mode code \
+  --workdir /path/to/project \
+  --task-file /path/to/task.md
+```
+
+## Adding a new provider
+
+Drop a YAML file in `data/providers/` (inside the package):
+
+```yaml
+key: deepseek
+provider_id: deepseek-worker
+model_id: deepseek-coder-v3
+base_url: https://api.deepseek.com/v1
+display_name: DeepSeek Coder V3
+context_tokens: 128000
+output_tokens: 8192
+```
+
+Then `python3 -m pilot_workers.credentials deepseek` and you're done.
+
+## Host integration
+
+The **host** is whatever AI agent acts as the planner — Claude, Codex, Gemini, GLM itself, or anything that can write a task file and call the CLI.
+
+`integrations/` has ready-made configs for current hosts:
+- **`claude-host/`**: 12 agents + 8 slash commands (`/glm:code`, `/kimi:explore`, etc.)
+- **`codex-host/`**: `$glm` / `$kimi` / `$ds` skill entry points
+
+Adding a new host: create `integrations/<name>-host/`, put whatever config your host needs, point it at `python3 -m pilot_workers.cli.run`. See `integrations/README.md`.
+
+## Architecture
+
+See [docs/architecture.md](docs/architecture.md) for the shared contract, security model, and verification checklist.
+
+## License
+
+MIT

pilot_workers-0.2.0.dist-info/RECORD

@@ -0,0 +1,66 @@
+pilot_workers/__init__.py,sha256=cxeWywoHvaOCFXynpw57ppMPCMYFwTkeA8odI_hgmDw,69
+pilot_workers/__main__.py,sha256=t3aDCuovrf0R-SnmPQIeWnxCVZ6-bbKZ47VFe5vl1DM,66
+pilot_workers/credentials.py,sha256=oMgLgqaXXSLXhnWH_HAPP3kNUPVnlZht9qEYqjUU4VM,3554
+pilot_workers/fmt_events.py,sha256=lcY6Dae-pUQuuGrJrsO5f0yilOIlRpO2m3BUSbzjUwY,7629
+pilot_workers/maintain.py,sha256=CJBhzJnA6PM7F8EF5308Si8YlrkFj2VxWo3Bm2_4C78,6154
+pilot_workers/policy.py,sha256=gaeGW2ZaO7OBiYPSf0fdj5qnmK4qTHkV8yggJdaKU-k,9433
+pilot_workers/providers.py,sha256=CCzQ0koNxTUVjLgnNOiMHCBML-6iPh6JA2V0EFTkSxI,4402
+pilot_workers/runtime.py,sha256=kyD0vY1Ruzvpv763zvDJRdLWHLx-H_8Qj5NbyeBkGT0,12117
+pilot_workers/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pilot_workers/cli/dispatch.py,sha256=HjSShmbU0_2etqjy0OPAhXDe7U5QqchV1Tj87cUbvoY,18498
+pilot_workers/cli/install.py,sha256=r2aYXj_dpRMAWATeZceqr-VxhnecKxDFL2NBcmXJvKA,9051
+pilot_workers/cli/main.py,sha256=79fF7IVVogUPUGucuMdbp_uZA-OfBrQwlydzLXb7WVk,3585
+pilot_workers/cli/run.py,sha256=bbucDRcgZ8y67SMNg5TgxYQBOFcX3lRSXlgGp_3MifA,8135
+pilot_workers/data/permissions/README.md,sha256=kqFQGyvOhay15JIUASIW2aAh600Rix7iYvrnSoCLKHU,998
+pilot_workers/data/permissions/relaxed.yaml,sha256=T4JWLtgAjKeHZv2b5JFnAEBy41kwkIZu9KnSh05VKvU,231
+pilot_workers/data/permissions/strict.yaml,sha256=ptNtrPoQRrexSbVklfCdq_DsBs60yxRqb9ceZTnN7K0,211
+pilot_workers/data/providers/README.md,sha256=mteyQkPyhwCZ9-1Hd-40v4MB3Wg_-xM2yg_NWZHRamQ,1044
+pilot_workers/data/providers/ds.yaml,sha256=WQIwqjkeyaSqZpTaF9mdM33dNCrk5WKicJYjO5xUr8o,314
+pilot_workers/data/providers/glm.yaml,sha256=vvN2xgZmWVhmqeT7gFcmSNGavrinH9KRdR2c-3KhZ2s,343
+pilot_workers/data/providers/kimi-k3.yaml,sha256=ZKsBQaraLHzenani5K0t3zsg77wRT1PvfCtUef8pIGw,378
+pilot_workers/data/templates/code.md,sha256=QQkywTe5-Dqxpr0a_oI-vOuUFxclvbuc4AQjfmwG8kg,1476
+pilot_workers/data/templates/explore.md,sha256=aJeQ6fV7x_TWMFeKo8yxFCJ1GYAUGjc2ORvOJe8-jYw,1076
+pilot_workers/data/templates/review.md,sha256=doGwxxFHupqFOh7nwEx6KnHKLYpeCZjDdR21jBbGOIQ,909
+pilot_workers/data/templates/test.md,sha256=I1HD4B4pnby42kcAF2H0P68SBK7LGRVb2UQKgdaV2so,930
+pilot_workers/integrations/README.md,sha256=BzJdTxEHkXLBOPjHZQYKEimgvOn96w4klAlDTwv18KQ,1128
+pilot_workers/integrations/claude-host/agents/ds-coder.md,sha256=0cQQabB1vL9TR7toIpQetiT_pEzxuK8XkX7wQP0UjjY,5602
+pilot_workers/integrations/claude-host/agents/ds-explorer.md,sha256=plYgXo4zVQDkj-NQU0uUx4LpHBRXf9MlRoYtRvAkXQc,4598
+pilot_workers/integrations/claude-host/agents/ds-reviewer.md,sha256=WydWi6HrP6GvhegNa6EN3QM5AolgsovBBzOtfRlozF4,3966
+pilot_workers/integrations/claude-host/agents/ds-tester.md,sha256=ijU6H-EUVCDpATS6OHfmFCcStGnMUz523GSPlxAA4og,3577
+pilot_workers/integrations/claude-host/agents/glm-coder.md,sha256=W14_gfQa0TPeQglByp-HZx0PzSUNGjD96lTsnfo2fPM,5583
+pilot_workers/integrations/claude-host/agents/glm-explorer.md,sha256=7CwlRxR50_zmyjdz_HTJ1Ib13sY9AKoBkI_SqG2Sats,4583
+pilot_workers/integrations/claude-host/agents/glm-reviewer.md,sha256=Xd3djRpVf76qZsSmtjpWx4NT-_B-sm6gMbcC65JTASk,3955
+pilot_workers/integrations/claude-host/agents/glm-tester.md,sha256=iNG35jFMGz7D6Qp996_ijkR6LIQ4SxNlrGBYUQvoRSM,3563
+pilot_workers/integrations/claude-host/agents/kimi-coder.md,sha256=CSphYIdI_Vwod4h5TjrJgRAzCaQqAXt4LUVRJwGwJO0,5606
+pilot_workers/integrations/claude-host/agents/kimi-explorer.md,sha256=ZfZKzbpuONI_FSCt0-W5HszJkdSuDALDMe5RJLSIwBs,4601
+pilot_workers/integrations/claude-host/agents/kimi-reviewer.md,sha256=KfWH6kkGM8F0GbwLc3QLpPlFFQFNIkJjIHFnMGrXf5A,3971
+pilot_workers/integrations/claude-host/agents/kimi-tester.md,sha256=2-cTVCI6iZ0c4lBdc7_zWUHnp9Bs4j5dixZ7CdEANRE,4013
+pilot_workers/integrations/claude-host/commands/glm/code.md,sha256=TRN48nF7cF_Qd2bC9rpZRrFieBdmvGLeLLTgysrZh5I,4906
+pilot_workers/integrations/claude-host/commands/glm/explore.md,sha256=jjRsHpPhdpBn2k8DDk_xjEoBUqhw4V8iOa0IliAn-JM,3459
+pilot_workers/integrations/claude-host/commands/glm/review.md,sha256=FGI8LE7qaaDL4myfijCr1cDndjrbwEyZHKy70jV8S24,3583
+pilot_workers/integrations/claude-host/commands/glm/test.md,sha256=FDGU4an1O9fIP2Oqzb7Pb8zobYQJaTdot-uFDpmIVfY,2803
+pilot_workers/integrations/claude-host/commands/kimi/code.md,sha256=8spNPD5llNl_xcZ88B8YixtPmTv9gOD-IBJudd1T9rg,4609
+pilot_workers/integrations/claude-host/commands/kimi/explore.md,sha256=jB_PMc_pP9v-NZ8fpjD8LUz12JOkHQWfQxgM7wqi-E0,3474
+pilot_workers/integrations/claude-host/commands/kimi/review.md,sha256=z1lw8FnxC_ioNuoV--MfRbeXEah8X95EMquLAlrOF2k,3594
+pilot_workers/integrations/claude-host/commands/kimi/test.md,sha256=k4V2BGrsrN2_Vk1pWYgWKIY_HYV29ITVVD7hP6q076o,3282
+pilot_workers/integrations/codex-host/ds/SKILL.md,sha256=2WTFuRfidVOynCed3yMCVn0oQ_Az_zX6ElFsFL5i1KY,2413
+pilot_workers/integrations/codex-host/ds/openai.yaml,sha256=9H57ch7KAC0my_OolEsEqCKvCVXXb8w9xygj6gryK6c,185
+pilot_workers/integrations/codex-host/glm/SKILL.md,sha256=_bP_y1P8alWU5KXQZvk0ik7mtc62n9pUQHb1kbByUCo,2409
+pilot_workers/integrations/codex-host/glm/openai.yaml,sha256=6sig_r6LLscULOjf0GRvBTRhU5CwIB2dWhWk9cotbmQ,151
+pilot_workers/integrations/codex-host/kimi/SKILL.md,sha256=8ArHcXAEU5s7m66RsXqo_9Gz3vWSSggpp9KSVpi53ro,2441
+pilot_workers/integrations/codex-host/kimi/openai.yaml,sha256=CqGtY2oGvyrKl6uM1xc_HaMfaSQTjqqNMBLOGm67BEc,153
+pilot_workers/prompts/code.md,sha256=3xQ1bgZ0lqEKVvl5JqvSRSRMuhBZ8DRAV7bORYk-Q5Y,620
+pilot_workers/prompts/common.md,sha256=LPKQub-6kNg6j8GcxhPrgTwFMQJcAvCRhb6HMfJRoxE,1809
+pilot_workers/prompts/explore.md,sha256=C_cP5HQ6GEdGp3AVS3pF6JE6-XVQDM9TXyq9bkwjLrc,620
+pilot_workers/prompts/review.md,sha256=kwtUCoIFW36hSSeC62tN5ibDMAJP2HWbFWvFrLkjFQI,453
+pilot_workers/prompts/test.md,sha256=7jcsR9hyHUkjS6YZ0qwCWVCaKuiSZXR9wyAQtKTwiyg,421
+pilot_workers/runners/__init__.py,sha256=kz82FJBFXJTeZmVSac7fyU0KXX9oVK5SJO1MXVy6COg,821
+pilot_workers/runners/base.py,sha256=gtOK_HaK9OuyZX7A-9IbwHD5Jiuf2y5RIAe3nBlh0mI,5034
+pilot_workers/runners/opencode_runner.py,sha256=KCRBzGcRb7CZk3QQwNto5IeTqeVbGH2InW55ftr-5pk,13468
+pilot_workers/scripts/install_runtime.sh,sha256=GwQAKbamJsSvoIGYt_M6NXfKInigOBHAOi77DaTy-h4,1736
+pilot_workers-0.2.0.dist-info/licenses/LICENSE,sha256=ESYyLizI0WWtxMeS7rGVcX3ivMezm-HOd5WdeOh-9oU,1056
+pilot_workers-0.2.0.dist-info/METADATA,sha256=JD0OhEEtybXCM5y-f_2C3iSq6g_HUoRMdfE7-f-bsvg,3264
+pilot_workers-0.2.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+pilot_workers-0.2.0.dist-info/entry_points.txt,sha256=feWDxGcznJIc8unFN23kjZlyrxiyG1Q0SzH4RcKapSE,62
+pilot_workers-0.2.0.dist-info/top_level.txt,sha256=abA_ucmiDYjGZBvjxuFCqVWNeyxFfkrFNQQ1AhLZf1s,14
+pilot_workers-0.2.0.dist-info/RECORD,,

pilot_workers-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pilot_workers-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pilot-workers = pilot_workers.cli.main:main

pilot_workers-0.2.0.dist-info/licenses/LICENSE

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

pilot_workers-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pilot_workers