foldrun 24.0.4 → 25.0.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/bin/foldrun.mjs +1 -1
- package/docs/agents.md +1 -1
- package/docs/cli.md +1 -1
- package/docs/tools.md +1 -2
- package/package.json +2 -2
package/bin/foldrun.mjs
CHANGED
|
@@ -227,7 +227,7 @@ const HELP = `foldrun — agents are just folders
|
|
|
227
227
|
foldrun billing plans the plans, which one the account is on and this cycle's credits — also plan <id>, plan cancel, plan resume (asks first)
|
|
228
228
|
foldrun billing top-up <usd> Stripe's checkout page for adding credit (owner only; --no-browser prints it)
|
|
229
229
|
foldrun billing card Stripe's page for saving a card for auto top-up (owner only)
|
|
230
|
-
foldrun gallery the platform's built-in tools (web, docs, video) and skills (modern-website, motion-video
|
|
230
|
+
foldrun gallery the platform's built-in tools (web, docs, video) and skills (modern-website, motion-video), and whether you keep your own copy — also pull (a copy for offline runs), upgrade <name>, --json
|
|
231
231
|
foldrun identity what your cloud must trust for keyless identities: the issuer and each agent's subject (--to <workspace>, --json)
|
|
232
232
|
foldrun jobs the four jobs — governance, guardrail, observability, evaluation — and what each has set (--to <workspace>, --json)
|
|
233
233
|
foldrun account the account's defaults — also set <key> <value>, clear <key> (timezone, notify, budget, concurrency, compute vcpu <n> memory <GiB> disk <GiB>, deploy_block none|secrets|security, network_enforce on|off, owner, alerts <threshold> <value>, judge model|effort <value>; or <job>.<field>, e.g. governance.owner), pause [--reason] [--stop] / resume (the kill switch), telemetry [set <url> --header name=\${SECRET} (others kept; name= drops one) | clear | test] (runs as OpenTelemetry traces), providers (--check) (singular; accounts lists logins)
|
package/docs/agents.md
CHANGED
|
@@ -89,7 +89,7 @@ the point of the week; a step that weighs two arguments and picks one is not.
|
|
|
89
89
|
|---|---|
|
|
90
90
|
| `tools` | the one grant list — built-in groups, exact SDK names, and your own tools |
|
|
91
91
|
| `disallowedTools` | subtract from what it would otherwise have |
|
|
92
|
-
| `skills` | an allowlist. **Absent inherits every skill in scope**; `[]` withholds all of them. The platform's [gallery skills](tools#the-gallery--platform-maintained-tools-and-skills) (`modern-website`, `motion-video
|
|
92
|
+
| `skills` | an allowlist. **Absent inherits every skill in scope**; `[]` withholds all of them. The platform's [gallery skills](tools#the-gallery--platform-maintained-tools-and-skills) (`modern-website`, `motion-video`) come only by name |
|
|
93
93
|
| `agents` | colleagues it may consult mid-run — an answer, no tools |
|
|
94
94
|
| `subagents` | colleagues it may delegate a whole job to — own context, own tools, never more than its own ([below](#delegating-to-a-sub-agent)) |
|
|
95
95
|
| `sandbox` | `own` \| `parent` (default) — delegated to as a sub-agent, run each job in a sandbox of its own, with its own tools, secrets and network ([below](#isolated-sub-agents-sandbox-own)) |
|
package/docs/cli.md
CHANGED
|
@@ -189,7 +189,7 @@ claude.ai or Claude Code there, nor any MCP configuration on disk.
|
|
|
189
189
|
| `foldrun billing details set --clear-address` | drops the address from who invoices are made out to, the rest kept; `--clear-email` and `--clear-abn` the same for the email and the ABN (each refused beside its own `--address`/`--email`/`--abn`) |
|
|
190
190
|
| `foldrun billing plans` | the Plans page: every plan with its monthly fee, credits, runs at once and workspaces, which one the account is on and this cycle's credits left (`GET /api/billing/plans`). `billing plan <id>` chooses one — a first plan answers with Stripe's checkout page, a change on a live plan is prorated at Stripe at once (asks first; `--yes`); `plan cancel` stops it at the end of the cycle, `plan resume` undoes that until then (`POST`/`DELETE /api/billing/subscribe`) |
|
|
191
191
|
| `foldrun billing top-up <usd>` | the Payment page's top-up: Stripe's checkout page for that amount, opened in the browser (`--no-browser`, or no terminal, prints it). The credit lands when Stripe confirms the payment. `billing card` is the same for saving a card for auto top-up. Both need `billing:manage` |
|
|
192
|
-
| `foldrun gallery` | the tools (`web`, `docs`, `video`) and skills (`modern-website`, `motion-video
|
|
192
|
+
| `foldrun gallery` | the tools (`web`, `docs`, `video`) and skills (`modern-website`, `motion-video`) the platform ships to every account, by shelf, and for each whether this account keeps its own copy and whether that copy still matches; `--json` for a script. `pull` lays the shelf down under `~/.foldrun/gallery/<host>/` for offline runs (`foldrun run` and `foldrun eval` refresh it themselves before each run); `upgrade <name>` replaces the account's copy of a tool or skill with the current gallery version, the old one a revision back. `foldrun check` knows the gallery's names, so a signed-out check warns rather than calling them missing |
|
|
193
193
|
| `foldrun identity` | keyless cloud identity: the issuer your cloud must trust and the subject each agent's tokens carry (`GET /api/identity`); `--to <workspace>` fills the workspace in, `--json` |
|
|
194
194
|
| `foldrun jobs` | the four jobs — governance, guardrail, observability, evaluation — and every `AGENTS.md` field of each, with what is set (`GET /api/account/jobs`). `--to <workspace>` shows the workspace's value beside the account's and how the two combine; `--json` the document. `account set <job>.<field>` and `workspace set <job>.<field>` refuse a field that scope cannot set and name the `AGENTS.md` to write it in. See [The four jobs](four-jobs) |
|
|
195
195
|
| `foldrun account` | the account's own defaults — the AGENTS.md frontmatter every workspace under it inherits: `timezone`, `notify`, `budget`, `concurrency`, `deploy_block`, `network_enforce`. `foldrun account set timezone Australia/Sydney`, `set notify email you@example.com` (`--events failed,awaiting-approval,completed`), `set notify url https://…`, `set budget 60/month`, `set concurrency 4`, `set compute vcpu 4 memory 8 disk 40` (GiB; any of them, merged over what is set — the account's own pool, lower than the plan's), `set deploy_block secrets` (`none`, `secrets` or `security` — what the scanner's findings do to a deploy), `set network_enforce on` (every workspace refuses a site off an agent's `network:` list; `off` reports only), `set owner <email or name>`, `set alerts <threshold> <value>` (merged into what is set; `off` removes one), `set judge model|effort <value>`. Any setting may be named by its job — `set governance.deploy_block secrets`, `set observability.alerts stale_days 30` — and one named under the wrong job is refused with the right one, `pause` (`--reason "…"`, `--stop` to also stop every run going now — asks, or `--yes`) and `resume`: the kill switch, no new run starts in any workspace while paused, `telemetry` — where each finished run goes as an OpenTelemetry trace: bare shows it, `set <url> --header authorization='${OTEL_TOKEN}'` (repeatable; a value is a vault secret's name; the headers already set are kept, as the dashboard's card keeps them, and `--header name=` drops one), `clear`, `test` (one made-up run, and what the collector answered; exit 1 when not delivered), and `clear <key>` to unset one. `set notify` merges against what is there, because the platform replaces the whole block. `providers` lists the model providers the account's files use and the last daily key check — `--check` asks now, and a dead key is a non-zero exit. `model` is what every step runs on unless a `provider:` block names another — the account's own model key, or foldrun's models: `foldrun account model` shows it (never a key, only its last four; on foldrun's models, the provider, its tier map and today's spend against the daily cap; exit 1 when runs are refused — no key, or foldrun's models refused for the account), `model set <provider> --key <api key>` sets the key — a preset name (anthropic, openrouter, openai, groq, …) or `custom --base-url https://… --format anthropic|openai`, `--key -` reads the key from stdin, and in a terminal it (or no `--key`) asks for it hidden — a pasted key works, `--use` also runs on it from now on in the same request (as `model use own`, which the dashboard's Save does) — and `model remove` removes it (the choice stays); a Claude login token is refused for any account not allowed the platform's own credential. `model use foldrun --provider <anthropic|openai|gemini|deepseek|moonshot>` runs every step on foldrun's models — the platform's keys, billed in credits at foldrun's price list, hosted only; a provider the platform cannot serve now is refused — and `model use own` goes back to the account's own key, which is kept. `model prices` (`--provider <p>`, `--json`) lists foldrun's price list as the account pays it, USD per million tokens. `export` downloads everything the platform holds about the account — workspaces, runs, members and the whole ledger — as one JSON file (owner only; `--file <path>`, `--force`). Singular — `accounts` below is the list of logins on this machine |
|
package/docs/tools.md
CHANGED
|
@@ -218,7 +218,6 @@ in the project, and says how to install it when it is missing.
|
|
|
218
218
|
|---|---|
|
|
219
219
|
| `modern-website` | building a modern, high-end website or app: Astro for content sites and Next.js for apps when nothing is named, the current stack, design, bundled assets, the launch checks |
|
|
220
220
|
| `motion-video` | motion graphics and short videos with the `video` tool: scenes, easing, stills before renders, video on a website |
|
|
221
|
-
| `cloudhost-deploy` | deploying to [cloudhost](https://cloudhost.ir) through its MCP tools: `cloudhost.toml`, bindings, previews first, production on approval |
|
|
222
221
|
|
|
223
222
|
The gallery is deliberately small: capabilities that are hard to build from
|
|
224
223
|
a plain HTTP call and that agents building things keep reaching for.
|
|
@@ -1932,7 +1931,7 @@ Skills are discovered in the agent's own `skills/`, the workspace's, the
|
|
|
1932
1931
|
account library, and the cross-client `.agents/skills/` convention that other
|
|
1933
1932
|
tools read and write. A skill written here drops into them, and one they
|
|
1934
1933
|
install is visible here. The platform's [gallery](#the-gallery--platform-maintained-tools-and-skills)
|
|
1935
|
-
adds a few more — `modern-website
|
|
1934
|
+
adds a few more — `modern-website` and `motion-video` —
|
|
1936
1935
|
that load only for an agent whose `skills:` names them; your own skill of
|
|
1937
1936
|
the same name wins.
|
|
1938
1937
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "foldrun",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "25.0.0",
|
|
4
4
|
"description": "Agents are just folders. Write them, check them, run them — on your machine.",
|
|
5
5
|
"license": "FSL-1.1-ALv2",
|
|
6
6
|
"type": "module",
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"node": ">=22"
|
|
12
12
|
},
|
|
13
13
|
"dependencies": {
|
|
14
|
-
"@foldrun/core": "^
|
|
14
|
+
"@foldrun/core": "^23.0.1"
|
|
15
15
|
},
|
|
16
16
|
"files": [
|
|
17
17
|
"bin",
|