moderado 0.3.0 → 0.3.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +182 -175
- package/dist/args.d.ts +1 -1
- package/dist/args.d.ts.map +1 -1
- package/dist/args.js +32 -28
- package/dist/args.js.map +1 -1
- package/dist/commands/chat.d.ts +1 -1
- package/dist/commands/chat.d.ts.map +1 -1
- package/dist/commands/chat.js +19 -0
- package/dist/commands/chat.js.map +1 -1
- package/dist/commands/run.d.ts.map +1 -1
- package/dist/commands/run.js +2 -0
- package/dist/commands/run.js.map +1 -1
- package/dist/commands/skills.d.ts +2 -0
- package/dist/commands/skills.d.ts.map +1 -0
- package/dist/commands/skills.js +13 -0
- package/dist/commands/skills.js.map +1 -0
- package/dist/config.js +1 -1
- package/dist/config.js.map +1 -1
- package/dist/index.js +4 -0
- package/dist/index.js.map +1 -1
- package/dist/skills.d.ts +23 -0
- package/dist/skills.d.ts.map +1 -0
- package/dist/skills.js +78 -0
- package/dist/skills.js.map +1 -0
- package/dist/ui/help_modal.d.ts.map +1 -1
- package/dist/ui/help_modal.js +1 -0
- package/dist/ui/help_modal.js.map +1 -1
- package/dist/ui/provider_connect.d.ts +2 -1
- package/dist/ui/provider_connect.d.ts.map +1 -1
- package/dist/ui/provider_connect.js +29 -7
- package/dist/ui/provider_connect.js.map +1 -1
- package/dist/ui/welcome.d.ts.map +1 -1
- package/dist/ui/welcome.js +2 -0
- package/dist/ui/welcome.js.map +1 -1
- package/dist/vendor/core/agent.d.ts +3 -1
- package/dist/vendor/core/agent.d.ts.map +1 -1
- package/dist/vendor/core/agent.js +26 -26
- package/dist/vendor/core/agent.js.map +1 -1
- package/dist/vendor/providers/model_discovery.d.ts +4 -0
- package/dist/vendor/providers/model_discovery.d.ts.map +1 -1
- package/dist/vendor/providers/model_discovery.js +4 -0
- package/dist/vendor/providers/model_discovery.js.map +1 -1
- package/package.json +2 -2
- package/dist/ui/session_screen.d.ts +0 -32
- package/dist/ui/session_screen.d.ts.map +0 -1
- package/dist/ui/session_screen.js +0 -148
- package/dist/ui/session_screen.js.map +0 -1
- package/dist/ui/session_terminal.d.ts +0 -46
- package/dist/ui/session_terminal.d.ts.map +0 -1
- package/dist/ui/session_terminal.js +0 -342
- package/dist/ui/session_terminal.js.map +0 -1
package/README.md
CHANGED
|
@@ -1,95 +1,102 @@
|
|
|
1
|
-
# Moderado
|
|
2
|
-
|
|
3
|
-
> **A lightweight, provider-independent CLI coding agent with dynamic NVIDIA NIM discovery, free-first AUTO routing, and an uncompromised human-in-the-loop approval boundary.**
|
|
4
|
-
|
|
5
|
-
[](file:///d:/projects/moderado/LICENSE)
|
|
7
|
-
[](https://github.com/marcuz-apl/alfazen-skills)
|
|
8
|
-
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
## Highlights
|
|
12
|
-
|
|
13
|
-
- **Clean-Room & Original**: Built from scratch in TypeScript on Node.js (>= 20 LTS). No code copied from Cline, OpenCode, or legacy wrappers.
|
|
14
|
-
- **Provider-Independent Core**: Core agent loops, tool dispatching, and routing depend on pure contracts (`packages/contracts`) using Dependency Injection.
|
|
15
|
-
- **Dynamic NVIDIA Discovery**: Queries live `/v1/models` from NVIDIA NIM hosted catalog or local NIM instances; never relies on stale static lists.
|
|
16
|
-
- **Free-First AUTO Routing**: Intelligently ranks and selects verified free/trial tool-capable models before any paid endpoints. Paid models and unverified pricing require explicit user opt-in.
|
|
17
|
-
- **Strict Approval Boundary**: Auto-approved reads; interactive human approval for file writes, edits, and command executions. Non-interactive sessions fail closed.
|
|
18
|
-
- **Minimalist & Bloat-Free (`ponytail`)**: Follows the Decision Ladder: YAGNI, standard library first (native Node `fetch`, `AbortController`, `child_process.spawn`), and zero unnecessary dependencies.
|
|
19
|
-
- **Alfazen Versioning (`versioning-alfazen`)**: SemVer 2.0.0 with high-traceability connected UTC build prefixes (`v<m.n.p>+<yymmddc>`) and mandatory owner advisory gates for major releases.
|
|
20
|
-
|
|
21
|
-
---
|
|
22
|
-
|
|
23
|
-
## Documentation Index
|
|
24
|
-
|
|
25
|
-
| Document | Purpose |
|
|
26
|
-
|---|---|
|
|
27
|
-
| [**PRD.md**](file:///d:/projects/moderado/PRD.md) | **Product Requirements Document**: Personas, requirements, CLI specs, and acceptance criteria |
|
|
28
|
-
| [**AGENTS.md**](file:///d:/projects/moderado/AGENTS.md) | **Agent Operational Manual**: Rules of engagement, Ponytail Decision Ladder, and subagent patterns |
|
|
29
|
-
| [**docs/ARCHITECTURE.md**](file:///d:/projects/moderado/docs/ARCHITECTURE.md) | **System Architecture**: Workspaces, Dependency Injection, state machines, and event streams |
|
|
30
|
-
| [**docs/TOOLS.md**](file:///d:/projects/moderado/docs/TOOLS.md) | **Tool Specifications**: Schemas, limits, atomic writes, and validation rules for the 7 tools |
|
|
31
|
-
| [**docs/ROUTING.md**](file:///d:/projects/moderado/docs/ROUTING.md) | **Discovery & Routing**: Classification taxonomy, AUTO selection algorithm, and retry/fallback cascades |
|
|
32
|
-
| [**docs/SECURITY.md**](file:///d:/projects/moderado/docs/SECURITY.md) | **Security Model**: Workspace jail, `shell: false` isolation, environment cleansing, and injection defense |
|
|
33
|
-
| [**HANDOFF.md**](file:///d:/projects/moderado/HANDOFF.md) | **Project Handoff Snapshot**: Real-time status, decisions, blockers, and next implementation milestones |
|
|
34
|
-
|
|
35
|
-
---
|
|
36
|
-
|
|
37
|
-
## Workspace Layout
|
|
38
|
-
|
|
39
|
-
Moderado is organized as an npm workspace:
|
|
40
|
-
|
|
41
|
-
```text
|
|
42
|
-
moderado/
|
|
43
|
-
├── apps/
|
|
44
|
-
│ └── cli/ # v0.1 CLI application and terminal event rendering
|
|
45
|
-
├── packages/
|
|
46
|
-
│ ├── contracts/ # Pure TypeScript interfaces, Zod schemas, events
|
|
47
|
-
│ ├── core/ # Agent loop, routing policy, session state machine
|
|
48
|
-
│ ├── providers/ # NVIDIA NIM HTTP adapter and mock/fake providers
|
|
49
|
-
│ └── tools/ # Workspace file jail and process execution engine
|
|
50
|
-
├── tests/ # Cross-package and CLI integration tests
|
|
51
|
-
├── docs/ # Architectural and subsystem specifications
|
|
52
|
-
├── VERSION # Alfazen connected version identifier
|
|
53
|
-
├── PRD.md # Product requirements document
|
|
54
|
-
├── AGENTS.md # Agent operational guide
|
|
55
|
-
└── HANDOFF.md # Resumption and state ledger
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
---
|
|
59
|
-
|
|
60
|
-
## CLI Command Quick Reference
|
|
61
|
-
|
|
62
|
-
```bash
|
|
63
|
-
# Discover live models and display access/capability classifications
|
|
64
|
-
moderado models
|
|
65
|
-
|
|
66
|
-
# Run a bounded coding task in the current workspace (default AUTO routing)
|
|
67
|
-
moderado run "Add unit tests for user authentication"
|
|
68
|
-
|
|
69
|
-
# Pin a specific model (disables fallback)
|
|
70
|
-
moderado run "Refactor database client" --model meta/llama-3.3-70b-instruct
|
|
71
|
-
|
|
72
|
-
# Run against a local NIM container
|
|
73
|
-
moderado run "Audit codebase" --profile local-nim
|
|
74
|
-
|
|
75
|
-
# Run in read-only audit mode (denies all writes and commands)
|
|
76
|
-
moderado run "Analyze security boundaries" --read-only
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
---
|
|
80
|
-
|
|
1
|
+
# Moderado
|
|
2
|
+
|
|
3
|
+
> **A lightweight, provider-independent CLI coding agent with dynamic NVIDIA NIM discovery, free-first AUTO routing, and an uncompromised human-in-the-loop approval boundary.**
|
|
4
|
+
|
|
5
|
+
[](file:///d:/projects/moderado/VERSION)
|
|
6
|
+
[](file:///d:/projects/moderado/LICENSE)
|
|
7
|
+
[](https://github.com/marcuz-apl/alfazen-skills)
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## Highlights
|
|
12
|
+
|
|
13
|
+
- **Clean-Room & Original**: Built from scratch in TypeScript on Node.js (>= 20 LTS). No code copied from Cline, OpenCode, or legacy wrappers.
|
|
14
|
+
- **Provider-Independent Core**: Core agent loops, tool dispatching, and routing depend on pure contracts (`packages/contracts`) using Dependency Injection.
|
|
15
|
+
- **Dynamic NVIDIA Discovery**: Queries live `/v1/models` from NVIDIA NIM hosted catalog or local NIM instances; never relies on stale static lists.
|
|
16
|
+
- **Free-First AUTO Routing**: Intelligently ranks and selects verified free/trial tool-capable models before any paid endpoints. Paid models and unverified pricing require explicit user opt-in.
|
|
17
|
+
- **Strict Approval Boundary**: Auto-approved reads; interactive human approval for file writes, edits, and command executions. Non-interactive sessions fail closed.
|
|
18
|
+
- **Minimalist & Bloat-Free (`ponytail`)**: Follows the Decision Ladder: YAGNI, standard library first (native Node `fetch`, `AbortController`, `child_process.spawn`), and zero unnecessary dependencies.
|
|
19
|
+
- **Alfazen Versioning (`versioning-alfazen`)**: SemVer 2.0.0 with high-traceability connected UTC build prefixes (`v<m.n.p>+<yymmddc>`) and mandatory owner advisory gates for major releases.
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Documentation Index
|
|
24
|
+
|
|
25
|
+
| Document | Purpose |
|
|
26
|
+
|---|---|
|
|
27
|
+
| [**PRD.md**](file:///d:/projects/moderado/PRD.md) | **Product Requirements Document**: Personas, requirements, CLI specs, and acceptance criteria |
|
|
28
|
+
| [**AGENTS.md**](file:///d:/projects/moderado/AGENTS.md) | **Agent Operational Manual**: Rules of engagement, Ponytail Decision Ladder, and subagent patterns |
|
|
29
|
+
| [**docs/ARCHITECTURE.md**](file:///d:/projects/moderado/docs/ARCHITECTURE.md) | **System Architecture**: Workspaces, Dependency Injection, state machines, and event streams |
|
|
30
|
+
| [**docs/TOOLS.md**](file:///d:/projects/moderado/docs/TOOLS.md) | **Tool Specifications**: Schemas, limits, atomic writes, and validation rules for the 7 tools |
|
|
31
|
+
| [**docs/ROUTING.md**](file:///d:/projects/moderado/docs/ROUTING.md) | **Discovery & Routing**: Classification taxonomy, AUTO selection algorithm, and retry/fallback cascades |
|
|
32
|
+
| [**docs/SECURITY.md**](file:///d:/projects/moderado/docs/SECURITY.md) | **Security Model**: Workspace jail, `shell: false` isolation, environment cleansing, and injection defense |
|
|
33
|
+
| [**HANDOFF.md**](file:///d:/projects/moderado/HANDOFF.md) | **Project Handoff Snapshot**: Real-time status, decisions, blockers, and next implementation milestones |
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Workspace Layout
|
|
38
|
+
|
|
39
|
+
Moderado is organized as an npm workspace:
|
|
40
|
+
|
|
41
|
+
```text
|
|
42
|
+
moderado/
|
|
43
|
+
├── apps/
|
|
44
|
+
│ └── cli/ # v0.1 CLI application and terminal event rendering
|
|
45
|
+
├── packages/
|
|
46
|
+
│ ├── contracts/ # Pure TypeScript interfaces, Zod schemas, events
|
|
47
|
+
│ ├── core/ # Agent loop, routing policy, session state machine
|
|
48
|
+
│ ├── providers/ # NVIDIA NIM HTTP adapter and mock/fake providers
|
|
49
|
+
│ └── tools/ # Workspace file jail and process execution engine
|
|
50
|
+
├── tests/ # Cross-package and CLI integration tests
|
|
51
|
+
├── docs/ # Architectural and subsystem specifications
|
|
52
|
+
├── VERSION # Alfazen connected version identifier
|
|
53
|
+
├── PRD.md # Product requirements document
|
|
54
|
+
├── AGENTS.md # Agent operational guide
|
|
55
|
+
└── HANDOFF.md # Resumption and state ledger
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## CLI Command Quick Reference
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
# Discover live models and display access/capability classifications
|
|
64
|
+
moderado models
|
|
65
|
+
|
|
66
|
+
# Run a bounded coding task in the current workspace (default AUTO routing)
|
|
67
|
+
moderado run "Add unit tests for user authentication"
|
|
68
|
+
|
|
69
|
+
# Pin a specific model (disables fallback)
|
|
70
|
+
moderado run "Refactor database client" --model meta/llama-3.3-70b-instruct
|
|
71
|
+
|
|
72
|
+
# Run against a local NIM container
|
|
73
|
+
moderado run "Audit codebase" --profile local-nim
|
|
74
|
+
|
|
75
|
+
# Run in read-only audit mode (denies all writes and commands)
|
|
76
|
+
moderado run "Analyze security boundaries" --read-only
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
81
|
## Install Moderado
|
|
82
82
|
|
|
83
|
-
Moderado requires **Node.js 20 or newer**.
|
|
84
|
-
but does not publish a public npm release yet. Once a release is published,
|
|
85
|
-
the global install command will be:
|
|
83
|
+
Moderado requires **Node.js 20 or newer**.
|
|
86
84
|
|
|
87
85
|
```bash
|
|
88
86
|
npm install -g moderado
|
|
89
|
-
moderado
|
|
87
|
+
moderado --help
|
|
90
88
|
```
|
|
91
89
|
|
|
92
|
-
|
|
90
|
+
moderado@0.3.0 is live on the public npm registry (latest tag points at 0.3.0).
|
|
91
|
+
Any npm-compatible installer works (bun add -g moderado,
|
|
92
|
+
pnpm add -g moderado, npx -y moderado@latest --help), and prebuilt
|
|
93
|
+
dependency-free binaries (moderado-win-x64.exe, moderado-macos-arm64,
|
|
94
|
+
moderado-linux-x64) are attached to the
|
|
95
|
+
GitHub Release v0.3.0 at https://github.com/marcuz-apl/moderado/releases/tag/v0.3.0.
|
|
96
|
+
The curl installer (`scripts/install.sh`, Linux x64 + macOS arm64), the
|
|
97
|
+
Homebrew tap, and the Scoop bucket are available; the winget and AUR
|
|
98
|
+
submissions are pending. See docs/DISTRIBUTION.md in the repository.
|
|
99
|
+
To build from source instead:
|
|
93
100
|
|
|
94
101
|
```bash
|
|
95
102
|
git clone https://github.com/marcuz-apl/moderado.git
|
|
@@ -115,94 +122,94 @@ platforms, use an environment variable such as `NVIDIA_API_KEY` or
|
|
|
115
122
|
Run `moderado doctor` to inspect local setup without exposing secrets. Add
|
|
116
123
|
`--connectivity` only when you want an optional live model-catalog check.
|
|
117
124
|
`npm test` never performs live provider calls.
|
|
118
|
-
## Getting Started & Development
|
|
119
|
-
|
|
120
|
-
### Connect a provider in the TUI
|
|
121
|
-
|
|
122
|
-
Run `moderado` to open the TUI immediately. A fresh installation does not require
|
|
123
|
-
an API key or a preselected model. The welcome card shows **No model connected —
|
|
124
|
-
use `/connect`** until you add one.
|
|
125
|
-
|
|
126
|
-
Use `/connect` to add NVIDIA NIM. NVIDIA NIM starts with `AUTO` free-first
|
|
127
|
-
routing, so choosing a model is optional; use `/model` later to pin one. Obtain
|
|
128
|
-
an NVIDIA key from [build.nvidia.com](https://build.nvidia.com), or set it as
|
|
129
|
-
`NVIDIA_API_KEY` before launching Moderado.
|
|
130
|
-
|
|
131
|
-
### Sessions and usage
|
|
132
|
-
|
|
133
|
-
Moderado stores sessions per workspace in `~/.moderado/sessions/`. Use
|
|
134
|
-
`/session` to create, resume, export, or compact a local conversation. Session
|
|
135
|
-
exports redact recognized API-key prefixes. The status line uses only
|
|
136
|
-
provider-reported token usage. It shows the calculated cost when the selected
|
|
137
|
-
model exposes prompt and completion prices, and **Cost unknown** otherwise.
|
|
138
|
-
|
|
139
|
-
`/connect` also accepts an OpenAI-compatible base URL, API key, and explicit
|
|
140
|
-
model ID for providers such as OpenRouter, Z.AI, DeepSeek, Moonshot, and
|
|
141
|
-
Mistral. Compatibility depends on each provider supporting `/v1/models` and
|
|
142
|
-
streaming `/v1/chat/completions` with tool calls. Provider credentials are saved
|
|
143
|
-
in `~/.moderado/config.json`; protect that file and never commit it.
|
|
144
|
-
|
|
145
|
-
### 1. Build & Test
|
|
146
|
-
```bash
|
|
147
|
-
# Install workspace dependencies
|
|
148
|
-
npm install
|
|
149
|
-
|
|
150
|
-
# Build all packages via TypeScript project references
|
|
151
|
-
npm run build
|
|
152
|
-
|
|
153
|
-
# Run full automated test suite (100% offline, zero API keys required)
|
|
154
|
-
npm test
|
|
155
|
-
```
|
|
156
|
-
|
|
157
|
-
### 2. Manual Live Smoke Test (Optional)
|
|
158
|
-
To test live model discovery and chat against NVIDIA NIM with real credentials:
|
|
159
|
-
```bash
|
|
160
|
-
# PowerShell
|
|
161
|
-
$env:NVIDIA_API_KEY="nvapi-..."
|
|
162
|
-
node scripts/smoke_test.js
|
|
163
|
-
|
|
164
|
-
# POSIX (bash/zsh)
|
|
165
|
-
export NVIDIA_API_KEY="nvapi-..."
|
|
166
|
-
node scripts/smoke_test.js
|
|
167
|
-
```
|
|
168
|
-
|
|
169
|
-
---
|
|
170
|
-
|
|
171
|
-
## License
|
|
172
|
-
|
|
173
|
-
This project is licensed under the MIT License.
|
|
174
|
-
*NVIDIA NIM, NGC, and model weights/APIs are subject to their respective terms and licenses. Moderado is independent and not endorsed by NVIDIA.*
|
|
175
|
-
|
|
176
|
-
### Practical coding workflow
|
|
177
|
-
|
|
178
|
-
Use `/workflow` from the TUI to work through a change safely:
|
|
179
|
-
|
|
180
|
-
- **Git status** shows the current branch and changed files without using a shell.
|
|
181
|
-
- **Review diff** shows the bounded working-tree diff.
|
|
182
|
-
- In **Plan** mode, Moderado asks the model for a concise checklist and cannot make workspace changes. Choose **Build plan** and confirm to send that checklist to Execute mode.
|
|
183
|
-
- File writes, exact edits, and multi-file patches show their change preview and still require approval. Moderado records a byte-preserving checkpoint immediately before an approved file mutation.
|
|
184
|
-
- **Undo latest agent change** requires its own approval. It restores the latest completed checkpoint from `~/.moderado/checkpoints/` only when every affected file still has the expected post-change digest. If a file changed externally, it reports the conflict and restores nothing.
|
|
185
|
-
|
|
186
|
-
### Diagnostics evidence
|
|
187
|
-
|
|
188
|
-
Ask Moderado to run diagnostics, typecheck, lint, or tests in a TypeScript or JavaScript workspace. It may run only the direct `typecheck`, `lint`, or `test` script defined in that workspace�s `package.json`, and every run requires approval. A non-zero exit returns parsed TypeScript errors as repair evidence; it does not bypass the safety boundary.
|
|
189
|
-
|
|
190
|
-
### TypeScript language intelligence
|
|
191
|
-
|
|
192
|
-
Install `typescript-language-server` yourself, then set `typescriptLanguageServer` in `~/.moderado/config.json` to its executable path. Moderado can then use read-only definition and reference lookup for TypeScript/JavaScript files. When the executable is unavailable, it reports how to configure it and leaves normal tools available.
|
|
193
|
-
|
|
194
|
-
### Local MCP tools
|
|
195
|
-
|
|
196
|
-
Configure trusted local stdio MCP servers under `mcpServers` in `~/.moderado/config.json`, with an executable and fixed `args` list. Moderado discovers server tools at session startup, namespaces them as `mcp.<server>.<tool>`, and requires approval for every call. MCP network transports and automatic server installation are not supported.
|
|
197
|
-
|
|
198
|
-
### Host event protocol
|
|
199
|
-
|
|
200
|
-
Moderado exposes a versioned host-event envelope with session identity and monotonic sequence numbers. The CLI continues to render the contained agent event, while a future desktop host can consume the same protocol without importing CLI code.
|
|
201
|
-
|
|
202
|
-
### Doctor command
|
|
203
|
-
|
|
204
|
-
Run `moderado doctor` to check the local Node runtime, workspace, Moderado home directory, provider/key presence, Git, and npm without exposing credentials. Run `moderado doctor --connectivity` only when you want an explicit live provider catalog check.
|
|
205
|
-
|
|
206
|
-
## Windows credential storage
|
|
207
|
-
|
|
125
|
+
## Getting Started & Development
|
|
126
|
+
|
|
127
|
+
### Connect a provider in the TUI
|
|
128
|
+
|
|
129
|
+
Run `moderado` to open the TUI immediately. A fresh installation does not require
|
|
130
|
+
an API key or a preselected model. The welcome card shows **No model connected —
|
|
131
|
+
use `/connect`** until you add one.
|
|
132
|
+
|
|
133
|
+
Use `/connect` to add NVIDIA NIM. NVIDIA NIM starts with `AUTO` free-first
|
|
134
|
+
routing, so choosing a model is optional; use `/model` later to pin one. Obtain
|
|
135
|
+
an NVIDIA key from [build.nvidia.com](https://build.nvidia.com), or set it as
|
|
136
|
+
`NVIDIA_API_KEY` before launching Moderado.
|
|
137
|
+
|
|
138
|
+
### Sessions and usage
|
|
139
|
+
|
|
140
|
+
Moderado stores sessions per workspace in `~/.moderado/sessions/`. Use
|
|
141
|
+
`/session` to create, resume, export, or compact a local conversation. Session
|
|
142
|
+
exports redact recognized API-key prefixes. The status line uses only
|
|
143
|
+
provider-reported token usage. It shows the calculated cost when the selected
|
|
144
|
+
model exposes prompt and completion prices, and **Cost unknown** otherwise.
|
|
145
|
+
|
|
146
|
+
`/connect` also accepts an OpenAI-compatible base URL, API key, and explicit
|
|
147
|
+
model ID for providers such as OpenRouter, Z.AI, DeepSeek, Moonshot, and
|
|
148
|
+
Mistral. Compatibility depends on each provider supporting `/v1/models` and
|
|
149
|
+
streaming `/v1/chat/completions` with tool calls. Provider credentials are saved
|
|
150
|
+
in `~/.moderado/config.json`; protect that file and never commit it.
|
|
151
|
+
|
|
152
|
+
### 1. Build & Test
|
|
153
|
+
```bash
|
|
154
|
+
# Install workspace dependencies
|
|
155
|
+
npm install
|
|
156
|
+
|
|
157
|
+
# Build all packages via TypeScript project references
|
|
158
|
+
npm run build
|
|
159
|
+
|
|
160
|
+
# Run full automated test suite (100% offline, zero API keys required)
|
|
161
|
+
npm test
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
### 2. Manual Live Smoke Test (Optional)
|
|
165
|
+
To test live model discovery and chat against NVIDIA NIM with real credentials:
|
|
166
|
+
```bash
|
|
167
|
+
# PowerShell
|
|
168
|
+
$env:NVIDIA_API_KEY="nvapi-..."
|
|
169
|
+
node scripts/smoke_test.js
|
|
170
|
+
|
|
171
|
+
# POSIX (bash/zsh)
|
|
172
|
+
export NVIDIA_API_KEY="nvapi-..."
|
|
173
|
+
node scripts/smoke_test.js
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
## License
|
|
179
|
+
|
|
180
|
+
This project is licensed under the MIT License.
|
|
181
|
+
*NVIDIA NIM, NGC, and model weights/APIs are subject to their respective terms and licenses. Moderado is independent and not endorsed by NVIDIA.*
|
|
182
|
+
|
|
183
|
+
### Practical coding workflow
|
|
184
|
+
|
|
185
|
+
Use `/workflow` from the TUI to work through a change safely:
|
|
186
|
+
|
|
187
|
+
- **Git status** shows the current branch and changed files without using a shell.
|
|
188
|
+
- **Review diff** shows the bounded working-tree diff.
|
|
189
|
+
- In **Plan** mode, Moderado asks the model for a concise checklist and cannot make workspace changes. Choose **Build plan** and confirm to send that checklist to Execute mode.
|
|
190
|
+
- File writes, exact edits, and multi-file patches show their change preview and still require approval. Moderado records a byte-preserving checkpoint immediately before an approved file mutation.
|
|
191
|
+
- **Undo latest agent change** requires its own approval. It restores the latest completed checkpoint from `~/.moderado/checkpoints/` only when every affected file still has the expected post-change digest. If a file changed externally, it reports the conflict and restores nothing.
|
|
192
|
+
|
|
193
|
+
### Diagnostics evidence
|
|
194
|
+
|
|
195
|
+
Ask Moderado to run diagnostics, typecheck, lint, or tests in a TypeScript or JavaScript workspace. It may run only the direct `typecheck`, `lint`, or `test` script defined in that workspace�s `package.json`, and every run requires approval. A non-zero exit returns parsed TypeScript errors as repair evidence; it does not bypass the safety boundary.
|
|
196
|
+
|
|
197
|
+
### TypeScript language intelligence
|
|
198
|
+
|
|
199
|
+
Install `typescript-language-server` yourself, then set `typescriptLanguageServer` in `~/.moderado/config.json` to its executable path. Moderado can then use read-only definition and reference lookup for TypeScript/JavaScript files. When the executable is unavailable, it reports how to configure it and leaves normal tools available.
|
|
200
|
+
|
|
201
|
+
### Local MCP tools
|
|
202
|
+
|
|
203
|
+
Configure trusted local stdio MCP servers under `mcpServers` in `~/.moderado/config.json`, with an executable and fixed `args` list. Moderado discovers server tools at session startup, namespaces them as `mcp.<server>.<tool>`, and requires approval for every call. MCP network transports and automatic server installation are not supported.
|
|
204
|
+
|
|
205
|
+
### Host event protocol
|
|
206
|
+
|
|
207
|
+
Moderado exposes a versioned host-event envelope with session identity and monotonic sequence numbers. The CLI continues to render the contained agent event, while a future desktop host can consume the same protocol without importing CLI code.
|
|
208
|
+
|
|
209
|
+
### Doctor command
|
|
210
|
+
|
|
211
|
+
Run `moderado doctor` to check the local Node runtime, workspace, Moderado home directory, provider/key presence, Git, and npm without exposing credentials. Run `moderado doctor --connectivity` only when you want an explicit live provider catalog check.
|
|
212
|
+
|
|
213
|
+
## Windows credential storage
|
|
214
|
+
|
|
208
215
|
On Windows, /connect saves provider API keys in Windows Credential Manager and stores only a provider credential reference in ~/.moderado/config.json. Existing plaintext keys remain usable for compatibility. Migrate them explicitly with moderado doctor --migrate-credentials; a failed migration leaves the existing configuration unchanged. On other platforms, set the provider environment variable (for example, NVIDIA_API_KEY or OPENROUTER_API_KEY).
|
package/dist/args.d.ts
CHANGED
package/dist/args.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;
|
|
1
|
+
{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,aAAa,CA0ElF;AAED,wBAAgB,WAAW,IAAI,MAAM,CA+BpC"}
|
package/dist/args.js
CHANGED
|
@@ -34,6 +34,9 @@ export function parseCliArgs(args = process.argv.slice(2)) {
|
|
|
34
34
|
if (first === 'doctor') {
|
|
35
35
|
command = 'doctor';
|
|
36
36
|
}
|
|
37
|
+
else if (first === 'skills') {
|
|
38
|
+
command = 'skills';
|
|
39
|
+
}
|
|
37
40
|
else if (first === 'models') {
|
|
38
41
|
command = 'models';
|
|
39
42
|
}
|
|
@@ -75,34 +78,35 @@ export function parseCliArgs(args = process.argv.slice(2)) {
|
|
|
75
78
|
};
|
|
76
79
|
}
|
|
77
80
|
export function getHelpText() {
|
|
78
|
-
return `Moderado - Lightweight CLI coding agent with NVIDIA NIM discovery and free-first routing.
|
|
79
|
-
|
|
80
|
-
USAGE:
|
|
81
|
-
moderado models [options]
|
|
82
|
-
moderado run "<task>" [options]
|
|
83
|
-
moderado "<task>" [options]
|
|
84
|
-
|
|
85
|
-
COMMANDS:
|
|
86
|
-
models Discover live models, capability & access tiers
|
|
87
|
-
run "<task>" Execute a bounded coding task in the workspace\n
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
-
|
|
92
|
-
-
|
|
93
|
-
|
|
94
|
-
--max-
|
|
95
|
-
--
|
|
96
|
-
--
|
|
97
|
-
-
|
|
98
|
-
--
|
|
99
|
-
--
|
|
100
|
-
--allow-
|
|
101
|
-
--
|
|
102
|
-
--
|
|
103
|
-
--
|
|
104
|
-
-
|
|
105
|
-
-
|
|
81
|
+
return `Moderado - Lightweight CLI coding agent with NVIDIA NIM discovery and free-first routing.
|
|
82
|
+
|
|
83
|
+
USAGE:
|
|
84
|
+
moderado models [options]
|
|
85
|
+
moderado run "<task>" [options]
|
|
86
|
+
moderado "<task>" [options]
|
|
87
|
+
|
|
88
|
+
COMMANDS:
|
|
89
|
+
models Discover live models, capability & access tiers
|
|
90
|
+
run "<task>" Execute a bounded coding task in the workspace\n skills List installed user skills
|
|
91
|
+
doctor Check local Moderado setup
|
|
92
|
+
|
|
93
|
+
OPTIONS:
|
|
94
|
+
-w, --workspace <path> Target workspace directory (default: current directory)
|
|
95
|
+
-m, --model <id> Pin a specific model (disables AUTO fallback)
|
|
96
|
+
-p, --profile <name> Target configured profile (default: hosted-nvidia)
|
|
97
|
+
--max-steps <int> Upper bound on tool interaction cycles (default: 25)
|
|
98
|
+
--max-tokens <int> Hard limit on generated output tokens per response (default: 1024)
|
|
99
|
+
--timeout <seconds> Global session execution timeout (default: 600s)
|
|
100
|
+
--read-only Enforce read-only mode (blocks writes & commands)
|
|
101
|
+
-y, --auto-approve Automatically approve all tool operations
|
|
102
|
+
--non-interactive Fail closed on operations requiring approval
|
|
103
|
+
--allow-paid Permit paid models during AUTO routing
|
|
104
|
+
--allow-unknown Permit unverified/unknown access models in AUTO
|
|
105
|
+
--verbose Display raw tool inputs and event logs
|
|
106
|
+
--json Output results in structured JSON (models command)
|
|
107
|
+
--migrate-credentials Move legacy Windows config keys into Credential Manager
|
|
108
|
+
-h, --help Show this help screen
|
|
109
|
+
-v, --version Show version identifier
|
|
106
110
|
`;
|
|
107
111
|
}
|
|
108
112
|
//# sourceMappingURL=args.js.map
|
package/dist/args.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AA0BtC,MAAM,UAAU,YAAY,CAAC,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,MAAM,aAAa,GAAG;QACpB,SAAS,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE;QAChE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,KAAK,EAAE,GAAG,EAAE;QAC9C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;QACrC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE;QAC1E,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,OAAO,EAAE,IAAI,EAAE;QACvD,YAAY,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;QACzC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,OAAO,EAAE,KAAK,EAAE;QACpD,WAAW,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,OAAO,EAAE,KAAK,EAAE;QACzD,cAAc,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;QACxE,iBAAiB,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,OAAO,EAAE,KAAK,EAAE;QAC/D,YAAY,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,OAAO,EAAE,KAAK,EAAE;QAC1D,eAAe,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,OAAO,EAAE,KAAK,EAAE;QAC7D,OAAO,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,OAAO,EAAE,KAAK,EAAE;QACrD,IAAI,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,OAAO,EAAE,KAAK,EAAE;QAClD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,OAAO,EAAE,KAAK,EAAE;QACrD,YAAY,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,OAAO,EAAE,KAAK,EAAE;QAC1D,qBAAqB,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,OAAO,EAAE,KAAK,EAAE;QACnE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;QAC9D,OAAO,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;KAClE,CAAC;IAEF,MAAM,MAAM,GAAG,SAAS,CAAC;QACvB,IAAI;QACJ,OAAO,EAAE,aAAa;QACtB,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACvC,IAAI,
|
|
1
|
+
{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}
|
package/dist/commands/chat.d.ts
CHANGED
|
@@ -6,7 +6,7 @@ import { CliParsedArgs } from '../args.js';
|
|
|
6
6
|
import { ModeradoConfig } from '../config.js';
|
|
7
7
|
import { selectConfirmPopup, selectListPopup } from '../ui/popup.js';
|
|
8
8
|
export declare function createAgentTask(request: string, mode: 'Plan' | 'Execute'): string;
|
|
9
|
-
export declare const STANDARD_SLASH_COMMANDS: readonly ["/connect", "/model", "/init", "/btw", "/mcp", "/session", "/queue", "/workflow", "/clear", "/help", "/exit", "/quit"];
|
|
9
|
+
export declare const STANDARD_SLASH_COMMANDS: readonly ["/connect", "/model", "/init", "/btw", "/mcp", "/session", "/queue", "/workflow", "/skills", "/clear", "/help", "/exit", "/quit"];
|
|
10
10
|
export declare function levenshteinDistance(a: string, b: string): number;
|
|
11
11
|
export interface SlashCommandAdvice {
|
|
12
12
|
isSlashCommand: boolean;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAoF,kBAAkB,EAA0D,MAAM,iBAAiB,CAAC;AAC/L,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAoB,aAAa,EAAE,eAAe,EAAyB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC1K,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAmC,cAAc,EAAkK,MAAM,cAAc,CAAC;AAW/O,OAAO,EAAkC,kBAAkB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;
|
|
1
|
+
{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"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"}
|
package/dist/commands/chat.js
CHANGED
|
@@ -19,6 +19,7 @@ import { layerPromptBox, renderBoxLines, selectConfirmPopup, selectListPopup } f
|
|
|
19
19
|
import { askModalChoice } from '../ui/prompt.js';
|
|
20
20
|
import { findModelPricing } from '../model_pricing.js';
|
|
21
21
|
import { inspectGitWorkspace, readGitDiff } from '../vendor/tools/index.js';
|
|
22
|
+
import { discoverSkills, formatSkillContext } from '../skills.js';
|
|
22
23
|
function mutationPaths(toolName, parameters) {
|
|
23
24
|
const value = parameters;
|
|
24
25
|
if (toolName === 'apply_patch' && Array.isArray(value.edits)) {
|
|
@@ -40,6 +41,7 @@ export const STANDARD_SLASH_COMMANDS = [
|
|
|
40
41
|
'/session',
|
|
41
42
|
'/queue',
|
|
42
43
|
'/workflow',
|
|
44
|
+
'/skills',
|
|
43
45
|
'/clear',
|
|
44
46
|
'/help',
|
|
45
47
|
'/exit',
|
|
@@ -709,6 +711,8 @@ export async function handleChatSession(args, version, signal) {
|
|
|
709
711
|
if (config.typescriptLanguageServer)
|
|
710
712
|
process.env.MODERADO_TYPESCRIPT_LANGUAGE_SERVER = config.typescriptLanguageServer;
|
|
711
713
|
let tools = createDefaultToolRegistry();
|
|
714
|
+
let skills = discoverSkills();
|
|
715
|
+
const skillContext = () => formatSkillContext(skills);
|
|
712
716
|
const reloadMcpTools = async () => {
|
|
713
717
|
config = loadConfig();
|
|
714
718
|
tools = await createMcpToolRegistry(config.mcpServers, resolveWebSearchOptions(config));
|
|
@@ -1093,6 +1097,19 @@ export async function handleChatSession(args, version, signal) {
|
|
|
1093
1097
|
process.stdout.write(renderChatComposerCursor({ width: process.stdout.columns }, 0));
|
|
1094
1098
|
continue;
|
|
1095
1099
|
}
|
|
1100
|
+
if (trimmed === '/skills' || trimmed.startsWith('/skills ')) {
|
|
1101
|
+
skills = discoverSkills();
|
|
1102
|
+
lastQuestion = trimmed;
|
|
1103
|
+
lastAnswer = skills.length
|
|
1104
|
+
? 'User skills loaded:\n' + skills.map((skill) => ` ${skill.name} — ${skill.description}`).join('\n')
|
|
1105
|
+
: 'No valid user skills found in ~/.moderado/skills.';
|
|
1106
|
+
lastThoughtTime = 0.001;
|
|
1107
|
+
lastOutputTokenRate = undefined;
|
|
1108
|
+
process.stdout.write('\x1b[H\x1b[J');
|
|
1109
|
+
process.stdout.write(renderFullWelcomeScreen({ model: currentModel ?? 'No model connected — use /connect', tokens: Math.round(sessionTokens), cost: costLabel(), usageAvailable: activeSession.usage.available, workspace: canonicalWorkspace, mode: activeMode, autoApprove: activeAutoApprove, chatQuestion: lastQuestion, chatAnswer: lastAnswer, chatThoughtTime: lastThoughtTime, queuedCommands: commandQueue.items }, process.stdout.rows));
|
|
1110
|
+
process.stdout.write(renderChatComposerCursor({ width: process.stdout.columns }, 0));
|
|
1111
|
+
continue;
|
|
1112
|
+
}
|
|
1096
1113
|
if (trimmed === '/exit' || trimmed === '/quit') {
|
|
1097
1114
|
exitCleanly('\x1b[32mGoodbye! Stay Tuned with Moderado!\x1b[0m');
|
|
1098
1115
|
}
|
|
@@ -1106,6 +1123,7 @@ export async function handleChatSession(args, version, signal) {
|
|
|
1106
1123
|
' /session - Create, resume, undo, redo, share, export, or compact sessions\n' +
|
|
1107
1124
|
' /queue - Add, inspect, or clear queued follow-up commands\n' +
|
|
1108
1125
|
' /workflow - Inspect Git, build plans, or undo agent changes\n' +
|
|
1126
|
+
' /skills - List installed user skills and reload them\n' +
|
|
1109
1127
|
' /clear - Reset conversation memory\n' +
|
|
1110
1128
|
' /help - Display commands, shortcuts & version\n' +
|
|
1111
1129
|
' /exit - Exit Moderado';
|
|
@@ -1360,6 +1378,7 @@ export async function handleChatSession(args, version, signal) {
|
|
|
1360
1378
|
const runAgent = () => loop.run(evidenceTask ?? createAgentTask(effectivePrompt, activeMode), {
|
|
1361
1379
|
workspaceRoot: canonicalWorkspace, provider: provider, tools, approvalHandler, router, policy,
|
|
1362
1380
|
maxOutputTokens: args.maxTokens ?? config.maxOutputTokens ?? DEFAULT_MAX_OUTPUT_TOKENS,
|
|
1381
|
+
skillContext: skillContext(),
|
|
1363
1382
|
routeOptions: { pinnedModelId: currentModel === 'auto' ? undefined : currentModel, allowPaid: config.allowPaid ?? args.allowPaid, allowUnknown: config.allowUnknown ?? args.allowUnknown, isLocalProfile: args.profile.includes('local') },
|
|
1364
1383
|
eventListener: (event) => {
|
|
1365
1384
|
if (event.type === 'assistant_delta') {
|