Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/rulvar / ResearchAgentProfileOptions

Interface: ResearchAgentProfileOptions

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

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