Support Claude Code as a Homeboy Codebox agent-task runtime

[chubes4]

Problem

wp-coding-agents PR Extra-Chill/wp-coding-agents#197 adds a carried ai-provider-for-claude-code WP AI Client provider, but it cannot satisfy the Homeboy Codebox cooking gate yet.

The provider plugin loads in WP Codebox, but agent-task execution fails because the Codebox WordPress runtime cannot execute the local Claude Code CLI from inside Playground PHP.

Evidence

Tracking PR: Extra-Chill/wp-coding-agents#197

Canary commands were run via deterministic Homeboy orchestration:

./scripts/verify-homeboy-codebox-canary.sh --run \
  --workspace /Users/chubes/Developer/wp-coding-agents@claude-code-provider \
  --repo wp-coding-agents \
  --task-url https://github.com/Extra-Chill/wp-coding-agents/pull/197 \
  --run-id claude-code-provider-canary-20260608-0002 \
  --provider claude-code \
  --model claude-code \
  --max-turns 2 \
  --secret-env PATH \
  --agents-api /Users/chubes/Studio/intelligence-chubes4/wp-content/plugins/data-machine/vendor/wordpress/agents-api \
  --agent-runtime /Users/chubes/Studio/intelligence-chubes4/wp-content/plugins/data-machine \
  --agent-runtime-tools /Users/chubes/Studio/intelligence-chubes4/wp-content/plugins/data-machine-code \
  --provider-plugin-path /Users/chubes/Developer/wp-coding-agents@claude-code-provider/carried-plugins/ai-provider-for-claude-code

Result:

• Homeboy run: claude-code-provider-canary-20260608-0002
• State: failed
• Codebox loaded provider plugin: ai-provider-for-claude-code/ai-provider-for-claude-code.php
• Runtime policy: network: deny, commands: wordpress.wp-cli, wordpress.run-php, hostTools: []
• Failure: Claude Code exited with status 127
• Changed files: 0
• Patch bytes: 0

Additional probe:

• Homeboy run: claude-code-provider-canary-20260608-0004
• Mounted local /Users/chubes/.local/bin/claude into the runtime as /usr/local/bin/claude
• Set AI_PROVIDER_CLAUDE_CODE_BIN=/usr/local/bin/claude
• Result remained Claude Code exited with status 127

Diagnosis

A PHP provider that calls proc_open('claude ...') cannot power Codebox cooking unless WP Codebox exposes a Claude Code execution surface to the sandbox. The current runtime runs in WordPress Playground with no host tools and no network access, so it cannot execute the host-authenticated Claude Code subscription session.

Required contract

Add a first-class Claude Code agent-task runtime path for Homeboy Codebox, for example one of:

• A WP Codebox host tool/command that runs the authenticated host claude CLI and returns structured model/agent output to the sandbox runtime.
• A Codebox agent executor mode where Claude Code runs as the outer agent while WP Codebox supplies bounded workspace tools/artifacts.
• A documented runtime profile that can install/expose Claude Code plus auth inside an allowed sandbox environment without leaking subscription/session material.

Acceptance criteria:

• homeboy agent-task dispatch --backend codebox --provider-config @... with provider: claude-code completes successfully.
• The run uses Homeboy durable orchestration and WP Codebox artifacts.
• The Codebox transcript shows provider/plugin/runtime selection.
• changed-files.json, patch.diff, transcript, and aggregate outcome are present.
• No Claude auth/session values are serialized into recipe JSON, artifacts, logs, or prompts.