@tangle-network/sandbox-cli 0.20.66 → 0.21.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
@@ -15,7 +15,7 @@ See [Limitations](#limitations) for open gaps.
15
15
 
16
16
  ## Install
17
17
 
18
- One-liner (requires Node 20+ on PATH):
18
+ One-liner (requires Node on PATH matching the package's [`engines` metadata](./package.json)):
19
19
 
20
20
  ```bash
21
21
  curl -fsSL https://sandbox.tangle.tools/install.sh | sh
@@ -52,6 +52,29 @@ pnpm --filter @tangle-network/sandbox-cli build
52
52
  node products/sandbox/cli/bin/tangle.js --help
53
53
  ```
54
54
 
55
+ ## Local graphs
56
+
57
+ Save a graph in a repository's `.tangle/graphs/<name>.yaml` or in
58
+ `~/.tangle/graphs/<name>.yaml`. Repository graphs take precedence. The packaged
59
+ [`haiku-review.yaml`](./examples/haiku-review.yaml) contains a writer, an independent
60
+ critic and a declared completion check.
61
+
62
+ ```bash
63
+ tangle graph new "Write and independently judge a haiku" --name haiku-review
64
+ tangle graph run haiku-review --dry-run
65
+ tangle graph run haiku-review
66
+ ```
67
+
68
+ Graphs use the selected harness's native subscription login. Set `seat` in
69
+ `~/.tangle/config.json` to keep a default; `--seat` overrides it for every node.
70
+ A graph with no integration needs requires no Tangle login. Validation resolves
71
+ seats and needs before starting agents. Missing connections name the provider
72
+ and its `tangle hub connect <provider>` command.
73
+
74
+ Progress goes to stderr; `--json` returns the result or the shared error contract
75
+ on stdout. Run journals live under `~/.tangle/runs/<run-id>`, and graph history
76
+ lives in `~/.tangle/graph-registry`. Unknown token and cost totals remain `null`.
77
+
55
78
  ## Supervisor accounting
56
79
 
57
80
  `tangle supervise` reports measured tokens and cost for successful and failed runs.