Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/rulvar / ResearchFanOutOptions

Interface: ResearchFanOutOptions

Defined in: packages/core/dist/index.d.ts

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/dist/index.d.ts
children?numberChildren the acceptance requires spawned; absent leaves the roster floor off.-packages/core/dist/index.d.ts
description?stringAdvertised profile description; the template provides a default.ResearchAgentProfileOptions.descriptionpackages/core/dist/index.d.ts
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/dist/index.d.ts
extraTools?ToolDef<SchemaSpec<unknown>>[]Extra tools appended after the research toolset.ResearchAgentProfileOptions.extraToolspackages/core/dist/index.d.ts
ignore?string[]Extra ignored basenames (files and directories), merged over the always-on defaults '.git' and 'node_modules'.ResearchAgentProfileOptions.ignorepackages/core/dist/index.d.ts
includeHidden?booleanWalk dot-entries too; default false.ResearchAgentProfileOptions.includeHiddenpackages/core/dist/index.d.ts
limits?UsageLimitsPer-key overrides over RESEARCH_PROFILE_LIMITS.ResearchAgentProfileOptions.limitspackages/core/dist/index.d.ts
maxFileBytes?numberFiles larger than this many bytes are refused; default 262144.ResearchAgentProfileOptions.maxFileBytespackages/core/dist/index.d.ts
maxScannedFiles?numberWalk ceiling per call (files visited); default 20000.ResearchAgentProfileOptions.maxScannedFilespackages/core/dist/index.d.ts
minTerminalOutputChars?numberThe character floor a limit child's terminal output must clear to be salvaged.-packages/core/dist/index.d.ts
pageSize?numberRows per list/search/evidence page; default 50.ResearchAgentProfileOptions.pageSizepackages/core/dist/index.d.ts
readPageChars?numberContent budget of one read_file page in characters; default 4000.ResearchAgentProfileOptions.readPageCharspackages/core/dist/index.d.ts
rootstringThe confining directory root; everything resolves under it.ResearchAgentProfileOptions.rootpackages/core/dist/index.d.ts
summaryMaxOutputTokens?numberThe finalization reserve summary allowance; default 8000.-packages/core/dist/index.d.ts