Consolidate official AI extensions under ext/ai/, add agent history/context host APIs, dynamic call_fn, and a first-pass TOOL:name loop so runbooks can list zero-arg tools in a table. Co-authored-by: Cursor <cursoragent@cursor.com>
62 lines
1.4 KiB
Markdown
62 lines
1.4 KiB
Markdown
# Official extension installer (`marqdo ext`)
|
|
|
|
| | |
|
|
|---|---|
|
|
| Status | **Accepted (v0.1)** |
|
|
| Date | 2026-08-06 |
|
|
| Related | [ext-llm.md](ext-llm.md) · [ext-agent.md](ext-agent.md) |
|
|
|
|
## Commands
|
|
|
|
```text
|
|
marqdo ext list
|
|
marqdo ext add llm
|
|
marqdo ext add agent
|
|
marqdo ext remove llm
|
|
marqdo ext remove agent
|
|
```
|
|
|
|
## Install root
|
|
|
|
1. `MARQDO_EXT` if set
|
|
2. Else `~/.marqdo/ext`
|
|
|
|
Imports use paths like `> ext/ai/llm.mq.md` (see [`load.rs`](../../src/load.rs)).
|
|
|
|
## Source for `add`
|
|
|
|
1. `MARQDO_EXT_SOURCE` — directory containing `ai/llm.mq.md` …
|
|
2. Else repo `./ext` near cwd / binary
|
|
|
|
## Layout (`ext/`)
|
|
|
|
Official extensions live under **`ext/ai/`** (LLM + agent framework only). Do not add flat `.mq.md` files at `ext/` root — keeps the tree from accumulating unrelated modules.
|
|
|
|
```text
|
|
ext/
|
|
ai/
|
|
llm.mq.md
|
|
大模型.mq.md
|
|
agent.mq.md
|
|
智能体.mq.md
|
|
```
|
|
|
|
Future optional ext domains get their own subdirs (e.g. `ext/foo/`), not mixed into `ai/`.
|
|
|
|
## Catalog
|
|
|
|
| Id | Installs under `MARQDO_EXT` |
|
|
|----|-----------------------------|
|
|
| `llm` | `ai/llm.mq.md`, `ai/大模型.mq.md` |
|
|
| `agent` | `ai/agent.mq.md`, `ai/智能体.mq.md` |
|
|
|
|
## Tests
|
|
|
|
`tests/gold.rs`: `ext_cli_add_list_remove_llm`, `ext_cli_add_agent`, `ext_agent_framework_smoke`, `ext_agent_run_live` (needs `tests/ext/.env`).
|
|
|
|
## Non-goals
|
|
|
|
- Third-party registry
|
|
- Merging into `lib/`
|
|
- Bundling domain/task helpers in official ext
|