feat: Deterministic Agent Callbacks Model-Initiated Control Umbrella - Unleash the CLI in opencode

[micuintus]

Issue for this PR

Closes #20018

Type of change

• Bug fix
• New feature
• Refactor / code improvement
• Documentation

What does this PR do?

Closes #20018 — Enter DACMICU = Deterministic Agent Callbacks — Model-Initiated Control Umbrella

The heart of this PR: It introduces a CLI tool (oc) that "calls back into opencode"

• This enables the model to write bash (or python) scripts that can make tool and LLM calls, orchestrating the control flow

Idea: Unleash the full power of the UNIX CLI in opencode, see #20018

1. LLMs are good at figuring out things and generating code
2. LLMs are bad at:

• Iterations — they lose count, skip steps, forget where they were
• Following through — they lose track of the control flow once grinding too much on one aspect
• Deterministic control flow — loops, conditionals, batch operations are something LLMs are really bad at

Three Use Cases

1. Ralph Loop — delegate entire task, re-verify until clean

while oc check "Look at this branch, check for bugs, security issues, check unit tests. Fix everything and commit."; do
  oc status "Review round complete — re-checking..."
done

2. Fabric-style pipes — AI judgment in Unix pipelines

find src/ -name "*.ts" | while read f; do
  cat "$f" | oc prompt -s "Code reviewer" "Rate complexity 1-10. Just the number."
done | sort -rn | head -10

3. Deterministic batch with opencode tools

oc tool glob "src/**/*.ts" | while IFS= read -r f; do
  oc tool edit "$f" --old "getUserData" --new "getUser"
done

How did you verify your code works?

• A comprehensive list of unit tests has been added (along the way when discovering issues)
• Intensive manuel testing

Screenshots / recordings

Fabric

SR.DACMICU.Fabric_compressed.mov

Sorry for the token waste :D, but the reason I let it run on 243 files was to make the point:

• A standard agent would have never followed through summarising all of the paper
• and wasted way more tokens and taken way much longer for such a task.

Ralph Loop

Example 1:

Another run (both with Sonnet)

Checklist

• I have tested my changes locally
• I have not included unrelated changes in this PR

If you do not follow this template your PR will be automatically rejected.

[github-actions]

Hey! Your PR title Feat: Deterministic Agent Callbacks Model-Initiated Control Umbrella - Unleash the CLI in opencode doesn't follow conventional commit format.

Please update it to start with one of:

• feat: or feat(scope): new feature
• fix: or fix(scope): bug fix
• docs: or docs(scope): documentation changes
• chore: or chore(scope): maintenance tasks
• refactor: or refactor(scope): code refactoring
• test: or test(scope): adding or updating tests

Where scope is the package name (e.g., app, desktop, opencode).

See CONTRIBUTING.md for details.