@@ -71,6 +71,8 @@ export OPENAI_API_KEY=anything
7171export OPENAI_MODEL=ollama/qwen3
7272```
7373
74+ If your cluster wraps ` python3 ` , use an explicit interpreter path such as ` /usr/bin/python3.9 -m ... ` for the commands below.
75+
7476### 1.5 Run the full unit test suite
7577
7678``` bash
@@ -90,6 +92,8 @@ python3 -m unittest tests.test_background_runtime -v
9092python3 -m unittest tests.test_remote_runtime -v
9193python3 -m unittest tests.test_config_runtime -v
9294python3 -m unittest tests.test_account_runtime -v
95+ python3 -m unittest tests.test_ask_user_runtime -v
96+ python3 -m unittest tests.test_team_runtime -v
9397python3 -m unittest tests.test_tokenizer_runtime -v
9498python3 -m unittest tests.test_extended_tools -v
9599python3 -m unittest tests.test_porting_workspace -v
@@ -191,6 +195,7 @@ mkdir -p ./test_cases_budget
191195mkdir -p ./test_cases_plugins/plugins/demo
192196mkdir -p ./test_cases_mcp
193197mkdir -p ./test_cases_tasks
198+ mkdir -p ./test_cases_notebooks
194199```
195200
196201### 4.1 Config fixtures
@@ -243,6 +248,67 @@ cat > ./test_cases/.claw-account.json <<'EOF'
243248EOF
244249```
245250
251+ ### 4.2b Ask-user fixtures
252+
253+ ``` bash
254+ cat > ./test_cases/.claw-ask-user.json << 'EOF '
255+ {
256+ "answers": [
257+ {
258+ "question": "Approve deploy?",
259+ "answer": "yes"
260+ },
261+ {
262+ "question": "Choose rollout mode",
263+ "answer": "safe"
264+ }
265+ ]
266+ }
267+ EOF
268+ ```
269+
270+ ### 4.2c Team fixtures
271+
272+ ``` bash
273+ cat > ./test_cases/.claw-teams.json << 'EOF '
274+ {
275+ "teams": [
276+ {
277+ "name": "reviewers",
278+ "description": "Code review group",
279+ "members": ["alice", "bob"]
280+ },
281+ {
282+ "name": "release",
283+ "description": "Release coordination group",
284+ "members": ["ops", "qa"]
285+ }
286+ ]
287+ }
288+ EOF
289+ ```
290+
291+ ### 4.2d Notebook fixture
292+
293+ ``` bash
294+ cat > ./test_cases_notebooks/demo.ipynb << 'EOF '
295+ {
296+ "cells": [
297+ {
298+ "cell_type": "code",
299+ "metadata": {},
300+ "source": ["print(1)\n"],
301+ "outputs": [],
302+ "execution_count": null
303+ }
304+ ],
305+ "metadata": {},
306+ "nbformat": 4,
307+ "nbformat_minor": 5
308+ }
309+ EOF
310+ ```
311+
246312### 4.3 Remote fixtures
247313
248314``` bash
@@ -528,11 +594,13 @@ python3 -m src.main agent "/settings" --cwd ./test_cases
528594python3 -m src.main agent " /account" --cwd ./test_cases
529595python3 -m src.main agent " /account profiles" --cwd ./test_cases
530596python3 -m src.main agent " /account profile local" --cwd ./test_cases
597+ python3 -m src.main agent " /ask" --cwd ./test_cases
598+ python3 -m src.main agent " /ask history" --cwd ./test_cases
531599python3 -m src.main agent " /login local" --cwd ./test_cases
532600python3 -m src.main agent " /logout" --cwd ./test_cases
533601```
534602
535- ### 5.3 Remote, search, task, and plan slash commands
603+ ### 5.3 Remote, search, team, task, and plan slash commands
536604
537605``` bash
538606python3 -m src.main agent " /remote" --cwd ./test_cases
@@ -549,6 +617,10 @@ python3 -m src.main agent "/search providers" --cwd ./test_cases
549617python3 -m src.main agent " /search provider local-search" --cwd ./test_cases
550618python3 -m src.main agent " /search use local-search" --cwd ./test_cases
551619python3 -m src.main agent " /search python argparse tutorial" --cwd ./test_cases
620+ python3 -m src.main agent " /teams" --cwd ./test_cases
621+ python3 -m src.main agent " /team reviewers" --cwd ./test_cases
622+ python3 -m src.main agent " /messages" --cwd ./test_cases
623+ python3 -m src.main agent " /messages reviewers" --cwd ./test_cases
552624python3 -m src.main agent " /plan" --cwd ./test_cases_tasks
553625python3 -m src.main agent " /planner" --cwd ./test_cases_tasks
554626python3 -m src.main agent " /tasks" --cwd ./test_cases_tasks
@@ -1156,6 +1228,31 @@ python3 -m src.main agent \
11561228 --show-transcript
11571229```
11581230
1231+ ## 14A. Ask-user Runtime
1232+
1233+ ### 14A.1 CLI status and history
1234+
1235+ ``` bash
1236+ python3 -m src.main ask-status --cwd ./test_cases
1237+ python3 -m src.main ask-history --cwd ./test_cases
1238+ ```
1239+
1240+ ### 14A.2 Slash commands
1241+
1242+ ``` bash
1243+ python3 -m src.main agent " /ask" --cwd ./test_cases
1244+ python3 -m src.main agent " /ask history" --cwd ./test_cases
1245+ ```
1246+
1247+ ### 14A.3 Real tool loop
1248+
1249+ ``` bash
1250+ python3 -m src.main agent \
1251+ " Use ask_user_question to answer 'Approve deploy?' and then summarize the decision." \
1252+ --cwd ./test_cases \
1253+ --show-transcript
1254+ ```
1255+
11591256## 15. Search Runtime And Real Web Search
11601257
11611258### 15.1 Provider status and activation
@@ -1303,6 +1400,56 @@ python3 -m src.main agent-context-raw --cwd ./test_cases_tasks
13031400python3 -m src.main agent-prompt --cwd ./test_cases_tasks
13041401```
13051402
1403+ ## 18A. Team Runtime
1404+
1405+ ### 18A.1 CLI status and inspection
1406+
1407+ ``` bash
1408+ python3 -m src.main team-status --cwd ./test_cases
1409+ python3 -m src.main team-list --cwd ./test_cases
1410+ python3 -m src.main team-get reviewers --cwd ./test_cases
1411+ python3 -m src.main team-messages --cwd ./test_cases
1412+ ```
1413+
1414+ ### 18A.2 Create and delete teams
1415+
1416+ ``` bash
1417+ python3 -m src.main team-create docs --member alice --member bob --cwd ./test_cases
1418+ python3 -m src.main team-list --cwd ./test_cases
1419+ python3 -m src.main team-delete docs --cwd ./test_cases
1420+ ```
1421+
1422+ ### 18A.3 Slash commands
1423+
1424+ ``` bash
1425+ python3 -m src.main agent " /teams" --cwd ./test_cases
1426+ python3 -m src.main agent " /team reviewers" --cwd ./test_cases
1427+ python3 -m src.main agent " /messages" --cwd ./test_cases
1428+ python3 -m src.main agent " /messages reviewers" --cwd ./test_cases
1429+ ```
1430+
1431+ ### 18A.4 Real tool loop
1432+
1433+ ``` bash
1434+ python3 -m src.main agent \
1435+ " Create a local team called docs with members alice and bob, send a message to that team asking for notebook review, then show the team messages." \
1436+ --cwd ./test_cases \
1437+ --allow-write \
1438+ --show-transcript
1439+ ```
1440+
1441+ ## 18B. Notebook Edit Tool
1442+
1443+ ### 18B.1 Direct notebook edit through the agent loop
1444+
1445+ ``` bash
1446+ python3 -m src.main agent \
1447+ " Use notebook_edit to update demo.ipynb cell 0 so it prints 2, then read back the notebook file and summarize the change." \
1448+ --cwd ./test_cases_notebooks \
1449+ --allow-write \
1450+ --show-transcript
1451+ ```
1452+
13061453### 18.2 Create and inspect tasks
13071454
13081455``` bash
0 commit comments