Interface: KnowledgeStore
Defined in: core/knowledgeStore.ts:88
Where the knowledge base lives. The kit ships one over markdown files
(createFileKnowledgeStore()); another one (a database, a vector store) implements this
interface and is passed with AgentSpec.knowledgeStore. Pages are never deleted or renamed:
their ids are what links point to.
Methods
check()
check(): Promise<CheckReport>;
Defined in: core/knowledgeStore.ts:122
The mechanical problems.
Returns
Promise<CheckReport>
create()
create(
type,
slug,
title,
content,
fields?
): Promise<string>;
Defined in: core/knowledgeStore.ts:96
A new page; fails if the id exists or a link points nowhere. Returns its id.
Parameters
| Parameter | Type |
|---|---|
type | string |
slug | string |
title | string |
content | string |
fields? | FieldChanges |
Returns
Promise<string>
createMany()
createMany(pages): Promise<string[]>;
Defined in: core/knowledgeStore.ts:101
Several new pages at once, whose links may point to each other (a summary and the concepts it feeds): all are created, or none. Returns their ids.
Parameters
| Parameter | Type |
|---|---|
pages | readonly NewPage[] |
Returns
Promise<string[]>
edit()
edit(
id,
oldText,
newText,
fields?
): Promise<void>;
Defined in: core/knowledgeStore.ts:103
Replaces the one occurrence of oldText in a page's body; fails if it's missing or appears more than once.
Parameters
| Parameter | Type |
|---|---|
id | string |
oldText | string |
newText | string |
fields? | FieldChanges |
Returns
Promise<void>
index()
index(): Promise<string>;
Defined in: core/knowledgeStore.ts:113
The catalog: every active or superseded page, one line each, by section.
Returns
Promise<string>
list()
list(): Promise<PageInfo[]>;
Defined in: core/knowledgeStore.ts:92
Every page but the retired ones.
Returns
Promise<PageInfo[]>
log()
log(
operation,
what,
pages?
): Promise<void>;
Defined in: core/knowledgeStore.ts:115
Adds an entry to the operation log, dated today.
Parameters
| Parameter | Type |
|---|---|
operation | string |
what | string |
pages? | readonly string[] |
Returns
Promise<void>
overview()
overview(): Promise<string>;
Defined in: core/knowledgeStore.ts:124
The overview: a living synthesis of the whole knowledge base ("" if none yet).
Returns
Promise<string>
read()
read(id): Promise<KnowledgePage | null>;
Defined in: core/knowledgeStore.ts:94
A page, retired ones included; null if there's none.
Parameters
| Parameter | Type |
|---|---|
id | string |
Returns
Promise<KnowledgePage | null>
recentLog()?
optional recentLog(limit?): Promise<string[]>;
Defined in: core/knowledgeStore.ts:120
The latest entries of the operation log, newest first, as markdown (e.g. "## [2026-10-04] ingest | …"). Optional: a store without it can't show the log to the agent.
Parameters
| Parameter | Type |
|---|---|
limit? | number |
Returns
Promise<string[]>
retire()
retire(id, reason): Promise<void>;
Defined in: core/knowledgeStore.ts:109
Takes a page out of the index and the search (it's kept, and can be restored).
Parameters
| Parameter | Type |
|---|---|
id | string |
reason | string |
Returns
Promise<void>
rewrite()
rewrite(
id,
content,
fields?
): Promise<void>;
Defined in: core/knowledgeStore.ts:105
Replaces a page's whole body, keeping its id.
Parameters
| Parameter | Type |
|---|---|
id | string |
content | string |
fields? | FieldChanges |
Returns
Promise<void>
search()
search(query, limit?): Promise<SearchHit[]>;
Defined in: core/knowledgeStore.ts:111
Pages matching words of query in their title, aliases or body, best first.
Parameters
| Parameter | Type |
|---|---|
query | string |
limit? | number |
Returns
Promise<SearchHit[]>
supersede()
supersede(
id,
by,
reason?
): Promise<void>;
Defined in: core/knowledgeStore.ts:107
Marks a page superseded by another, with a notice at its top.
Parameters
| Parameter | Type |
|---|---|
id | string |
by | string |
reason? | string |
Returns
Promise<void>
types()
types(): readonly PageType[];
Defined in: core/knowledgeStore.ts:90
The page types it holds, the kit's and the agent's.
Returns
readonly PageType[]
writeOverview()
writeOverview(content): Promise<void>;
Defined in: core/knowledgeStore.ts:126
Replaces the overview.
Parameters
| Parameter | Type |
|---|---|
content | string |
Returns
Promise<void>