Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/core / ResearchFanOutOptions

Interface: ResearchFanOutOptions

Defined in: packages/core/src/engine/profile-templates.ts:206

Options of researchFanOut: the research template's plus the money and the roster.

Extends

Properties

PropertyTypeDescriptionInherited fromDefined in
budgetUsdnumberThe declared money per child, in USD: the profile's estCost, the extension's headroom floor (a tenth of it), and the figure the acceptance's limit profile measures spend against.-packages/core/src/engine/profile-templates.ts:212
children?numberChildren the acceptance requires spawned; absent leaves the roster floor off.-packages/core/src/engine/profile-templates.ts:214
description?stringAdvertised profile description; the template provides a default.ResearchAgentProfileOptions.descriptionpackages/core/src/engine/profile-templates.ts:90
evidenceContract?EvidenceContractThe declared evidence floor of the task (RV303), passed through to AgentProfile.evidenceContract so preflight can compare it against the profile's tool budget and warn tool-cap-below-evidence-floor before any paid call.ResearchAgentProfileOptions.evidenceContractpackages/core/src/engine/profile-templates.ts:101
extraTools?ToolDef<SchemaSpec>[]Extra tools appended after the research toolset.ResearchAgentProfileOptions.extraToolspackages/core/src/engine/profile-templates.ts:94
ignore?string[]Extra ignored basenames (files and directories), merged over the always-on defaults '.git' and 'node_modules'.ResearchAgentProfileOptions.ignorepackages/core/src/tools/research.ts:60
includeHidden?booleanWalk dot-entries too; default false.ResearchAgentProfileOptions.includeHiddenpackages/core/src/tools/research.ts:62
limits?UsageLimitsPer-key overrides over RESEARCH_PROFILE_LIMITS.ResearchAgentProfileOptions.limitspackages/core/src/engine/profile-templates.ts:92
maxFileBytes?numberFiles larger than this many bytes are refused; default 262144.ResearchAgentProfileOptions.maxFileBytespackages/core/src/tools/research.ts:53
maxScannedFiles?numberWalk ceiling per call (files visited); default 20000.ResearchAgentProfileOptions.maxScannedFilespackages/core/src/tools/research.ts:55
minTerminalOutputChars?numberThe character floor a limit child's terminal output must clear to be salvaged.-packages/core/src/engine/profile-templates.ts:216
pageSize?numberRows per list/search/evidence page; default 50.ResearchAgentProfileOptions.pageSizepackages/core/src/tools/research.ts:49
readPageChars?numberContent budget of one read_file page in characters; default 4000.ResearchAgentProfileOptions.readPageCharspackages/core/src/tools/research.ts:51
rootstringThe confining directory root; everything resolves under it.ResearchAgentProfileOptions.rootpackages/core/src/tools/research.ts:47
summaryMaxOutputTokens?numberThe finalization reserve summary allowance; default 8000.-packages/core/src/engine/profile-templates.ts:218