laohuang 0.8.2 → 0.8.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 CHANGED
@@ -17,6 +17,7 @@ laohuang --help
17
17
  laohuang --version
18
18
  laohuang config set --provider deepseek --model deepseek-v4-flash
19
19
  laohuang doctor
20
+ laohuang update
20
21
  ```
21
22
 
22
23
  Run `laohuang` in a project directory to start an interactive session. The CLI
@@ -29,10 +30,79 @@ Google Vertex, OAuth-only providers, and OpenAI Codex. Use `/providers` to see
29
30
  available, configured, and verified status independently.
30
31
 
31
32
  `/login <provider>` stores API-key credentials, `/logout <provider>` removes
32
- them, `/model <provider> <model>` switches the session, and `/apikey` remains a
33
- compatibility alias. `verified` means an explicitly authorized live native
33
+ them, and `/model` opens a searchable list of all available models from
34
+ configured providers, including credentials supplied through environment variables.
35
+ Search by provider ID, model ID, or model name; scroll to browse the full list.
36
+ If no models are available, the CLI points to `/login`.
37
+ `/model <provider>` narrows the list, `/model <provider> <model>` switches
38
+ directly, and `/apikey` remains a compatibility alias. Switching models affects
39
+ only the current session, not the default profile.
40
+
41
+ `laohuang update` updates the running npm installation to the latest stable
42
+ release and verifies its installed version. Restart the CLI after updating.
43
+ It supports global npm installations and direct project or workspace npm
44
+ dependencies; local updates change the owning manifest and lockfile while
45
+ preserving the dependency bucket and ordinary version-prefix style. It does
46
+ not downgrade or update a different installation. Source checkouts, linked
47
+ packages, temporary npx installations, and other package managers require
48
+ their respective update methods. Installation failures are reported without
49
+ claiming that npm rolled back changes.
50
+
51
+ `/name MCP design` saves the current session name, and `/name` displays it.
52
+ Names survive resume and appear in session lists. Clones inherit the current
53
+ name; forks inherit the name at their history boundary.
54
+
55
+ `/copy` copies the latest recorded assistant response's text with its Markdown
56
+ intact, excluding reasoning and tool results. During streaming it copies the
57
+ previous recorded response. Local sessions use the operating system clipboard;
58
+ SSH sessions send an OSC 52 request to the user's terminal. A sent request is
59
+ not confirmation that the terminal accepted it. Unsupported environments or
60
+ clipboard failures produce an explanatory message.
61
+
62
+ `verified` means an explicitly authorized live native
34
63
  tool-call/tool-result E2E was recorded; no providers are checked in as verified
35
64
  by default.
36
65
 
66
+ ## MCP
67
+
68
+ MCP is built in. Put a version 1 `mcp.json` beside your model `config.json`, or
69
+ in `.laohuang/mcp.json` under the directory where you start the CLI:
70
+
71
+ ```json
72
+ {
73
+ "version": 1,
74
+ "servers": {
75
+ "local": {
76
+ "transport": "stdio",
77
+ "command": "node",
78
+ "args": ["/absolute/path/to/mcp-server.js"]
79
+ }
80
+ }
81
+ }
82
+ ```
83
+
84
+ Transports are `stdio`, Streamable `http`, and legacy `sse`. Use `/mcp status`,
85
+ `/mcp reload`, `/mcp reconnect <server>`, `/mcp login <server>`, and
86
+ `/mcp logout <server>`. Remote OAuth uses `auth: { "type": "oauth" }`.
87
+ Environment references use `{ "env": "VARIABLE_NAME" }`; no shell expansion occurs.
88
+ Project entries replace same-name global entries entirely. Invalid files are
89
+ skipped on startup; an invalid reload keeps the previous configuration.
90
+
91
+ Connections start in the background; the first model request waits for initial
92
+ discovery. Below 20 available tools, definitions are provided in full. At 20 or
93
+ more, `tool_search` automatically searches and loads MCP tools; read, write,
94
+ edit and bash remain directly available. Search is local BM25 with query and
95
+ limit (default 8, range 1–20). Loaded definitions persist in retained session
96
+ history; after compaction removes them, search loads them again. The model can
97
+ start OAuth through a synthetic authenticate tool; the terminal shows a URL
98
+ immediately and waits up to 15 minutes for the user to finish authorization.
99
+ Tool calls default to sequential execution. Recoverable network errors allow
100
+ at most three application-level attempts; lost responses can cause duplicate
101
+ side effects. Cancellation, timeouts and business errors are not retried.
102
+ Large outputs and media
103
+ are retained under `mcp-artifacts` beside the global configuration; returned
104
+ paths let you retrieve them. Media files are not native image/audio model input.
105
+ MCP processes run with your user permissions and are not sandboxed.
106
+
37
107
  See the repository README for development and architecture details:
38
108
  https://github.com/hxr223/laoHuangCode#readme