foldrun 24.0.3 → 24.0.5

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 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, cloudhost-deploy), and whether you keep your own copy — also pull (a copy for offline runs), upgrade <name>, --json
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`, `cloudhost-deploy`) come only by name |
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)) |
@@ -99,7 +99,7 @@ the point of the week; a step that weighs two arguments and picks one is not.
99
99
  | `mcpServers` | an MCP server declared inline |
100
100
  | `remotes` | outside agents it may call over A2A — `[{name, card, secret?, description?}]`: the four `a2a_*` tools, and each card's own site added to its network ([below](#calling-an-outside-agent-remotes)) |
101
101
  | `secrets` | vault entries its tools may use — names only, never values. The names the step's own model call uses (`ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL`, `ANTHROPIC_CUSTOM_HEADERS`, the `ANTHROPIC_*_MODEL` tiers, `CLAUDE_CODE_OAUTH_TOKEN`, `FOLDRUN_MODEL_KEY`) never replace the model's own settings, and `foldrun check` warns: script and API tools and `verify:` get the declared value under that name, but the agent's own shell sees the model's — give it another name (`MY_ANTHROPIC_KEY`), or run the model on it with `provider:` |
102
- | `limits` | the most calls one step may make — per tool, per web action, or in all: `limits: {web.search: 40, crm: 20, calls: 300, repeat: 5}` (`repeat`: the same call with the same input). A call past a limit is refused, never run ([Tools](tools#limits--how-many-calls-a-step-may-make)) |
102
+ | `limits` | the most calls one step may make — per tool, per web action, or in all: `limits: {web.search: 40, crm: 20, calls: 300, repeat: 5}` (`repeat`: the same call with the same input). A call past a limit is refused, never run; every step has `calls: 1000, repeat: 25` unless set, and one refused 20 times is stopped ([Tools](tools#limits--how-many-calls-a-step-may-make)) |
103
103
  | `network` | which sites its sandbox may reach: `open`, `trusted` or `none`, or a list of sites added to the trusted list — `network: [api.hubapi.com]`. Unset, an agent that may fetch or browse the web is `open` and every other `trusted`. Also in a workspace's or the account's `AGENTS.md` ([Network](network)) |
104
104
  | `permissionMode` | `plan` makes the run read-only, whatever else was granted |
105
105
  | `web` | the `web` tool's settings: `actions:` — which of its eight it may use (all when absent) — and who does each, `web: {search: brave, fetch: jina, browse: browserbase, crawl: firecrawl}`, with the key named in the vault. Unset is foldrun's own. `search:` also takes a block of the own engine's settings — engines, categories, safesearch, plugins ([Tools](tools#tuning-the-accounts-own-engine)); `browse:` a block of the browser's ([below](#webbrowse--which-browser-and-how-it-presents-itself)), and `browse:` alone cascades from `AGENTS.md`. The providers and their keys: [Tools](tools#reaching-the-web). A per-action key outside the block is not read — `check` errors on it |
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`, `cloudhost-deploy`) 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 |
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.
@@ -1874,11 +1873,19 @@ Values are whole numbers, 1 or more; to withhold a tool, leave it out of
1874
1873
  check.
1875
1874
  - **A refused call counts toward nothing**, and neither does one another
1876
1875
  check refused (a path outside the workspace, a tool not granted).
1877
- - **Nearest wins, per key.** The account's `AGENTS.md`, then the
1878
- workspace's, then the agent's own, then a flow step's
1876
+ - **Every step has two by default: `calls: 1000` and `repeat: 25`** (since
1877
+ 13 Nov 2026). A model that keeps calling — the same call, or anything at
1878
+ all — is refused, not paid for until the step's `timeout:`. Set either key
1879
+ at any level below to raise or lower it.
1880
+ - **A stuck step is stopped.** After 20 refused calls in one step the step
1881
+ ends as failed: *stopped: 20 calls were refused by this step's limits and
1882
+ the model kept calling — it is stuck*. A model told "no" that often is not
1883
+ going to stop by itself.
1884
+ - **Nearest wins, per key.** The platform's defaults, then the account's
1885
+ `AGENTS.md`, then the workspace's, then the agent's own, then a flow step's
1879
1886
  `limits: {web.search: 10}` option. A key set nearer replaces that key;
1880
1887
  the others stand.
1881
- - **On the trace.** The step lists its limits when it starts, each refusal
1888
+ - **On the trace.** The step lists its limits (the defaults included) when it starts, each refusal
1882
1889
  as it happens, and at the end what it used: `limits: web.search 40/40, crm 3/20 — 2 calls refused`.
1883
1890
 
1884
1891
  **With a search API, the cost is capped exactly.** A capped call never
@@ -1924,7 +1931,7 @@ Skills are discovered in the agent's own `skills/`, the workspace's, the
1924
1931
  account library, and the cross-client `.agents/skills/` convention that other
1925
1932
  tools read and write. A skill written here drops into them, and one they
1926
1933
  install is visible here. The platform's [gallery](#the-gallery--platform-maintained-tools-and-skills)
1927
- adds a few more — `modern-website`, `motion-video`, `cloudhost-deploy` —
1934
+ adds a few more — `modern-website` and `motion-video` —
1928
1935
  that load only for an agent whose `skills:` names them; your own skill of
1929
1936
  the same name wins.
1930
1937
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "foldrun",
3
- "version": "24.0.3",
3
+ "version": "24.0.5",
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",