Config
Optional. A project needs none.
ts
// praecise.config.ts
import { defineConfig } from "@praecise/harness";
export default defineConfig({
name: "Acme Support",
quality: "balanced",
port: 3000,
});Every field is optional:
name, version, description |
What the app is called (the folder's name by default), the version it publishes itself as (0.1.0 by default), and one line on what it is for. |
quality |
The default for every agent that does not set its own. |
preference |
"cost", "balanced" (the default) or "quality": what to favour when cost and quality pull apart. Under "quality" the ladder is not climbed: the strongest rung answers at full depth and nothing is checked. |
explore |
The share of routing decisions sent somewhere the estimate would not have sent them, so the routing record can be read back. Off by default; EXPLORATION (2%) is the value to use, and anything above 5% is clamped. Ignored under preference: "cost" and "quality". |
port |
The dev server's port. 3000 by default. |
models |
The endpoints, in the order they are preferred (see Install). |
limits |
depth, concurrency (4 steps at once), timeout (600 seconds a step), budget (tokens a run may spend), calls, spend, retries and retryDelay. |
store |
The store an agent remembers into when it asks for one without naming it. |
stateDir |
Where runs, conversations, memory, recordings and the rest of the app's state are kept. .praecise by default. |
strict |
Refuse where the framework would otherwise be friendly. An app with no model endpoint answers with a placeholder so that a new folder does something; with strict: true, or PRAECISE_STRICT set in the environment where the config says nothing, it refuses. An app whose configured endpoints cannot be reached refuses either way. |
record |
Keep each exchange for praecise capture. |
registries |
The indexes praecise search and praecise add read. |
plugins |
Plugins. |
ask |
What /ask may spend and where it reads: quality, mode (list, summarize, generate), agent, limit, store, type. Left out, /ask retrieves and ranks without reaching a model. |
ingest |
How files become text for praecise ingest: using is native, model, mcp or cloud, beside the url and credential of the service that does it. |
selves |
Where selves live. |