@yolk-sdk/knowledge 0.0.1-canary.7 → 0.0.1-canary.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -3
- package/dist/ingestion.d.mts +4 -4
- package/dist/records.d.mts +4 -4
- package/dist/records.mjs +1 -1
- package/dist/records.mjs.map +1 -1
- package/dist/search.d.mts +1 -1
- package/dist/search.d.mts.map +1 -1
- package/package.json +2 -2
- package/src/records.ts +1 -1
package/README.md
CHANGED
|
@@ -64,7 +64,7 @@ Search APIs use canonical search naming. Removed retrieval APIs are intentionall
|
|
|
64
64
|
| Provenance | Source metadata explaining where knowledge came from and how it was produced. |
|
|
65
65
|
| Link | Typed relationship between knowledge records. |
|
|
66
66
|
| Context | Model-ready knowledge selected for a run. Built from host policy. |
|
|
67
|
-
| Context policy | Host intent for use: `pinned`, `routable`, `searchable`, or `
|
|
67
|
+
| Context policy | Host intent for use: `pinned`, `routable`, `searchable`, or `archived`. |
|
|
68
68
|
| Search index | Searchable corpus built from source documents, chunks, embeddings, and metadata. |
|
|
69
69
|
| Collection | Named searchable document group with shared embedding and chunking config. |
|
|
70
70
|
| Document | Source item tracked through search ingestion: pending, processing, ready, or error. |
|
|
@@ -90,14 +90,14 @@ Search APIs use canonical search naming. Removed retrieval APIs are intentionall
|
|
|
90
90
|
| `pinned` | Host may inject into model startup context |
|
|
91
91
|
| `routable` | Host may use for routing/dispatch decisions |
|
|
92
92
|
| `searchable` | Host may expose through search tools |
|
|
93
|
-
| `
|
|
93
|
+
| `archived` | Retained but normally omitted from active context/search |
|
|
94
94
|
|
|
95
95
|
## Host responsibilities
|
|
96
96
|
|
|
97
97
|
- Own users, teams, permissions, routing, and product policy.
|
|
98
98
|
- Implement `KnowledgeStore` and `KnowledgeArtifactStore` with app storage.
|
|
99
99
|
- Own concrete extraction, embeddings, search ingestion, R2/S3 layout, and DB schema.
|
|
100
|
-
- Decide which knowledge is pinned, searchable, routable, or
|
|
100
|
+
- Decide which knowledge is pinned, searchable, routable, or archived.
|
|
101
101
|
|
|
102
102
|
## Boundaries
|
|
103
103
|
|
package/dist/ingestion.d.mts
CHANGED
|
@@ -19,8 +19,8 @@ declare const ingestKnowledgeDocument: (input: IngestKnowledgeDocumentInput) =>
|
|
|
19
19
|
readonly source: {
|
|
20
20
|
readonly _tag: "File";
|
|
21
21
|
readonly ref: string;
|
|
22
|
-
readonly mediaType?: string | undefined;
|
|
23
22
|
readonly name?: string | undefined;
|
|
23
|
+
readonly mediaType?: string | undefined;
|
|
24
24
|
} | {
|
|
25
25
|
readonly _tag: "Url";
|
|
26
26
|
readonly url: string;
|
|
@@ -28,17 +28,17 @@ declare const ingestKnowledgeDocument: (input: IngestKnowledgeDocumentInput) =>
|
|
|
28
28
|
readonly _tag: "Text";
|
|
29
29
|
readonly label?: string | undefined;
|
|
30
30
|
};
|
|
31
|
-
readonly status: "
|
|
31
|
+
readonly status: "pending" | "processing" | "ready" | "error";
|
|
32
32
|
readonly metadata?: {
|
|
33
33
|
readonly [x: string]: unknown;
|
|
34
34
|
} | undefined;
|
|
35
35
|
readonly tokenCount?: number | undefined;
|
|
36
|
-
readonly summary?: string | undefined;
|
|
37
36
|
readonly title?: string | undefined;
|
|
37
|
+
readonly summary?: string | undefined;
|
|
38
38
|
readonly errorMessage?: string | undefined;
|
|
39
39
|
readonly contentHash?: string | undefined;
|
|
40
40
|
readonly chunkCount?: number | undefined;
|
|
41
|
-
}, KnowledgeIngestionError,
|
|
41
|
+
}, KnowledgeIngestionError, SearchIndexStore | KnowledgeEmbedder | KnowledgeChunker | KnowledgeExtractor | KnowledgeSummarizer>;
|
|
42
42
|
type KnowledgeIngestionPipeline = {
|
|
43
43
|
readonly ingest: (input: IngestKnowledgeDocumentInput) => ReturnType<typeof ingestKnowledgeDocument>;
|
|
44
44
|
};
|
package/dist/records.d.mts
CHANGED
|
@@ -8,7 +8,7 @@ declare const KnowledgeMetadataSchema: Schema.$Record<Schema.String, Schema.Unkn
|
|
|
8
8
|
type KnowledgeMetadata = Schema.Schema.Type<typeof KnowledgeMetadataSchema>;
|
|
9
9
|
declare const KnowledgeRecordRoleSchema: Schema.Literals<readonly ["source", "note", "operating_protocol", "knowledge_map", "compiled_truth", "decision"]>;
|
|
10
10
|
type KnowledgeRecordRole = Schema.Schema.Type<typeof KnowledgeRecordRoleSchema>;
|
|
11
|
-
declare const KnowledgeContextPolicySchema: Schema.Literals<readonly ["pinned", "routable", "searchable", "
|
|
11
|
+
declare const KnowledgeContextPolicySchema: Schema.Literals<readonly ["pinned", "routable", "searchable", "archived"]>;
|
|
12
12
|
type KnowledgeContextPolicy = Schema.Schema.Type<typeof KnowledgeContextPolicySchema>;
|
|
13
13
|
declare const KnowledgeLifecycleStatusSchema: Schema.Literals<readonly ["draft", "processing", "ready", "error", "archived", "deleted"]>;
|
|
14
14
|
type KnowledgeLifecycleStatus = Schema.Schema.Type<typeof KnowledgeLifecycleStatusSchema>;
|
|
@@ -22,7 +22,7 @@ declare const KnowledgeRecordSchema: Schema.Struct<{
|
|
|
22
22
|
readonly role: Schema.Literals<readonly ["source", "note", "operating_protocol", "knowledge_map", "compiled_truth", "decision"]>;
|
|
23
23
|
readonly title: Schema.Trimmed;
|
|
24
24
|
readonly status: Schema.Literals<readonly ["draft", "processing", "ready", "error", "archived", "deleted"]>;
|
|
25
|
-
readonly contextPolicy: Schema.Literals<readonly ["pinned", "routable", "searchable", "
|
|
25
|
+
readonly contextPolicy: Schema.Literals<readonly ["pinned", "routable", "searchable", "archived"]>;
|
|
26
26
|
readonly summary: Schema.optional<Schema.String>;
|
|
27
27
|
readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
|
|
28
28
|
readonly createdAt: Schema.DateTimeUtc;
|
|
@@ -36,7 +36,7 @@ declare const CreateKnowledgeRecordInputSchema: Schema.Struct<{
|
|
|
36
36
|
}>;
|
|
37
37
|
readonly role: Schema.Literals<readonly ["source", "note", "operating_protocol", "knowledge_map", "compiled_truth", "decision"]>;
|
|
38
38
|
readonly title: Schema.Trimmed;
|
|
39
|
-
readonly contextPolicy: Schema.Literals<readonly ["pinned", "routable", "searchable", "
|
|
39
|
+
readonly contextPolicy: Schema.Literals<readonly ["pinned", "routable", "searchable", "archived"]>;
|
|
40
40
|
readonly summary: Schema.optional<Schema.String>;
|
|
41
41
|
readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
|
|
42
42
|
}>;
|
|
@@ -49,7 +49,7 @@ declare const UpdateKnowledgeRecordInputSchema: Schema.Struct<{
|
|
|
49
49
|
readonly id: Schema.Trimmed;
|
|
50
50
|
readonly title: Schema.optional<Schema.Trimmed>;
|
|
51
51
|
readonly status: Schema.optional<Schema.Literals<readonly ["draft", "processing", "ready", "error", "archived", "deleted"]>>;
|
|
52
|
-
readonly contextPolicy: Schema.optional<Schema.Literals<readonly ["pinned", "routable", "searchable", "
|
|
52
|
+
readonly contextPolicy: Schema.optional<Schema.Literals<readonly ["pinned", "routable", "searchable", "archived"]>>;
|
|
53
53
|
readonly summary: Schema.optional<Schema.String>;
|
|
54
54
|
readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
|
|
55
55
|
}>;
|
package/dist/records.mjs
CHANGED
package/dist/records.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"records.mjs","names":[],"sources":["../src/records.ts"],"sourcesContent":["import * as Schema from 'effect/Schema'\n\nexport const NonEmptyTrimmedString = Schema.Trimmed.pipe(Schema.check(Schema.isNonEmpty()))\nexport const NonNegativeInteger = Schema.Int.pipe(Schema.check(Schema.isGreaterThanOrEqualTo(0)))\nexport const PositiveInteger = Schema.Int.pipe(Schema.check(Schema.isGreaterThan(0)))\n\nexport const KnowledgeMetadataSchema = Schema.Record(Schema.String, Schema.Unknown)\nexport type KnowledgeMetadata = Schema.Schema.Type<typeof KnowledgeMetadataSchema>\n\nexport const KnowledgeRecordRoleSchema = Schema.Literals([\n 'source',\n 'note',\n 'operating_protocol',\n 'knowledge_map',\n 'compiled_truth',\n 'decision'\n])\nexport type KnowledgeRecordRole = Schema.Schema.Type<typeof KnowledgeRecordRoleSchema>\n\nexport const KnowledgeContextPolicySchema = Schema.Literals([\n 'pinned',\n 'routable',\n 'searchable',\n '
|
|
1
|
+
{"version":3,"file":"records.mjs","names":[],"sources":["../src/records.ts"],"sourcesContent":["import * as Schema from 'effect/Schema'\n\nexport const NonEmptyTrimmedString = Schema.Trimmed.pipe(Schema.check(Schema.isNonEmpty()))\nexport const NonNegativeInteger = Schema.Int.pipe(Schema.check(Schema.isGreaterThanOrEqualTo(0)))\nexport const PositiveInteger = Schema.Int.pipe(Schema.check(Schema.isGreaterThan(0)))\n\nexport const KnowledgeMetadataSchema = Schema.Record(Schema.String, Schema.Unknown)\nexport type KnowledgeMetadata = Schema.Schema.Type<typeof KnowledgeMetadataSchema>\n\nexport const KnowledgeRecordRoleSchema = Schema.Literals([\n 'source',\n 'note',\n 'operating_protocol',\n 'knowledge_map',\n 'compiled_truth',\n 'decision'\n])\nexport type KnowledgeRecordRole = Schema.Schema.Type<typeof KnowledgeRecordRoleSchema>\n\nexport const KnowledgeContextPolicySchema = Schema.Literals([\n 'pinned',\n 'routable',\n 'searchable',\n 'archived'\n])\nexport type KnowledgeContextPolicy = Schema.Schema.Type<typeof KnowledgeContextPolicySchema>\n\nexport const KnowledgeLifecycleStatusSchema = Schema.Literals([\n 'draft',\n 'processing',\n 'ready',\n 'error',\n 'archived',\n 'deleted'\n])\nexport type KnowledgeLifecycleStatus = Schema.Schema.Type<typeof KnowledgeLifecycleStatusSchema>\n\nexport const KnowledgeScopeSchema = Schema.Struct({\n id: NonEmptyTrimmedString,\n kind: Schema.optional(NonEmptyTrimmedString)\n})\nexport type KnowledgeScope = Schema.Schema.Type<typeof KnowledgeScopeSchema>\n\nexport const KnowledgeRecordSchema = Schema.Struct({\n id: NonEmptyTrimmedString,\n role: KnowledgeRecordRoleSchema,\n title: NonEmptyTrimmedString,\n status: KnowledgeLifecycleStatusSchema,\n contextPolicy: KnowledgeContextPolicySchema,\n summary: Schema.optional(Schema.String),\n metadata: Schema.optional(KnowledgeMetadataSchema),\n createdAt: Schema.DateTimeUtc,\n updatedAt: Schema.DateTimeUtc\n})\nexport type KnowledgeRecord = Schema.Schema.Type<typeof KnowledgeRecordSchema>\n\nexport const CreateKnowledgeRecordInputSchema = Schema.Struct({\n scope: KnowledgeScopeSchema,\n role: KnowledgeRecordRoleSchema,\n title: NonEmptyTrimmedString,\n contextPolicy: KnowledgeContextPolicySchema,\n summary: Schema.optional(Schema.String),\n metadata: Schema.optional(KnowledgeMetadataSchema)\n})\nexport type CreateKnowledgeRecordInput = Schema.Schema.Type<typeof CreateKnowledgeRecordInputSchema>\n\nexport const UpdateKnowledgeRecordInputSchema = Schema.Struct({\n scope: KnowledgeScopeSchema,\n id: NonEmptyTrimmedString,\n title: Schema.optional(NonEmptyTrimmedString),\n status: Schema.optional(KnowledgeLifecycleStatusSchema),\n contextPolicy: Schema.optional(KnowledgeContextPolicySchema),\n summary: Schema.optional(Schema.String),\n metadata: Schema.optional(KnowledgeMetadataSchema)\n})\nexport type UpdateKnowledgeRecordInput = Schema.Schema.Type<typeof UpdateKnowledgeRecordInputSchema>\n"],"mappings":";;AAEA,MAAa,wBAAwB,OAAO,QAAQ,KAAK,OAAO,MAAM,OAAO,WAAW,CAAC,CAAC;AAC1F,MAAa,qBAAqB,OAAO,IAAI,KAAK,OAAO,MAAM,OAAO,uBAAuB,CAAC,CAAC,CAAC;AAChG,MAAa,kBAAkB,OAAO,IAAI,KAAK,OAAO,MAAM,OAAO,cAAc,CAAC,CAAC,CAAC;AAEpF,MAAa,0BAA0B,OAAO,OAAO,OAAO,QAAQ,OAAO,OAAO;AAGlF,MAAa,4BAA4B,OAAO,SAAS;CACvD;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAGD,MAAa,+BAA+B,OAAO,SAAS;CAC1D;CACA;CACA;CACA;AACF,CAAC;AAGD,MAAa,iCAAiC,OAAO,SAAS;CAC5D;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAGD,MAAa,uBAAuB,OAAO,OAAO;CAChD,IAAI;CACJ,MAAM,OAAO,SAAS,qBAAqB;AAC7C,CAAC;AAGD,MAAa,wBAAwB,OAAO,OAAO;CACjD,IAAI;CACJ,MAAM;CACN,OAAO;CACP,QAAQ;CACR,eAAe;CACf,SAAS,OAAO,SAAS,OAAO,MAAM;CACtC,UAAU,OAAO,SAAS,uBAAuB;CACjD,WAAW,OAAO;CAClB,WAAW,OAAO;AACpB,CAAC;AAGD,MAAa,mCAAmC,OAAO,OAAO;CAC5D,OAAO;CACP,MAAM;CACN,OAAO;CACP,eAAe;CACf,SAAS,OAAO,SAAS,OAAO,MAAM;CACtC,UAAU,OAAO,SAAS,uBAAuB;AACnD,CAAC;AAGD,MAAa,mCAAmC,OAAO,OAAO;CAC5D,OAAO;CACP,IAAI;CACJ,OAAO,OAAO,SAAS,qBAAqB;CAC5C,QAAQ,OAAO,SAAS,8BAA8B;CACtD,eAAe,OAAO,SAAS,4BAA4B;CAC3D,SAAS,OAAO,SAAS,OAAO,MAAM;CACtC,UAAU,OAAO,SAAS,uBAAuB;AACnD,CAAC"}
|
package/dist/search.d.mts
CHANGED
|
@@ -43,7 +43,7 @@ declare const fuseKnowledgeSearchResults: (input: {
|
|
|
43
43
|
readonly limit: number;
|
|
44
44
|
readonly rankConstant?: number;
|
|
45
45
|
}) => ReadonlyArray<KnowledgeSearchResult>;
|
|
46
|
-
declare const searchKnowledge: (input: KnowledgeSearchInput) => Effect.Effect<readonly KnowledgeSearchResult[], KnowledgeSearchError,
|
|
46
|
+
declare const searchKnowledge: (input: KnowledgeSearchInput) => Effect.Effect<readonly KnowledgeSearchResult[], KnowledgeSearchError, SearchIndexStore | KnowledgeEmbedder>;
|
|
47
47
|
//#endregion
|
|
48
48
|
export { KnowledgeSearchContext, KnowledgeSearchInput, KnowledgeSearchMode, KnowledgeSearchResult, KnowledgeSearchScores, KnowledgeSearcher, fuseKnowledgeSearchResults, packKnowledgeSearchContext, searchKnowledge };
|
|
49
49
|
//# sourceMappingURL=search.d.mts.map
|
package/dist/search.d.mts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search.d.mts","names":[],"sources":["../src/search.ts"],"mappings":";;;;;;;KAMY,oBAAA;EAAA,SACD,KAAA,EAAO,oBAAA;EAAA,SACP,KAAA;EAAA,SACA,KAAA;EAAA,SACA,QAAA;EAAA,SACA,aAAA;EAAA,SACA,IAAA,GAAO,mBAAmB;EAAA,SAC1B,WAAA;EAAA,SACA,SAAA;AAAA;AAAA,KAGC,mBAAA;AAAA,KAEA,qBAAA;EAAA,SACD,MAAA;EAAA,SACA,IAAA;EAAA,SACA,KAAA;AAAA;AAAA,KAGC,qBAAA;EAAA,SACD,KAAA,EAAO,cAAA;EAAA,SACP,KAAA;EAAA,SACA,QAAA,EAAU,iBAAA;EAAA,SACV,OAAA,GAAU,aAAA,CAAc,cAAA;EAAA,SACxB,MAAA,GAAS,qBAAA;AAAA;AAAA,KAGR,sBAAA;EAAA,SACD,KAAA;EAAA,SACA,OAAA,EAAS,aAAa,CAAC,qBAAA;EAAA,SACvB,IAAA;AAAA;AAAA,KAGC,iBAAA;EAAA,SACD,MAAA,GACP,KAAA,EAAO,oBAAA,KACJ,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,qBAAA,GAAwB,oBAAA;AAAA;AAAA,cAM9C,0BAAA,GAA8B,KAAA,UAAe,OAAA,EAAS,aAAA,CAAc,qBAAA,MAAyB,sBAAA;AAAA,cAoB7F,0BAAA,GAA8B,KAAA;EAAA,SAChC,aAAA,EAAe,aAAA,CAAc,qBAAA;EAAA,SAC7B,WAAA,EAAa,aAAA,CAAc,qBAAA;EAAA,SAC3B,KAAA;EAAA,SACA,YAAA;AAAA,MACP,aAAA,CAAc,qBAAA;AAAA,cAsIL,eAAA,GAAmB,KAAA,EAAO,oBAAA,KAAoB,MAAA,CAAA,MAAA,UAAA,qBAAA,IAAA,oBAAA,EAAA,
|
|
1
|
+
{"version":3,"file":"search.d.mts","names":[],"sources":["../src/search.ts"],"mappings":";;;;;;;KAMY,oBAAA;EAAA,SACD,KAAA,EAAO,oBAAA;EAAA,SACP,KAAA;EAAA,SACA,KAAA;EAAA,SACA,QAAA;EAAA,SACA,aAAA;EAAA,SACA,IAAA,GAAO,mBAAmB;EAAA,SAC1B,WAAA;EAAA,SACA,SAAA;AAAA;AAAA,KAGC,mBAAA;AAAA,KAEA,qBAAA;EAAA,SACD,MAAA;EAAA,SACA,IAAA;EAAA,SACA,KAAA;AAAA;AAAA,KAGC,qBAAA;EAAA,SACD,KAAA,EAAO,cAAA;EAAA,SACP,KAAA;EAAA,SACA,QAAA,EAAU,iBAAA;EAAA,SACV,OAAA,GAAU,aAAA,CAAc,cAAA;EAAA,SACxB,MAAA,GAAS,qBAAA;AAAA;AAAA,KAGR,sBAAA;EAAA,SACD,KAAA;EAAA,SACA,OAAA,EAAS,aAAa,CAAC,qBAAA;EAAA,SACvB,IAAA;AAAA;AAAA,KAGC,iBAAA;EAAA,SACD,MAAA,GACP,KAAA,EAAO,oBAAA,KACJ,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,qBAAA,GAAwB,oBAAA;AAAA;AAAA,cAM9C,0BAAA,GAA8B,KAAA,UAAe,OAAA,EAAS,aAAA,CAAc,qBAAA,MAAyB,sBAAA;AAAA,cAoB7F,0BAAA,GAA8B,KAAA;EAAA,SAChC,aAAA,EAAe,aAAA,CAAc,qBAAA;EAAA,SAC7B,WAAA,EAAa,aAAA,CAAc,qBAAA;EAAA,SAC3B,KAAA;EAAA,SACA,YAAA;AAAA,MACP,aAAA,CAAc,qBAAA;AAAA,cAsIL,eAAA,GAAmB,KAAA,EAAO,oBAAA,KAAoB,MAAA,CAAA,MAAA,UAAA,qBAAA,IAAA,oBAAA,EAAA,gBAAA,GAAA,iBAAA"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@yolk-sdk/knowledge",
|
|
3
|
-
"version": "0.0.1-canary.
|
|
3
|
+
"version": "0.0.1-canary.9",
|
|
4
4
|
"description": "Domain-free knowledge record, artifact, search, provenance, and context contracts for Yolk agents.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -136,7 +136,7 @@
|
|
|
136
136
|
"dependencies": {
|
|
137
137
|
"effect": "4.0.0-beta.65",
|
|
138
138
|
"gpt-tokenizer": "^3.4.0",
|
|
139
|
-
"@yolk-sdk/agent": "^0.0.1-canary.
|
|
139
|
+
"@yolk-sdk/agent": "^0.0.1-canary.9"
|
|
140
140
|
},
|
|
141
141
|
"scripts": {
|
|
142
142
|
"build": "tsdown",
|
package/src/records.ts
CHANGED