foldrun 24.0.2 → 24.0.4

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/docs/agents.md CHANGED
@@ -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/tools.md CHANGED
@@ -1874,11 +1874,19 @@ Values are whole numbers, 1 or more; to withhold a tool, leave it out of
1874
1874
  check.
1875
1875
  - **A refused call counts toward nothing**, and neither does one another
1876
1876
  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
1877
+ - **Every step has two by default: `calls: 1000` and `repeat: 25`** (since
1878
+ 13 Nov 2026). A model that keeps calling — the same call, or anything at
1879
+ all — is refused, not paid for until the step's `timeout:`. Set either key
1880
+ at any level below to raise or lower it.
1881
+ - **A stuck step is stopped.** After 20 refused calls in one step the step
1882
+ ends as failed: *stopped: 20 calls were refused by this step's limits and
1883
+ the model kept calling — it is stuck*. A model told "no" that often is not
1884
+ going to stop by itself.
1885
+ - **Nearest wins, per key.** The platform's defaults, then the account's
1886
+ `AGENTS.md`, then the workspace's, then the agent's own, then a flow step's
1879
1887
  `limits: {web.search: 10}` option. A key set nearer replaces that key;
1880
1888
  the others stand.
1881
- - **On the trace.** The step lists its limits when it starts, each refusal
1889
+ - **On the trace.** The step lists its limits (the defaults included) when it starts, each refusal
1882
1890
  as it happens, and at the end what it used: `limits: web.search 40/40, crm 3/20 — 2 calls refused`.
1883
1891
 
1884
1892
  **With a search API, the cost is capped exactly.** A capped call never
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "foldrun",
3
- "version": "24.0.2",
3
+ "version": "24.0.4",
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": "^22.3.0"
14
+ "@foldrun/core": "^22.4.0"
15
15
  },
16
16
  "files": [
17
17
  "bin",