@tangle-network/agent-knowledge 17.0.1 → 17.1.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 17.1.0
+
+- Preserve document identity through reciprocal-rank fusion; same-id pages from different origins can no longer replace matching bytes.
+- Build run-scoped citation handles and graph edges through the existing citation resolver. Unique ids remain unchanged; ambiguous origins are explicit and every returned handle resolves to the page actually ranked.
+- Expose existing invalidation, tag and kind filters to `knowledge_search` without changing its defaults, write intake, or access scope.
+- Share one typed reciprocal-rank fusion implementation between document ranking and the unchanged public string-key helper.
+
+
+## 17.0.3 — 2026-09-20
+
+Allow consumers to install Eval 0.182 or 0.183 alongside Knowledge.
+Run packed-package and official optimizer checks against both releases.
+The development dependency remains 0.182.0.
+
+## 17.0.2 — 2026-09-16
+
+`knowledge_record` documents the complete FILE block grammar and rejects malformed, unsafe, or empty proposals before writing.
+The parser no longer absorbs a later page into an unterminated earlier block.
+Delimiters inside code fences remain page content.
+Direct `applyKnowledgeWriteBlocks` callers retain the explicit partial-result contract and must inspect `written` and `warnings`.
+
 ## 17.0.1 — 2026-09-15
 
 Requires Eval `>=0.182.0 <0.183.0` and tests against 0.182.0.

package/README.md

@@ -9,11 +9,14 @@ Supply application callbacks for those decisions, or use `@tangle-network/agent-
 ## Install
 
 ```bash
