agent-valley 1.0.0 → 1.1.0

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,9 +1,13 @@
1
1
  # Agent Valley
2
2
 
3
- Run AI actors in isolated Git worktrees. Use Linear/GitHub issues for queued, parallel work, or give a local Chief Director a goal to plan, delegate, review, and verify.
3
+ Give a Chief Director a goal for service improvement, refactoring, usability, or revenue growth. It uses installed OMA skills and Technical Director, Design Director, and Marketing Director personas to choose skills, assign Actors, review work, repair or replan, and verify progress. Its report explains the decisions, reasons, results, and verification evidence. Actors work in isolated Git worktrees; Linear/GitHub issues also support queued, parallel work.
4
+
5
+ For ongoing improvement, use `av operate "Improve usability, reliability and revenue"`. The Chief selects successive goals using accepted changes, previous reports, measured outcomes and available tools. `av operations` shows progress; Ctrl-C pauses and `av operate --resume ID` continues. See [continuous Chief operation](./docs/guides/chief-continuous.md) for limits, cloud/MCP access and recovery.
4
6
 
5
7
  > Read this in: [한국어](./README.ko.md)
6
8
 
9
+ > **Token usage warning:** AV prioritizes your goal over token savings. Planning, persona consultation, Actor work, independent reviews, repairs, and replanning can consume substantial model usage and incur API charges. AV does not check or manage your subscription's remaining allowance. Reported usage is recorded; optional estimated-cost limits and execution limits still apply.
10
+
7
11
  ```
8
12
  Linear Issue (Todo)
9
13
  → Webhook → Orchestrator → Git Worktree → Actor Session
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
3
3
  "name": "av",
4
- "version": "1.0.0",
4
+ "version": "1.1.0",
5
5
  "description": "Delegate repository goals to Agent Valley and inspect mission progress and verification evidence.",
6
6
  "author": {
7
7
  "name": "Agent Valley"
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: av
3
- description: Delegate a repository goal to Agent Valley's Chief Director, inspect saved missions and evidence reports, or resume or cancel an AV mission. Use when the user asks AV or the Chief Director to own a goal through planning, Actor work, independent review, and verification.
3
+ description: Delegate a repository goal or continuous improvement charter to Agent Valley's Chief Director and inspect, resume or stop its verified work. Use when the user asks AV to supervise Actors through execution, review and verification.
4
4
  ---
5
5
 
6
6
  # Agent Valley
@@ -9,7 +9,7 @@ Use the configured `av` MCP server for the repository the user selected. The Chi
9
9
 
10
10
  ## Prevent recursive delegation
11
11
 
12
- Before `av_order` or `av_resume`, check the current process environment for `AGENT_VALLEY_MANAGED_RUN` when the client has a local shell/environment tool. Check only this variable; do not dump the environment or read credentials. If its value is `1`, or your assignment identifies you as an AV Chief Director or Actor, perform your assigned work directly. Do not start or resume another AV mission or run a nested AV setup.
12
+ Before `av_order`, `av_resume`, `av_operate` or `av_operation_resume`, check the current process environment for `AGENT_VALLEY_MANAGED_RUN` when the client has a local shell/environment tool. Check only this variable; do not dump the environment or read credentials. If its value is `1`, or your assignment identifies you as an AV Chief Director or Actor, perform your assigned work directly. Do not start or resume another AV mission or operation, or run a nested AV setup.
13
13
 
14
14
  For web clients without a local environment tool, read `av_missions` from the configured AV server. Its structured `executionContext` must report `managed: false` and `delegationAllowed: true` before delegation. Use its advertised workspace instead of inventing a local repository path. A managed assignment or a local `AGENT_VALLEY_MANAGED_RUN=1` always takes priority over a remote server's context. If neither the local environment nor the server establishes the context, do not delegate until it is established.
15
15
 
@@ -22,6 +22,16 @@ For web clients without a local environment tool, read `av_missions` from the co
22
22
 
23
23
  AV reads the saved repository settings to select the Chief Director and available Actors. Do not invent model availability, measurements, or a successful outcome.
24
24
 
25
+ ## Continuous improvement
26
+
27
+ For a request to keep improving the service, use `av_operate` with the user's operating `charter`. Check `av_operations` for existing work first. Generate and retain a `requestId` with the exact input before submission; uncertain retries reuse both. Supply `cycles`, `interval` or per-mission execution limits only for authorized overrides. The default continues until stopped or paused and can incur ongoing model charges. Limits apply to each improvement and decision checkpoint, not lifetime operation spending.
28
+
29
+ Keep the returned operation ID. Read `av_operation_status(operationId)` and `av_operation_report(operationId)` for progress and decisions. Use `av_status` and `av_report` with its child mission IDs for actual verification and measurements. A running continuous operation is not a completed service improvement merely because submission succeeded.
30
+
31
+ `av_operation_resume(operationId, requestId?)` preserves the charter and accepted changes. Repair and explicitly resume a paused child before continuing its operation; this call does not reconcile uncertain external effects or reset spent budgets. `av_operation_cancel(operationId)` requests a stop; poll until the operation is paused and the supervisor is stopped before retrying. MCP disconnect alone leaves detached operations running.
32
+
33
+ Installed tools or configured MCP names do not prove login or service access. Chief Actors can use available tools within existing permissions; missing evidence remains a reported limitation.
34
+
25
35
  ## Supervise and report
26
36
 
27
37
  - `av_missions`: list saved missions for the bound repository.