KnowledgePackageConfig

Defined in: packages/engine/src/packages/knowledge/types.ts:6

Configuration for createKnowledgePackage. See KnowledgePackage.ts’s module doc for the “bring your own answer engine” rationale (same pluggable-provider approach as packages/stocks).

Properties

answerQuery?

optional answerQuery?: (query, signal) => Promise<string>;

Defined in: packages/engine/src/packages/knowledge/types.ts:14

Answer a free-text query verbatim (e.g. “distance to the moon”, captured from distance to the moon = ?) and return a plain-text answer string. Required for <query> = ? to return real data, when omitted, that expression resolves to an honest KNOWLEDGE_NOT_CONFIGURED error Value, never a hallucinated/guessed answer.

Parameters

Parameter	Type
query	string
signal	AbortSignal

Returns

Promise<string>

---

provider?

optional provider?: string;

Defined in: packages/engine/src/packages/knowledge/types.ts:31

The provider’s name, recorded on every answer this package fetches so a host can say where a figure came from and when (see vm/Provenance.ts). Defaults to "host", since the fetch is the host’s own.

---

staleTimeMs?

optional staleTimeMs?: number;

Defined in: packages/engine/src/packages/knowledge/types.ts:24

TanStack Query staleTime for answered queries, in ms. Default 5 minutes (matches createQueryResolver’s own default), most knowledge-style facts (“distance to the moon”) don’t change meaningfully within a session, but a short-ish default avoids treating a genuinely time-sensitive answer (e.g. “population of Tokyo = ?”) as permanently fixed.