free-agent-execution

Free Agent Execution

Use the bundled scripts/run-free-worker adapter to execute one bounded worker task. The frontier agent remains responsible for preparing the contract, reviewing the result, and deciding what to keep.

Do not invoke the adapter unless the user explicitly authorizes free-agent execution. Never include secrets, credentials, personal data, or other sensitive material in the requirement or working tree.

Invocation

Pass one JSON contract file:

.agents/skills/free-agent-execution/scripts/run-free-worker /absolute/path/to/contract.json

The adapter writes one JSON result to standard output. A missing or unreadable contract is a usage error with exit status 2. Contract, model, worker, scope, and validation failures are returned as JSON with status: "failed".

Input contract

Use this shape:

{
  "contract_version": "1",
  "mode": "free",
  "execution_role": "worker",
  "parent_role": "frontier",
  "parent_run_id": "run-123",
  "delegation_depth": 1,
  "task_id": "task-1.1",
  "task_class": "bounded_code",
  "sensitivity": "non_sensitive",
  "working_directory": "/absolute/path/to/git-worktree",
  "requirement": "Implement one precise, bounded change.",
  "require_changes": true,
  "allowed_files": [
    "relative/path/to/file"
  ],
  "validation": {
    "command": [
      "make",
      "test"
    ]
  },
  "model": "omniroute/oc/deepseek-v4-flash-free",
  "timeout_seconds": 30
}

The adapter requires these values and types:

• contract_version: exactly "1".
• mode: exactly "free".
• execution_role: exactly "worker".
• parent_role: exactly "frontier".
• sensitivity: exactly "non_sensitive".
• working_directory: a non-empty absolute path inside a Git worktree. Prefer the worktree root so Git paths match allowed_files.
• requirement: a non-empty string containing one bounded implementation task.
• allowed_files: an array of worktree-relative file paths. Use exact Git path spelling.
• validation.command: a non-empty array of executable and argument strings. It is executed directly, without shell interpolation.
• model: one of the verified models below.
• task_class: a configured free-worker task class. Version one provides bounded_code.
• parent_run_id: a non-empty string identifying the delegating frontier run.
• require_changes: an optional boolean. Set it to true for edit tasks so a non-empty explanation without an attributed file change fails visibly. Omit it or set it to false when a no-change result is valid.
• task_id: a non-empty string identifying this task within the delegation tree.
• delegation_depth: exactly 1 for a worker contract.