-pnpm add @tangle-network/agent-knowledge@17.0.1 @tangle-network/agent-eval@0.182.0 @tangle-network/agent-interface@2.6.0
+pnpm add @tangle-network/agent-knowledge@17.1.0 @tangle-network/agent-eval@0.183.0 @tangle-network/agent-interface@2.10.0
 ```
 
 Requires Node.js 20.19 or later.
 
+Eval 0.182 and 0.183 are supported.
+Package and official optimizer checks exercise both released minors; development remains pinned to 0.182.0.
+
 ## Choose an API
 
 | Goal | Start with | Import |
@@ -196,6 +199,10 @@ const tools = createKnowledgeTools({
 `knowledge_search` builds a brief and mints a retrieval receipt on every call, so retrieval is recorded by the infrastructure rather than claimed by the run.
 `knowledge_read` reports an id visible at two origins as `ambiguous` with both candidates, and never chooses one.
 `knowledge_record` writes into this run's store through the intake gate.
+Each proposal must contain complete `---FILE: <page-path>---` / `---END FILE---` blocks, with delimiters on separate lines.
+The tool rejects malformed, unsafe, or empty proposals before writing any pages.
+It does not report a partial write as tool success.
+The lower-level `applyKnowledgeWriteBlocks` API retains its explicit `written` and `warnings` result for callers that inspect partial proposals.
 `knowledge_resolve` returns the resolution status of each reference.
 
 When a pursuit must preserve every edit for later refinement or branch reconciliation, pass `retainHistory: true`.

package/dist/benchmarks/index.js

@@ -1,2 +1,2 @@
-import { F as buildIndustryRagBenchmarkSmokeCases, H as createNoopMemoryBenchmarkAdapter, I as respondToIndustryMemoryBenchmarkSmokeCase, L as respondToIndustryRagBenchmarkSmokeCase, M as INDUSTRY_RAG_BENCHMARKS, N as buildFirstPartyMemoryLifecycleBenchmarkCases, P as buildIndustryMemoryBenchmarkSmokeCases, R as isKnowledgeMemoryBenchmarkCase, V as createInMemoryBenchmarkAdapter, a as buildKnowledgeBenchmarkScenarios, c as runKnowledgeBenchmarkSuite, d as summarizeKnowledgeBenchmarkCampaign, i as runMemoryAdapterBenchmark, j as INDUSTRY_MEMORY_BENCHMARKS, l as scoreKnowledgeBenchmarkArtifact, n as parseKnowledgeBenchmarkJsonl, o as knowledgeBenchmarkJudge, r as parseKnowledgeBenchmarkQrels, s as renderKnowledgeBenchmarkReportMarkdown, t as buildRetrievalBenchmarkCasesFromQrels, u as scoreMemoryBenchmarkArtifact } from "../benchmarks-BbPJdmHe.js";
+import { F as buildIndustryRagBenchmarkSmokeCases, H as createNoopMemoryBenchmarkAdapter, I as respondToIndustryMemoryBenchmarkSmokeCase, L as respondToIndustryRagBenchmarkSmokeCase, M as INDUSTRY_RAG_BENCHMARKS, N as buildFirstPartyMemoryLifecycleBenchmarkCases, P as buildIndustryMemoryBenchmarkSmokeCases, R as isKnowledgeMemoryBenchmarkCase, V as createInMemoryBenchmarkAdapter, a as buildKnowledgeBenchmarkScenarios, c as runKnowledgeBenchmarkSuite, d as summarizeKnowledgeBenchmarkCampaign, i as runMemoryAdapterBenchmark, j as INDUSTRY_MEMORY_BENCHMARKS, l as scoreKnowledgeBenchmarkArtifact, n as parseKnowledgeBenchmarkJsonl, o as knowledgeBenchmarkJudge, r as parseKnowledgeBenchmarkQrels, s as renderKnowledgeBenchmarkReportMarkdown, t as buildRetrievalBenchmarkCasesFromQrels, u as scoreMemoryBenchmarkArtifact } from "../benchmarks-B3kU-Yxz.js";
 export { INDUSTRY_MEMORY_BENCHMARKS, INDUSTRY_RAG_BENCHMARKS, buildFirstPartyMemoryLifecycleBenchmarkCases, buildIndustryMemoryBenchmarkSmokeCases, buildIndustryRagBenchmarkSmokeCases, buildKnowledgeBenchmarkScenarios, buildRetrievalBenchmarkCasesFromQrels, createInMemoryBenchmarkAdapter, createNoopMemoryBenchmarkAdapter, isKnowledgeMemoryBenchmarkCase, knowledgeBenchmarkJudge, parseKnowledgeBenchmarkJsonl, parseKnowledgeBenchmarkQrels, renderKnowledgeBenchmarkReportMarkdown, respondToIndustryMemoryBenchmarkSmokeCase, respondToIndustryRagBenchmarkSmokeCase, runKnowledgeBenchmarkSuite, runMemoryAdapterBenchmark, scoreKnowledgeBenchmarkArtifact, scoreMemoryBenchmarkArtifact, summarizeKnowledgeBenchmarkCampaign };

package/dist/{benchmarks-BbPJdmHe.js → benchmarks-B3kU-Yxz.js}

@@ -1,5 +1,5 @@
 import { r as stableId, t as sha256 } from "./ids-Bevz_pXV.js";
-import { r as searchKnowledge } from "./search-Cw6eYfSd.js";
+import { r as searchKnowledge } from "./search-Cbyj2shJ.js";
 import { randomUUID } from "node:crypto";
 import { join } from "node:path";
 import { canonicalJson } from "@tangle-network/agent-eval";
@@ -2821,4 +2821,4 @@ function defaultDocumentTarget(documentId, targetKind) {
 //#endregion
 export { reserveRecoveryAttempts as A, rankCandidates as B, sleepForMemoryRecovery as C, hasSettledPaidCall as D, assertNoInterruptedPaidCalls as E, buildIndustryRagBenchmarkSmokeCases as F, buildRetrievalEvalDispatch as G, createNoopMemoryBenchmarkAdapter as H, respondToIndustryMemoryBenchmarkSmokeCase as I, retrievalConfigSurface as J, partitionRetrievalScenarios as K, respondToIndustryRagBenchmarkSmokeCase as L, INDUSTRY_RAG_BENCHMARKS as M, buildFirstPartyMemoryLifecycleBenchmarkCases as N, readActiveAttemptJournal as O, buildIndustryMemoryBenchmarkSmokeCases as P, isKnowledgeMemoryBenchmarkCase as R, runBoundedMemoryLifecycle as S, appendDurableJournalEvent as T, memoryHitToSourceRecord as U, createInMemoryBenchmarkAdapter as V, memoryWriteResultToSourceRecord as W, scoreRetrievalArtifact as X, retrievalRecallJudge as Y, mean as Z, MEMORY_OPERATION_CANCELLATION_TIMEOUT_MS as _, buildKnowledgeBenchmarkScenarios as a, memoryRecoveryDelayMs as b, runKnowledgeBenchmarkSuite as c, summarizeKnowledgeBenchmarkCampaign as d, acquireAgentMemoryRunLease as f, MEMORY_CAMPAIGN_DISPATCH_SHUTDOWN_TIMEOUT_MS as g, DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS as h, runMemoryAdapterBenchmark as i, INDUSTRY_MEMORY_BENCHMARKS as j, reconcileInterruptedMemoryPaidCalls as k, scoreKnowledgeBenchmarkArtifact as l, AgentMemoryLifecycleUnsafeError as m, parseKnowledgeBenchmarkJsonl as n, knowledgeBenchmarkJudge as o, AgentMemoryLifecycleTimeoutError as p, retrievalConfigFromSurface as q, parseKnowledgeBenchmarkQrels as r, renderKnowledgeBenchmarkReportMarkdown as s, buildRetrievalBenchmarkCasesFromQrels as t, scoreMemoryBenchmarkArtifact as u, createBoundedMemoryAdapter as v, appendAttemptJournalEvent as w, resolveMemoryCleanupTimeoutMs as x, createMemoryExecutionPool as y, normalizeUsd as z };
 
-//# sourceMappingURL=benchmarks-BbPJdmHe.js.map
+//# sourceMappingURL=benchmarks-B3kU-Yxz.js.map