@tangle-network/agent-knowledge 3.2.0 → 4.0.0

package/dist/index.d.ts

@@ -4,12 +4,11 @@ import { KnowledgeRequirementCategory, KnowledgeAcquisitionMode, KnowledgeImport
 import { AgentImprovementActivation, AgentImprovementActivationResult, AgentCandidateKnowledgeRef } from '@tangle-network/agent-interface';
 import { z } from 'zod';
 import { JsonValue, Scenario, JudgeConfig } from '@tangle-network/agent-eval/campaign';
-import { R as RunRetrievalImprovementLoopResult, a as RunRetrievalImprovementLoopOptions } from './index-BHQk7jOT.js';
-export { B as BuildRetrievalBenchmarkCasesFromQrelsOptions, b as BuildRetrievalEvalDispatchOptions, c as BuildRetrievalParameterCandidatesOptions, I as INDUSTRY_MEMORY_BENCHMARKS, d as INDUSTRY_RAG_BENCHMARKS, K as KnowledgeAnswerBenchmarkCase, e as KnowledgeAnswerBenchmarkTaskKind, f as KnowledgeBenchmarkArtifact, g as KnowledgeBenchmarkCase, h as KnowledgeBenchmarkCaseBase, i as KnowledgeBenchmarkDistribution, j as KnowledgeBenchmarkEvaluation, k as KnowledgeBenchmarkFamily, l as KnowledgeBenchmarkReport, m as KnowledgeBenchmarkResponder, n as KnowledgeBenchmarkScenario, o as KnowledgeBenchmarkSliceSummary, p as KnowledgeBenchmarkSource, q as KnowledgeBenchmarkSpec, r as KnowledgeBenchmarkSplit, s as KnowledgeBenchmarkTaskKind, t as KnowledgeClaimMatcher, u as KnowledgeMemoryBenchmarkCase, v as KnowledgeMemoryBenchmarkTaskKind, w as KnowledgeMemoryEvent, x as KnowledgeMemoryFactMatcher, y as KnowledgeRetrievalBenchmarkCase, z as KnowledgeRetrievalBenchmarkQrel, A as KnowledgeRetrievalBenchmarkQuery, M as MemoryAdapterBenchmarkCandidate, C as MemoryAdapterBenchmarkRankingRow, D as RetrievalConfig, E as RetrievalEvalArtifact, F as RetrievalEvalRetriever, G as RetrievalEvalRetrieverInput, H as RetrievalEvalRetrieverResult, J as RetrievalEvalScenario, L as RetrievalGoldTarget, N as RetrievalMetricSummary, O as RetrievalMetricWeights, P as RetrievalParameterSearchSpace, Q as RetrievalParameterSweepProposerOptions, S as RetrievalRecallJudgeOptions, T as RetrievedKnowledgeHit, U as RetrievedSourceSpan, V as RunKnowledgeBenchmarkSuiteOptions, W as RunKnowledgeBenchmarkSuiteResult, X as RunMemoryAdapterBenchmarkOptions, Y as RunMemoryAdapterBenchmarkResult, Z as buildFirstPartyMemoryLifecycleBenchmarkCases, _ as buildIndustryMemoryBenchmarkSmokeCases, $ as buildIndustryRagBenchmarkSmokeCases, a0 as buildKnowledgeBenchmarkScenarios, a1 as buildRetrievalBenchmarkCasesFromQrels, a2 as buildRetrievalEvalDispatch, a3 as buildRetrievalParameterCandidates, a4 as createInMemoryBenchmarkAdapter, a5 as createMemoryAdapterBenchmarkResponder, a6 as createNoopMemoryBenchmarkAdapter, a7 as isKnowledgeMemoryBenchmarkCase, a8 as knowledgeBenchmarkJudge, a9 as parseKnowledgeBenchmarkJsonl, aa as parseKnowledgeBenchmarkQrels, ab as renderKnowledgeBenchmarkReportMarkdown, ac as respondToIndustryMemoryBenchmarkSmokeCase, ad as respondToIndustryRagBenchmarkSmokeCase, ae as retrievalConfigFromSurface, af as retrievalConfigSurface, ag as retrievalParameterSweepProposer, ah as retrievalRecallJudge, ai as runKnowledgeBenchmarkSuite, aj as runMemoryAdapterBenchmark, ak as runRetrievalImprovementLoop, al as scoreKnowledgeBenchmarkArtifact, am as scoreMemoryBenchmarkArtifact, an as scoreRetrievalArtifact, ao as summarizeKnowledgeBenchmarkCampaign } from './index-BHQk7jOT.js';
+import { R as RunRetrievalImprovementLoopResult, a as RunRetrievalImprovementLoopOptions } from './index-Bqg1mBPt.js';
+export { A as AgentMemoryAcquireRunLease, b as AgentMemoryAdapter, c as AgentMemoryBranchIsolation, d as AgentMemoryContext, e as AgentMemoryControllerMode, f as AgentMemoryHit, g as AgentMemoryKind, h as AgentMemoryRunLease, i as AgentMemoryScope, j as AgentMemorySearchOptions, k as AgentMemoryWriteInput, l as AgentMemoryWriteResult, B as BuildRetrievalBenchmarkCasesFromQrelsOptions, m as BuildRetrievalEvalDispatchOptions, n as BuildRetrievalParameterCandidatesOptions, I as INDUSTRY_MEMORY_BENCHMARKS, o as INDUSTRY_RAG_BENCHMARKS, K as KnowledgeAnswerBenchmarkCase, p as KnowledgeAnswerBenchmarkTaskKind, q as KnowledgeBenchmarkArtifact, r as KnowledgeBenchmarkCase, s as KnowledgeBenchmarkCaseBase, t as KnowledgeBenchmarkDistribution, u as KnowledgeBenchmarkEvaluation, v as KnowledgeBenchmarkFamily, w as KnowledgeBenchmarkReport, x as KnowledgeBenchmarkResponder, y as KnowledgeBenchmarkScenario, z as KnowledgeBenchmarkSliceSummary, C as KnowledgeBenchmarkSource, D as KnowledgeBenchmarkSpec, E as KnowledgeBenchmarkSplit, F as KnowledgeBenchmarkTaskKind, G as KnowledgeClaimMatcher, H as KnowledgeMemoryBenchmarkCase, J as KnowledgeMemoryBenchmarkTaskKind, L as KnowledgeMemoryEvent, M as KnowledgeMemoryFactMatcher, N as KnowledgeRetrievalBenchmarkCase, O as KnowledgeRetrievalBenchmarkQrel, P as KnowledgeRetrievalBenchmarkQuery, Q as MemoryAdapterBenchmarkCandidate, S as MemoryAdapterBenchmarkRankingRow, T as OwnedAgentMemoryRunLease, U as RetrievalConfig, V as RetrievalEvalArtifact, W as RetrievalEvalRetriever, X as RetrievalEvalRetrieverInput, Y as RetrievalEvalRetrieverResult, Z as RetrievalEvalScenario, _ as RetrievalGoldTarget, $ as RetrievalHoldoutBypassReason, a0 as RetrievalHoldoutCallContext, a1 as RetrievalHoldoutConfig, a2 as RetrievalHoldoutEligibleItem, a3 as RetrievalHoldoutEvent, a4 as RetrievalHoldoutOffPolicyOptions, a5 as RetrievalHoldoutOffPolicyResult, a6 as RetrievalHoldoutResult, a7 as RetrievalHoldoutSessionState, a8 as RetrievalHoldoutSessionSummary, a9 as RetrievalMetricSummary, aa as RetrievalMetricWeights, ab as RetrievalParameterSearchSpace, ac as RetrievalParameterSweepProposerOptions, ad as RetrievalRecallJudgeOptions, ae as RetrievedKnowledgeHit, af as RetrievedSourceSpan, ag as RunKnowledgeBenchmarkSuiteOptions, ah as RunKnowledgeBenchmarkSuiteResult, ai as RunMemoryAdapterBenchmarkOptions, aj as RunMemoryAdapterBenchmarkResult, ak as acquireAgentMemoryRunLease, al as applyRetrievalHoldout, am as applySessionStickyRetrievalHoldout, an as buildFirstPartyMemoryLifecycleBenchmarkCases, ao as buildIndustryMemoryBenchmarkSmokeCases, ap as buildIndustryRagBenchmarkSmokeCases, aq as buildKnowledgeBenchmarkScenarios, ar as buildRetrievalBenchmarkCasesFromQrels, as as buildRetrievalEvalDispatch, at as buildRetrievalParameterCandidates, au as createInMemoryBenchmarkAdapter, av as createNoopMemoryBenchmarkAdapter, aw as deterministicRng, ax as emitRetrievalHoldoutBypass, ay as isKnowledgeMemoryBenchmarkCase, az as knowledgeBenchmarkJudge, aA as parseKnowledgeBenchmarkJsonl, aB as parseKnowledgeBenchmarkQrels, aC as renderKnowledgeBenchmarkReportMarkdown, aD as resetRetrievalHoldoutRegistry, aE as respondToIndustryMemoryBenchmarkSmokeCase, aF as respondToIndustryRagBenchmarkSmokeCase, aG as retrievalConfigFromSurface, aH as retrievalConfigSurface, aI as retrievalHoldoutConfigHash, aJ as retrievalParameterSweepProposer, aK as retrievalRecallJudge, aL as runKnowledgeBenchmarkSuite, aM as runMemoryAdapterBenchmark, aN as runRetrievalImprovementLoop, aO as scoreKnowledgeBenchmarkArtifact, aP as scoreMemoryBenchmarkArtifact, aQ as scoreRetrievalArtifact, aR as summarizeKnowledgeBenchmarkCampaign, aS as toOffPolicyTrajectory } from './index-Bqg1mBPt.js';
 import { KnowledgeFragment } from './sources/index.js';
 export { CornellLiiSelector, CornellLiiSourceOptions, FetchOpts, FragmentProvenance, IRS_DIMENSION_HINTS, IrsPublicationsSourceOptions, KnowledgeSource, MAX_RESPONSE_BYTES, MIN_REQUEST_GAP_MS, POLITE_USER_AGENT, PoliteFetchOptions, PoliteFetchResult, StateSosEntity, StateSosSourceConfig, __resetHttpThrottle, createCornellLiiSource, createIrsPublicationsSource, createStateSosSource, extractLinks, firstMatch, htmlToText, innerHtmlById, looksLikeBlockPage, politeFetch } from './sources/index.js';
-export { AgentMemoryHitSchema, AgentMemoryKindSchema, AgentMemoryScopeSchema, AgentMemoryWriteInputSchema, Neo4jAgentMemoryAdapterOptions, createNeo4jAgentMemoryAdapter, defaultGetMemoryContext, memoryHitToSourceRecord, memoryWriteResultToSourceRecord, renderMemoryContext } from './memory/index.js';
-export { A as AgentMemoryAdapter, b as AgentMemoryContext, c as AgentMemoryHit, d as AgentMemoryKind, a as AgentMemoryScope, e as AgentMemorySearchOptions, f as AgentMemoryWriteInput, g as AgentMemoryWriteResult, R as RetrievalHoldoutBypassReason, h as RetrievalHoldoutCallContext, i as RetrievalHoldoutConfig, j as RetrievalHoldoutEligibleItem, k as RetrievalHoldoutEvent, l as RetrievalHoldoutOffPolicyOptions, m as RetrievalHoldoutOffPolicyResult, n as RetrievalHoldoutResult, o as RetrievalHoldoutSessionState, p as RetrievalHoldoutSessionSummary, q as applyRetrievalHoldout, r as applySessionStickyRetrievalHoldout, s as deterministicRng, t as emitRetrievalHoldoutBypass, u as resetRetrievalHoldoutRegistry, v as retrievalHoldoutConfigHash, w as toOffPolicyTrajectory } from './types-BFRyr390.js';
+export { AgentMemoryActivation, AgentMemoryActivationDriver, AgentMemoryAttemptEvent, AgentMemoryBranch, AgentMemoryBranchLifetime, AgentMemoryBranchSnapshot, AgentMemoryDimensionComparison, AgentMemoryExperimentCandidate, AgentMemoryExperimentRankingRow, AgentMemoryExperimentRunLease, AgentMemoryGovernor, AgentMemoryHitSchema, AgentMemoryImprovementRunLease, AgentMemoryImprovementSeed, AgentMemoryJournalEntry, AgentMemoryKindSchema, AgentMemoryLifecycleTimeoutError, AgentMemoryLifecycleUnsafeError, AgentMemoryPromotionDecision, AgentMemoryScopeSchema, AgentMemorySequence, AgentMemorySequenceArtifact, AgentMemorySequenceProbe, AgentMemorySequenceProbeResult, AgentMemorySequenceScenario, AgentMemorySequenceStep, AgentMemorySharingPolicy, AgentMemoryVisibility, AgentMemoryWriteInputSchema, BuildAgentMemorySequencesFromBenchmarkCasesOptions, CreateAgentMemoryBranchOptions, DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, ForkAgentMemoryBranchSnapshotOptions, GraphitiMcpClientLike, GraphitiMemoryAdapterOptions, GraphitiToolNames, Mem0ClientLike, Mem0ClientMode, Mem0MemoryAdapterOptions, Neo4jAgentMemoryAdapterOptions, RunAgentMemoryExperimentOptions, RunAgentMemoryExperimentResult, RunAgentMemoryImprovementOptions, RunAgentMemoryImprovementResult, agentMemorySequenceJudge, buildAgentMemorySequenceScenarios, buildAgentMemorySequencesFromBenchmarkCases, createAgentMemoryBranch, createGraphitiMemoryAdapter, createMem0MemoryAdapter, createMemoryExecutionPool, createNeo4jAgentMemoryAdapter, defaultGetMemoryContext, forkAgentMemoryBranchSnapshot, graphitiMemoryAdapterIdentity, mem0MemoryAdapterIdentity, memoryHitToSourceRecord, memoryRecoveryDelayMs, memoryWriteResultToSourceRecord, renderMemoryContext, resolveMemoryCleanupTimeoutMs, runAgentMemoryExperiment, runAgentMemoryImprovement, runBoundedMemoryLifecycle, sleepForMemoryRecovery } from './memory/index.js';
 import '@tangle-network/agent-eval/rl';
 
 interface SourceAdapterInput {

package/dist/index.js

@@ -61,17 +61,28 @@ import {
   AgentMemoryKindSchema,
   AgentMemoryScopeSchema,
   AgentMemoryWriteInputSchema,
+  agentMemorySequenceJudge,
   applyRetrievalHoldout,
   applySessionStickyRetrievalHoldout,
+  buildAgentMemorySequenceScenarios,
+  buildAgentMemorySequencesFromBenchmarkCases,
+  createAgentMemoryBranch,
+  createGraphitiMemoryAdapter,
+  createMem0MemoryAdapter,
   createNeo4jAgentMemoryAdapter,
   defaultGetMemoryContext,
   deterministicRng,
   emitRetrievalHoldoutBypass,
+  forkAgentMemoryBranchSnapshot,
+  graphitiMemoryAdapterIdentity,
+  mem0MemoryAdapterIdentity,
   renderMemoryContext,
   resetRetrievalHoldoutRegistry,
   retrievalHoldoutConfigHash,
+  runAgentMemoryExperiment,
+  runAgentMemoryImprovement,
   toOffPolicyTrajectory
-} from "./chunk-VN2OGUUP.js";
+} from "./chunk-UWOTQNBI.js";
 import {
   IRS_DIMENSION_HINTS,
   MAX_RESPONSE_BYTES,
@@ -89,8 +100,12 @@ import {
   politeFetch
 } from "./chunk-WCYW2GDA.js";
 import {
+  AgentMemoryLifecycleTimeoutError,
+  AgentMemoryLifecycleUnsafeError,
+  DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS,
   INDUSTRY_MEMORY_BENCHMARKS,
   INDUSTRY_RAG_BENCHMARKS,
+  acquireAgentMemoryRunLease,
   buildFirstPartyMemoryLifecycleBenchmarkCases,
   buildIndustryMemoryBenchmarkSmokeCases,
   buildIndustryRagBenchmarkSmokeCases,
@@ -99,36 +114,38 @@ import {
   buildRetrievalEvalDispatch,
   buildRetrievalParameterCandidates,
   createInMemoryBenchmarkAdapter,
-  createMemoryAdapterBenchmarkResponder,
+  createMemoryExecutionPool,
   createNoopMemoryBenchmarkAdapter,
   isKnowledgeMemoryBenchmarkCase,
   knowledgeBenchmarkJudge,
+  memoryHitToSourceRecord,
+  memoryRecoveryDelayMs,
+  memoryWriteResultToSourceRecord,
   parseKnowledgeBenchmarkJsonl,
   parseKnowledgeBenchmarkQrels,
   renderKnowledgeBenchmarkReportMarkdown,
+  resolveMemoryCleanupTimeoutMs,
   respondToIndustryMemoryBenchmarkSmokeCase,
   respondToIndustryRagBenchmarkSmokeCase,
   retrievalConfigFromSurface,
   retrievalConfigSurface,
   retrievalParameterSweepProposer,
   retrievalRecallJudge,
+  runBoundedMemoryLifecycle,
   runKnowledgeBenchmarkSuite,
   runMemoryAdapterBenchmark,
   runRetrievalImprovementLoop,
   scoreKnowledgeBenchmarkArtifact,
   scoreMemoryBenchmarkArtifact,
   scoreRetrievalArtifact,
+  sleepForMemoryRecovery,
   summarizeKnowledgeBenchmarkCampaign
-} from "./chunk-RIHIYCX2.js";
+} from "./chunk-DW6APRTX.js";
 import {
   reciprocalRankFusion,
   searchKnowledge,
   tokenizeQuery
 } from "./chunk-DQ3PDMDP.js";
-import {
-  memoryHitToSourceRecord,
-  memoryWriteResultToSourceRecord
-} from "./chunk-XVU5FFQA.js";
 import {
   sha256,
   slugify,
@@ -2485,24 +2502,32 @@ async function improveKnowledgeBaseInRun(options, runId, runDir, now) {
     if (state.status === "promoted" && !promotedCandidate) {
       throw new Error("promoted knowledge state has no promoted candidate");
     }
-    await withKnowledgeMutation(options.root, () => void 0);
-    await ensureBaselineSnapshot(runDir, options.root, state.baseHash);
     if (state.status === "promoted") {
       const promoted = promotedCandidate;
-      return await applyKnowledgeCandidateTarget(
-        {
-          root: options.root,
+      const promotedState = state;
+      return withKnowledgeMutation(options.root, async () => {
+        const currentHash = await hashKnowledgeBase(options.root);
+        if (currentHash !== promoted.candidateHash) {
+          throw new Error(
+            `promoted knowledge base changed: expected ${promoted.candidateHash}, got ${currentHash}`
+          );
+        }
+        const evidence2 = await assertCandidateEvidence(
           runDir,
-          state,
-          candidateRef: candidateRefFor(runId, state, promoted),
-          leaseTtlMs: options.leaseTtlMs ?? DEFAULT_LEASE_TTL_MS,
-          assertRunOwned: lease.assertOwned,
-          now,
-          onState: options.onState
-        },
-        "candidate"
-      );
+          candidateRefFor(runId, promotedState, promoted)
+        );
+        return {
+          runId,
+          state: promotedState,
+          candidate: promoted,
+          evaluation: evidence2.evaluation,
+          promoted: true,
+          blocked: false
+        };
+      });
     }
+    await withKnowledgeMutation(options.root, () => void 0);
+    await ensureBaselineSnapshot(runDir, options.root, state.baseHash);
     if (state.status === "blocked") {
       return { runId, state, promoted: false, blocked: true };
     }
@@ -6212,8 +6237,11 @@ function buildSteerText(gaps, deepQuestions, invalidationTargets, minIndependent
 export {
   AgentMemoryHitSchema,
   AgentMemoryKindSchema,
+  AgentMemoryLifecycleTimeoutError,
+  AgentMemoryLifecycleUnsafeError,
   AgentMemoryScopeSchema,
   AgentMemoryWriteInputSchema,
+  DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS,
   FileSystemKbStore,
   INDUSTRY_MEMORY_BENCHMARKS,
   INDUSTRY_RAG_BENCHMARKS,
@@ -6239,12 +6267,16 @@ export {
   SourceRecordSchema,
   WIKILINK_REGEX,
   __resetHttpThrottle,
+  acquireAgentMemoryRunLease,
   addSourcePath,
   addSourceText,
+  agentMemorySequenceJudge,
   applyKnowledgeWriteBlocks,
   applyKnowledgeWriteBlocksFile,
   applyRetrievalHoldout,
   applySessionStickyRetrievalHoldout,
+  buildAgentMemorySequenceScenarios,
+  buildAgentMemorySequencesFromBenchmarkCases,
   buildEvalKnowledgeBundle,
   buildFirstPartyMemoryLifecycleBenchmarkCases,
   buildIndustryMemoryBenchmarkSmokeCases,
@@ -6262,18 +6294,21 @@ export {
   citedClaimOf,
   contentKey,
   createAdaptiveResearchDriver,
+  createAgentMemoryBranch,
   createClaimDecorator,
   createClaimGroundingVerifier,
   createCollectionResearchDriver,
   createCornellLiiSource,
   createD1FreshnessStoreStub,
   createFileSystemFreshnessStore,
+  createGraphitiMemoryAdapter,
   createInMemoryBenchmarkAdapter,
   createIrsPublicationsSource,
   createKnowledgeControlLoopAdapter,
   createKnowledgeEvent,
   createLocalDiscoveryDispatcher,
-  createMemoryAdapterBenchmarkResponder,
+  createMem0MemoryAdapter,
+  createMemoryExecutionPool,
   createNeo4jAgentMemoryAdapter,
   createNoopMemoryBenchmarkAdapter,
   createRagAnswerQualityHook,
@@ -6293,10 +6328,12 @@ export {
   extractLinks,
   extractWikilinks,
   firstMatch,
+  forkAgentMemoryBranchSnapshot,
   formatFrontmatter,
   fromAgentCandidateKnowledgeRef,
   gradeCompanyAgainstText,
   gradeFactAgainstText,
+  graphitiMemoryAdapterIdentity,
   groundClaimInText,
   hashKnowledgeBase,
   htmlToText,
@@ -6327,7 +6364,9 @@ export {
   materialFactsSurfaced,
   materialFactsSurfacedInText,
   mediaTypeFor,
+  mem0MemoryAdapterIdentity,
   memoryHitToSourceRecord,
+  memoryRecoveryDelayMs,
   memoryWriteResultToSourceRecord,
   normalizeExternalRagScores,
   normalizeLinkTarget,
@@ -6345,6 +6384,7 @@ export {
   renderKnowledgeBenchmarkReportMarkdown,
   renderMemoryContext,
   resetRetrievalHoldoutRegistry,
+  resolveMemoryCleanupTimeoutMs,
   respondToIndustryMemoryBenchmarkSmokeCase,
   respondToIndustryRagBenchmarkSmokeCase,
   restoreKnowledgeCandidateBaseline,
@@ -6353,6 +6393,9 @@ export {
   retrievalHoldoutConfigHash,
   retrievalParameterSweepProposer,
   retrievalRecallJudge,
+  runAgentMemoryExperiment,
+  runAgentMemoryImprovement,
+  runBoundedMemoryLifecycle,
   runDiscoveryLoop,
   runInvestmentThesisTask,
   runKnowledgeBenchmarkSuite,
@@ -6369,6 +6412,7 @@ export {
   scoreRetrievalArtifact,
   searchKnowledge,
   sha256,
+  sleepForMemoryRecovery,
   slugify,
   sourceMatchesGaps,
   sourceRegistryPath,