Skip to content

Commit 4c26ddf

Browse files
committed
Rename the knowledge plane to green add/find/ask/recent (CL-5224)
Public KnowledgePlane surface is now add, find, ask, recent with principalId and tenantId only. add returns {documentId}, accepts content XOR file via TextExtractor, and share sugar that maps onto the existing ACL path. find defaults green (no evidence unless asked). Old capture/search/timeline names are gone from the package export; HTTP routes still use legacy paths and grant verbs until CL-5225.
1 parent ee8cf7d commit 4c26ddf

7 files changed

Lines changed: 832 additions & 133 deletions

File tree

‎src/index.ts‎

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ export type { EngineConfig } from "./config.ts";
2828
export { RerankConfigError } from "./core/rerank-client.ts";
2929
// Knowledge plane
3030
//
31-
// `createKnowledgePlane` is exported so a host can capture or search outside a
31+
// `createKnowledgePlane` is exported so a host can add or find outside a
3232
// request — a CLI seeder, a batch ingester, or a test — without standing up a
3333
// Hono app just to get a plane. Callers acting on behalf of a user are
3434
// responsible for the capability check `requireGrant` would have performed; see
@@ -39,15 +39,21 @@ export type {
3939
AskCitation,
4040
AskResult,
4141
ChatMessage,
42+
FindItem,
43+
FindResult,
4244
Generate,
4345
HybridSearchResult,
46+
KnowledgeAddParams,
47+
KnowledgeAddResult,
4448
KnowledgeAskParams,
45-
KnowledgeCaptureParams,
49+
KnowledgeFindParams,
4650
KnowledgeIdentity,
4751
KnowledgePlane,
4852
KnowledgePlaneOptions,
49-
KnowledgeSearchParams,
53+
KnowledgeRecentParams,
54+
KnowledgeShare,
5055
SearchHit,
56+
TextExtractor,
5157
TimelineEvent,
5258
VisibilitySpec,
5359
} from "./knowledge.ts";
@@ -83,7 +89,7 @@ export type MountKnowledgeEngineOptions = {
8389
*/
8490
grants: GrantConfig;
8591
/**
86-
* How `ask()` reaches a model. Omit if this host only captures and searches;
92+
* How `ask()` reaches a model. Omit if this host only adds and finds;
8793
* `ask()` then fails with a 501 naming what is missing.
8894
*
8995
* The engine owns no generation client on purpose — Interchange's

0 commit comments

Comments
 (0)