FetchUrlToolOptions

Defined in: packages/tools/src/web/tools.ts:42

Shared constructor fields for tools that materialize through an EffectGate.

Extends

• GatedToolOptions

Properties

allowedDomains?

optional allowedDomains?: readonly string[]

Defined in: packages/tools/src/web/tools.ts:52

Hostname allowlist — see AddressPolicy.allowedDomains. Omitted means no allowlist. Empty denies every host. "*" allows any host.

---

allowedUrls?

optional allowedUrls?: readonly UrlPattern[]

Defined in: packages/tools/src/web/tools.ts:47

URL patterns (glob strings and/or RegExps) allowed past the address check — see AddressPolicy.allowedUrls. Empty by default.

---

allowPrivateNetwork?

optional allowPrivateNetwork?: boolean

Defined in: packages/tools/src/web/tools.ts:61

Disables the address check entirely — see AddressPolicy.allowPrivateNetwork. Default false. Never reachable from the model; discoverable via describeWebEnv.

---

deniedDomains?

optional deniedDomains?: readonly string[]

Defined in: packages/tools/src/web/tools.ts:56

Hostname denylist — see AddressPolicy.deniedDomains.

---

effectGate

effectGate: EffectGate

Defined in: packages/tools/src/approval/types.ts:25

Pre-materialize gate. Required — pass import(“@agent-dev-lab/core”).allowAllGate explicitly for tests / permissive local hosts.

Inherited from

GatedToolOptions.effectGate

---

effectScope

effectScope: ToolEffectScope

Defined in: packages/tools/src/approval/types.ts:27

Run identity stamped onto each tool intent.

Inherited from

GatedToolOptions.effectScope

---

maxRedirects?

optional maxRedirects?: number

Defined in: packages/tools/src/web/tools.ts:69

Redirect hops to follow before refusing. Default 20.

---

maxResponseBytes?

optional maxResponseBytes?: number

Defined in: packages/tools/src/web/tools.ts:67

Stop reading a response body at this many bytes. Default 1,000,000 (1 MB).

---

resolver?

optional resolver?: HostnameResolver

Defined in: packages/tools/src/web/tools.ts:63

Hostname resolver override. Defaults to node:dns; exists so the policy can be tested.

---

timeoutMs?

optional timeoutMs?: number

Defined in: packages/tools/src/web/tools.ts:65

Wall-clock timeout for the whole fetch, in milliseconds. Default 30,000 (30s).