From d470218a0e143666ebe2507933dae8bcd5798239 Mon Sep 17 00:00:00 2001 From: abrichr Date: Wed, 2 Sep 2026 15:24:06 -0400 Subject: [PATCH] copy: two authoring modes, person-click and watch-and-admit Authority admits. A local agent may click while the person watches. The calling agent must not be the sole source of a novel production path. --- README.md | 2 +- docs/DESIGN.md | 6 ++++-- llms.txt | 2 +- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index c12ce80..e293bf8 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ OpenAdapt compiles demonstrated GUI workflows into programs. This package invoke `pip install openadapt` includes this package. Point a local MCP client at `openadapt-agent serve --allow-run` and the calling agent can invoke a compiled GUI program on this computer. Healthy runs make no model calls. Flow still runs the program. Policy, identity, verification, pauses, repair, and audit stay in [`openadapt-flow`](https://github.com/OpenAdaptAI/openadapt-flow). `--allow-run` is an explicit opt-in. Admission stays fail-closed. -The calling agent operates. A named human is authority. Compliance samples Seals, and that is a different job than running the program. Computer-use agents are the user of OpenAdapt. They are not the executor inside OpenAdapt. +The calling agent operates. A named human is authority. They watch if the agent clicked, then they admit. Compliance samples Seals, and that is a different job than running the program. Computer-use agents are the user of OpenAdapt. They are not the executor inside OpenAdapt. Don't name this skill computer use. diff --git a/docs/DESIGN.md b/docs/DESIGN.md index 5faa2e5..a0c6bf2 100644 --- a/docs/DESIGN.md +++ b/docs/DESIGN.md @@ -17,11 +17,13 @@ and audit. The CLI remains. Headless does not mean the UI is gone. | Role | Who | What they do | |---|---|---| | Operator | Calling agent (Claude Code, MCP client, orchestrator) | Discover, bind parameters, invoke, read outcomes | -| Authority | Named human | Demonstrate once, certify policy, resolve identity / effect / judgment halts | +| Authority | Named human | Admit the compiled program (watch if the agent clicked), certify policy, resolve identity / effect / judgment halts | | Auditor | Compliance | Sample seals, revoke admission | Computer-use agents are the user of OpenAdapt. They are not the executor -inside OpenAdapt. Never summarize halt as success. +inside OpenAdapt. Never summarize halt as success. A local agent may click +during the demonstration while the person watches. The calling agent must +not be the sole source of a production demonstration of a novel GUI path. Halt packets and typed agent-continue (missing parameter / retryable transport only) are not in this package yet. Identity, effect, expired diff --git a/llms.txt b/llms.txt index edabc22..aab5e9f 100644 --- a/llms.txt +++ b/llms.txt @@ -2,7 +2,7 @@ > OpenAdapt compiles demonstrated GUI workflows into programs. This package invokes them over MCP. -Default runtime interface for a calling agent. Computer-use agents are the user of OpenAdapt. They are not the executor inside it. Never summarize halt as success. Roles: operator (calling agent), authority (named human), auditor (samples seals). +Default runtime interface for a calling agent. Computer-use agents are the user of OpenAdapt. They are not the executor inside it. Never summarize halt as success. Roles: operator (calling agent), authority (named human admits; a local agent may click while they watch), auditor (samples seals). ## What it provides