Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/core / ResearchAgentProfileOptions

Interface: ResearchAgentProfileOptions

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

Options of researchAgentProfile: the toolset knobs plus template overrides.

Extends

Properties

PropertyTypeDescriptionInherited fromDefined in
description?stringAdvertised profile description; the template provides a default.-packages/core/src/engine/profile-templates.ts:88
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.-packages/core/src/engine/profile-templates.ts:99
extraTools?ToolDef<SchemaSpec>[]Extra tools appended after the research toolset.-packages/core/src/engine/profile-templates.ts:92
ignore?string[]Extra ignored basenames (files and directories), merged over the always-on defaults '.git' and 'node_modules'.RepositoryResearchToolsetOptions.ignorepackages/core/src/tools/research.ts:57
includeHidden?booleanWalk dot-entries too; default false.RepositoryResearchToolsetOptions.includeHiddenpackages/core/src/tools/research.ts:59
limits?UsageLimitsPer-key overrides over RESEARCH_PROFILE_LIMITS.-packages/core/src/engine/profile-templates.ts:90
maxFileBytes?numberFiles larger than this many bytes are refused; default 262144.RepositoryResearchToolsetOptions.maxFileBytespackages/core/src/tools/research.ts:50
maxScannedFiles?numberWalk ceiling per call (files visited); default 20000.RepositoryResearchToolsetOptions.maxScannedFilespackages/core/src/tools/research.ts:52
pageSize?numberRows per list/search/evidence page; default 50.RepositoryResearchToolsetOptions.pageSizepackages/core/src/tools/research.ts:46
readPageChars?numberContent budget of one read_file page in characters; default 4000.RepositoryResearchToolsetOptions.readPageCharspackages/core/src/tools/research.ts:48
rootstringThe confining directory root; everything resolves under it.RepositoryResearchToolsetOptions.rootpackages/core/src/tools/research.ts:44