Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .agents/skills/update-docs/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Start with these source-of-truth checks:
- Design invariants: `@onkernel/cua-ai` owns provider-specific policy (catalog, tool schemas, payload transforms); `@onkernel/cua-agent` is provider-neutral runtime glue around `pi-agent-core` (no provider names in `packages/agent/src`); every provider difference reaches the agent as data through `CuaRuntimeSpec`; `@onkernel/cua-cli` composes both for orchestration.
- Model layer: `packages/ai/src/index.ts`, `getCuaModel`/`listCuaModels`/`parseCuaModelRef`, `resolveCuaRuntimeSpec`, provider adapters, and `api-keys.ts`.
- Execution layer: `packages/agent/src/index.ts`, `CuaAgent` and `CuaAgentHarness` wiring, and the canonical CUA tool executors against `@onkernel/sdk`.
- CLI runtime flow: `packages/cua-cli/src/cli.ts`, `cli-harness.ts`, `harness.ts`, `harness-browser.ts`, `harness-models.ts`, `harness-sessions.ts`, `harness-named-sessions.ts`, `harness-skills.ts`, `print.ts`, `output/harness-jsonl.ts`, `action/`, and `tui/`.
- CLI runtime flow: `packages/cli/src/cli.ts`, `cli-harness.ts`, `harness.ts`, `harness-browser.ts`, `harness-models.ts`, `harness-sessions.ts`, `harness-named-sessions.ts`, `harness-skills.ts`, `print.ts`, `output/harness-jsonl.ts`, `action/`, and `tui/`.
- TUI test infrastructure: `packages/ptywright/package.json`, `src/index.ts`, `src/session.ts`, `src/terminal.ts`, and `README.md`.
- External drift: provider computer-use docs, `@earendil-works/pi-*` versions, and `@onkernel/sdk` versions in package manifests.

Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ All of them expect you to:
packages/
├── ai/ # @onkernel/cua-ai - CUA model catalog + tool schemas + provider adapters (on npm)
├── agent/ # @onkernel/cua-agent - CuaAgent/CuaAgentHarness Kernel-browser execution loop (on npm)
└── cua-cli/ # @onkernel/cua-cli - the `cua` binary; built on cua-agent + cua-ai
└── cli/ # @onkernel/cua-cli - the `cua` binary; built on cua-agent + cua-ai
```

**Building your own agent? Start here:** [`packages/agent`](packages/agent)
Expand Down Expand Up @@ -75,7 +75,7 @@ flowchart LR
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| [`@onkernel/cua-ai`](packages/ai) | Computer-use model catalog (`getCuaModel`/`listCuaModels`), canonical CUA tool schemas, and provider adapters/runtime specs built on pi-ai. On npm. |
| [`@onkernel/cua-agent`](packages/agent) | `CuaAgent`/`CuaAgentHarness` classes that execute cua-ai tool calls against a Kernel browser, screenshot loop included. On npm. |
| [`@onkernel/cua-cli`](packages/cua-cli) | The `cua` binary: argv parsing, sessions, skills, JSONL output, pi-tui front-end. |
| [`@onkernel/cua-cli`](packages/cli) | The `cua` binary: argv parsing, sessions, skills, JSONL output, pi-tui front-end. |

---

Expand Down Expand Up @@ -161,7 +161,7 @@ end-to-end flow.

## CLI reference

See [`packages/cua-cli/README.md`](packages/cua-cli/README.md) for the
See [`packages/cli/README.md`](packages/cli/README.md) for the
full CLI reference, env-var configuration, and model selection.

Highlights:
Expand Down Expand Up @@ -325,7 +325,7 @@ skills/
packages/
├── ai/ # @onkernel/cua-ai — model layer (see packages/ai/README.md)
├── agent/ # @onkernel/cua-agent — Kernel-browser execution layer (see packages/agent/README.md)
└── cua-cli/ # @onkernel/cua-cli — the `cua` binary (see packages/cua-cli/README.md)
└── cli/ # @onkernel/cua-cli — the `cua` binary (see packages/cli/README.md)
```

---
Expand Down
2 changes: 1 addition & 1 deletion bin/cua
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,4 @@
# Wrapper that runs the built cua CLI from this checkout.
# Symlink this file into ~/.local/bin/cua (or anywhere on $PATH) to use as `cua`.
DIR="$(cd "$(dirname "$0")/.." && pwd)"
exec node "$DIR/packages/cua-cli/dist/cli.js" "$@"
exec node "$DIR/packages/cli/dist/cli.js" "$@"
12 changes: 6 additions & 6 deletions docs/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -211,7 +211,7 @@ user prompt
└─► assistant text + harness events → TUI / stdout / JSONL
```

The CLI's `buildCuaHarness` in `packages/cua-cli/src/harness.ts`:
The CLI's `buildCuaHarness` in `packages/cli/src/harness.ts`:

1. Resolves the model via `getCuaModel(ref)` / `listCuaModels()` from
`@onkernel/cua-ai`.
Expand All @@ -232,9 +232,9 @@ The CLI's `buildCuaHarness` in `packages/cua-cli/src/harness.ts`:

```mermaid
flowchart LR
cli["cua-cli/src/cli.ts"]
cli --> harness["cua-cli/src/harness.ts (buildCuaHarness)"]
harness --> browserMod["cua-cli/src/harness-browser.ts"]
cli["cli/src/cli.ts"]
cli --> harness["cli/src/harness.ts (buildCuaHarness)"]
harness --> browserMod["cli/src/harness-browser.ts"]
browserMod --> sdk[("@onkernel/sdk")]
harness --> agentPkg["cua-agent: CuaAgentHarness"]
agentPkg --> piHarness["pi-agent-core AgentHarness"]
Expand All @@ -249,8 +249,8 @@ flowchart LR
harness --> coding["bash/read/edit/write/... (pi-coding-agent)"]
harness --> sessions["JsonlSessionRepo (re-exported from cua-agent)"]
harness --> skillsMod["loadSkills (re-exported from cua-agent)"]
cli --> tui["cua-cli/src/tui/main.ts (pi-tui)"]
cli --> jsonl["cua-cli/src/output/harness-jsonl.ts"]
cli --> tui["cli/src/tui/main.ts (pi-tui)"]
cli --> jsonl["cli/src/output/harness-jsonl.ts"]
pty["ptywright (dev/test only)"] --> tui
```

Expand Down
6 changes: 3 additions & 3 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
"packages/ai",
"packages/agent",
"packages/ptywright",
"packages/cua-cli"
"packages/cli"
],
"scripts": {
"build": "npm run build --workspace @onkernel/cua-ai && tsc -b && npm run build --workspace @onkernel/cua-agent && npm run build:native --workspace @onkernel/ptywright --if-present",
Expand Down
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
2 changes: 1 addition & 1 deletion tsconfig.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,6 @@
{ "path": "./packages/ai" },
{ "path": "./packages/agent" },
{ "path": "./packages/ptywright" },
{ "path": "./packages/cua-cli" }
{ "path": "./packages/cli" }
]
}
Loading