@weapp-agent/cli 0.0.0 → 0.1.1

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
@@ -1,7 +1,49 @@
1
- # Weapp Agent CLI — bootstrap placeholder
1
+ # Weapp Agent
2
2
 
3
- This 0.0.0 package reserves the npm package name so GitHub Actions trusted publishing can be configured.
3
+ Model-free acceptance and MCP tools for weapp-vite native and Wevu WeChat projects, with an optional independent AI coding mode.
4
4
 
5
- It contains no CLI implementation, executable, or runtime dependencies. Use a future documented release to run Weapp Agent.
5
+ Requires Node.js 24.15+. Install the preview package from npm:
6
6
 
7
- Source: https://github.com/weapp-vite/weapp-vite/tree/main/packages/agent-cli
7
+ ```sh
8
+ npm install --global @weapp-agent/cli@preview
9
+ ```
10
+
11
+ ```sh
12
+ npm install --global ./weapp-agent-cli-0.1.0.tgz
13
+ weapp-agent init --provider openai --model YOUR_MODEL
14
+ weapp-agent doctor
15
+ weapp-agent --trust run "Add a counter and verify the project"
16
+ ```
17
+
18
+ Set your provider API key in the environment. Project configuration never stores keys.
19
+
20
+ [Documentation](https://vite.weapp.dev/guide/agent/) · [Model-free acceptance](https://vite.weapp.dev/guide/acceptance) · [Source and validation](https://github.com/weapp-vite/weapp-vite/tree/main/docs/migrations/weapp-agent)
21
+
22
+ Inspect a saved session before continuing:
23
+
24
+ ```sh
25
+ weapp-agent sessions --details
26
+ weapp-agent session SESSION_ID --json
27
+ weapp-agent resume SESSION_ID "Continue the task"
28
+ ```
29
+
30
+ Inspection is read-only and requires no model credentials. Context compression preserves complete user requests and images; if they exceed `contextCharacters`, the run stops with `reason: context_budget` before calling the model. Increase the budget to resume. Interrupted calls are never replayed automatically: inspect their outcomes, then use `resume --acknowledge-interrupted` or `/acknowledge-interrupted [prompt]` in the interactive terminal. See the [session guide](https://vite.weapp.dev/guide/agent/sessions).
31
+
32
+ Follow-up requirements and images are saved even when recovery stops for acknowledgement. After confirmation, they reach the model in their original order after the complete tool results. Concurrent recovery attempts cannot take over each other's session locks, and closing a session waits for accepted journal writes to finish.
33
+
34
+ Machine-readable `run` and `resume` output is JSONL. The `run.started` event identifies the project with `projectId` and no longer writes an absolute workspace path. Recovery prompts show only bounded, redacted tool-input previews. Tools marked `mutates: true`, including MCP tools, require `verify_project` before the task can finish.
35
+
36
+ MIT. Tool permissions are not an operating-system sandbox.
37
+
38
+ ## Use with an existing AI host
39
+
40
+ ```sh
41
+ weapp-agent init
42
+ weapp-agent doctor --json
43
+ # Review project scripts, configuration and scenarios before granting trust.
44
+ weapp-agent --trust accept --json
45
+ weapp-agent -C /absolute/path/to/project mcp
46
+ weapp-agent skill .agents/skills/weapp-acceptance
47
+ ```
48
+
49
+ Acceptance/MCP need no API key. Configure `acceptance.scenarios` for actual runtime assertions. Default required checks are build and devtools; missing evidence is unverified, not passed. Reports use version 2 and include source freshness, steps, screenshots and console logs. Legacy verify semantics are unchanged. The Skill is bundled under `skills/weapp-acceptance` and installation never modifies host settings automatically.