@graphorin/memory 0.6.0 → 0.6.1
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/CHANGELOG.md +12 -0
- package/README.md +24 -7
- package/dist/index.d.ts +1 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -2
- package/dist/index.js.map +1 -1
- package/dist/package.js +6 -0
- package/dist/package.js.map +1 -0
- package/dist/tools/block-tools.d.ts +6 -6
- package/dist/tools/block-tools.d.ts.map +1 -1
- package/dist/tools/fact-tools.d.ts +6 -6
- package/dist/tools/fact-tools.d.ts.map +1 -1
- package/dist/tools/recall-tools.d.ts +4 -4
- package/dist/tools/runbook-tools.d.ts +8 -8
- package/dist/tools/runbook-tools.d.ts.map +1 -1
- package/package.json +8 -8
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
# @graphorin/memory
|
|
2
2
|
|
|
3
|
+
## 0.6.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- [#142](https://github.com/o-stepper/graphorin/pull/142) [`436d6ca`](https://github.com/o-stepper/graphorin/commit/436d6ca5ebbd16df094e915682d3915c279a8430) Thanks [@o-stepper](https://github.com/o-stepper)! - Version constants and version-bearing strings now derive from each package's manifest at build time (`VERSION = pkg.version`; writer ids, client/server info, OTLP framework attributes, build-info metrics interpolate it). No behavioral change at the current version: the rendered strings are byte-identical. A release bump no longer edits source; the new `check-version-consistency` gate fails any reintroduced hardcoded framework version.
|
|
8
|
+
|
|
9
|
+
- Updated dependencies [[`826ee59`](https://github.com/o-stepper/graphorin/commit/826ee5933ad38693b0dd2f20a110abfecba7d23d), [`436d6ca`](https://github.com/o-stepper/graphorin/commit/436d6ca5ebbd16df094e915682d3915c279a8430)]:
|
|
10
|
+
- @graphorin/observability@0.6.1
|
|
11
|
+
- @graphorin/core@0.6.1
|
|
12
|
+
- @graphorin/security@0.6.1
|
|
13
|
+
- @graphorin/tools@0.6.1
|
|
14
|
+
|
|
3
15
|
## 0.6.0
|
|
4
16
|
|
|
5
17
|
### Minor Changes
|
package/README.md
CHANGED
|
@@ -20,7 +20,7 @@ The package depends on:
|
|
|
20
20
|
- `@graphorin/security` - the memory-modification guard (`MemoryGuardTier`)
|
|
21
21
|
every memory tool is wired against.
|
|
22
22
|
- `@graphorin/tools` - the `tool({...})` builder used to declare the
|
|
23
|
-
|
|
23
|
+
eleven memory tools.
|
|
24
24
|
- `zod` (peer) - schema typing for the memory tools.
|
|
25
25
|
|
|
26
26
|
Storage is provided by any `MemoryStore` implementation; the default
|
|
@@ -122,9 +122,10 @@ any `EmbedderProvider`; the default is
|
|
|
122
122
|
`graphorin memory activity` (consolidator / reflection activity).
|
|
123
123
|
- **Multi-signal forgetting** (cost / staleness control, *not* an accuracy
|
|
124
124
|
lever). The light phase scores each fact with `salience(...)` - the Ebbinghaus
|
|
125
|
-
`retention` curve (recency + access frequency
|
|
126
|
-
|
|
127
|
-
|
|
125
|
+
`retention` curve (recency + access frequency, including an opt-in
|
|
126
|
+
`accessReinforcement` term fed by per-fact recall counters) combined with the
|
|
127
|
+
`importance` hint and a security-risk negative term (a quarantined fact is
|
|
128
|
+
evicted first, a foreign-provenance one slightly sooner). With neutral importance + an active,
|
|
128
129
|
first-party fact, `salience === retention`. Setting `decayCapacity`
|
|
129
130
|
(`createMemory({ consolidator: { decayCapacity } })`, default unbounded)
|
|
130
131
|
bounds storage: the lowest-salience facts are **soft-archived** (recoverable -
|
|
@@ -164,7 +165,11 @@ any `EmbedderProvider`; the default is
|
|
|
164
165
|
(offline; lexical + embedding). The ambiguous-similarity band mints a *new*
|
|
165
166
|
entity by default - it never auto-merges on weak evidence; opt into LLM
|
|
166
167
|
adjudication (`graph: { llmAdjudication: true, provider }`) to resolve that band.
|
|
167
|
-
|
|
168
|
+
On top of hop expansion: `graphScoring: 'ppr'` weights neighbours by a
|
|
169
|
+
PPR-lite random-walk score instead of flat inclusion, `entityMatch: true`
|
|
170
|
+
adds exact entity-name hits as a candidate list, and `expandHops: 2` is
|
|
171
|
+
available for offline / analysis flows (expensive under dense hubs). Omit it
|
|
172
|
+
all and the default path is unchanged + fully offline (`expandHops`
|
|
168
173
|
defaults to `0`).
|
|
169
174
|
- **Agentic / iterative retrieval** (search quality, gated + opt-in). A
|
|
170
175
|
CRAG/Self-RAG-style grade-then-reformulate loop for hard multi-hop / temporal
|
|
@@ -193,6 +198,13 @@ any `EmbedderProvider`; the default is
|
|
|
193
198
|
`createMemory({ procedureInduction: { provider } })`; omit it and `induce(...)`
|
|
194
199
|
throws `ProcedureInductionNotConfiguredError` - the procedural tier stays pure
|
|
195
200
|
offline CRUD with no provider call.
|
|
201
|
+
- **Memory evolution knobs** (all opt-in). `runbookSearch: true` registers the
|
|
202
|
+
gated `runbook_search` tool over the procedural tier; `consolidator:
|
|
203
|
+
{ learnedContext: true, learnedContextMaxChars }` maintains a compact
|
|
204
|
+
learned-context digest block from consolidation output; facts, episodes, and
|
|
205
|
+
rules carry an optional `owner` principal so multi-principal deployments can
|
|
206
|
+
filter reads per owner; and per-fact access counters feed the salience
|
|
207
|
+
`accessReinforcement` term.
|
|
196
208
|
- **Per-record `embedder_id` enforced.** Every embedded write registers
|
|
197
209
|
the embedder via the storage layer's `EmbeddingMetaRepository` and
|
|
198
210
|
records the canonical id (`'<provider>:<model>@<dim>'`); attempts to
|
|
@@ -277,7 +289,7 @@ console.log(hits[0]?.record.text);
|
|
|
277
289
|
|
|
278
290
|
| Tier | Surface (read) | Surface (write) |
|
|
279
291
|
|-------------|-----------------------------------------------|-------------------------------------------------------------|
|
|
280
|
-
| working | `list`, `read`, `compile` | `define`, `write`, `
|
|
292
|
+
| working | `list`, `read`, `compile` | `define`, `write`, `append`, `replace`, `rethink`, `forget`, `attach`, `detach` |
|
|
281
293
|
| session | `list`, `search`, `attributedFor` | `push`, `flushImportant`, `compact` |
|
|
282
294
|
| episodic | `recent`, `search` | `record` |
|
|
283
295
|
| semantic | `search` | `remember`, `supersede`, `forget` |
|
|
@@ -304,6 +316,11 @@ tool exactly once:
|
|
|
304
316
|
| `fact_history` | semantic | Trace a fact's bi-temporal supersede chain. |
|
|
305
317
|
| `fact_validate` | semantic | Promote a quarantined fact to active (audited). |
|
|
306
318
|
|
|
319
|
+
Two further tools are **gated** behind their configuration and absent by
|
|
320
|
+
default: `deep_recall` (registered when `iterativeRetrieval` is configured)
|
|
321
|
+
and `runbook_search` (procedural runbook lookup, registered when
|
|
322
|
+
`createMemory({ runbookSearch: true })`).
|
|
323
|
+
|
|
307
324
|
## Embedder migration
|
|
308
325
|
|
|
309
326
|
```ts
|
|
@@ -398,4 +415,4 @@ MIT © 2026 Oleksiy Stepurenko.
|
|
|
398
415
|
|
|
399
416
|
---
|
|
400
417
|
|
|
401
|
-
**Project Graphorin** · v0.6.
|
|
418
|
+
**Project Graphorin** · v0.6.1 · MIT License · © 2026 Oleksiy Stepurenko · <https://github.com/o-stepper/graphorin>
|
package/dist/index.d.ts
CHANGED
|
@@ -100,8 +100,7 @@ import "./tiers/index.js";
|
|
|
100
100
|
*
|
|
101
101
|
* @packageDocumentation
|
|
102
102
|
*/
|
|
103
|
-
|
|
104
|
-
declare const VERSION = "0.6.0";
|
|
103
|
+
declare const VERSION: string;
|
|
105
104
|
//#endregion
|
|
106
105
|
export { type AllocationResult, type AnnotatedPart, type AssembleInput, type AssembledPrompt, type AutoCompactionDefault, type AutoRecallConfig, type AutoRecallStrategy, type AutoRecallStrategyContext, type AutoRecallTriggerResult, type AutoRecallTriggers, BASE_TEMPLATE_EN_FULL, BASE_TEMPLATE_EN_MINIMAL, type BaseTemplateFragments, BlockDefinition, BlockSpec, BudgetExceededError, type BuildMemoryToolsOptions, CLEARED_TOOL_RESULT_MARKER, CONSOLIDATOR_TIER_DEFAULTS, CONTENT_ORIGIN_ATTR, type ClearToolResultsOptions, type ClearToolResultsOutcome, type CompactionConfig, type CompactionContext, type CompactionMetadataPayload, type CompactionResult, type CompactionSource, type CompactionStrategy, type CompactionSummarizer, type CompactionSummaryTemplate, type CompactionTriggerConfig, type CompileOptions, type CompileScope, type ConflictAuditDecision, type ConflictAuditInputLike, type ConflictAuditStage, ConflictDecision, type ConflictMemoryStoreExt, ConflictPipeline, ConflictPipelineDeps, ConflictPipelineOptions, ConflictStage, ConflictThresholds, type Consolidator, type ConsolidatorBudgetSnapshot, type ConsolidatorCatchupPolicy, type ConsolidatorCeilings, type ConsolidatorConfig, type ConsolidatorLastRuns, type ConsolidatorMemoryStoreExt, type ConsolidatorPhase, type ConsolidatorRunFinish, type ConsolidatorRunInput, type ConsolidatorStatePatch, type ConsolidatorStateRow, type ConsolidatorStatus, type ConsolidatorTier, type ConsolidatorTriggerReason, type ConsolidatorTriggerSpec, type ContentAnnotation, type ContentOrigin, type ContextEngine, type ContextEngineConfig, type ContextLocalePack, type ContextTokenCounter, type ContextualRetrievalMode, type CreateConsolidatorOptions, type CreateMemoryOptions, CustomTierMisconfiguredError, DEFAULT_ADJUDICATE_THRESHOLD, DEFAULT_CONFLICT_THRESHOLDS, DEFAULT_DIFFICULTY_THRESHOLD, DEFAULT_INDUCTION_MAX_TOKENS, DEFAULT_LAYER_PRIORITY, DEFAULT_MAX_ITERATIONS, DEFAULT_MAX_QUERY_VARIANTS, DEFAULT_MERGE_THRESHOLD, DEFAULT_PPR_DAMPING, DEFAULT_PRESERVE_RECENT_TURNS, DEFAULT_RESERVED_FOR_COMPACTION, DEFAULT_RESERVED_FOR_RESPONSE, DEFAULT_THRESHOLD_RATIO, type DecayMemoryStoreExt, DifficultyAssessment, DifficultyGateOptions, type DlqBatchInput, type DlqBatchRow, type EmbeddedWriteOptions, EmbedderMigrationAbortedError, EmbedderMigrationLockedError, EmbedderMigrationStateError, EmbedderMigrationStrategy, EmbedderRegistrationError, type EmbeddingMetaRegistryLike, EntityResolutionConfig, EntityResolveDecision, EntityResolver, EntityResolverDeps, EpisodeInput, EpisodeRetrievalWeights, EpisodeSearchOptions, EpisodicMemory, type EpisodicMemoryStoreExt, type ExecuteCompactionInput, FactInput, FactRememberOptions, FactSearchOptions, FitFusionCase, FitFusionOptions, FitFusionResult, FusionStrategy, FusionWeights, GraphorinMemoryError, HEURISTIC_TOKEN_COUNTER, HYDE_SYSTEM_PROMPT, INBOUND_SANITIZATION_PREAMBLE_EN, INBOUND_TRUST_ATTR, INDUCTION_SYSTEM_PROMPT, type InboundSanitizationPreamble, type InboundTrust, InduceOptions, type InducedProcedure, InsightListOptions, InsightMemory, type InsightMemoryStoreExt, InsightSearchOptions, type InsightSearchStoreOptions, type InsightListOptions$1 as InsightStoreListOptions, IterativeRecallResult, IterativeRetrievalDeps, IterativeRetrievalOptions, IterativeRetrievalResult, IterativeSearchOptions, type LayerAllocation, type LayerCandidate, type LayerConfig, type LayerId, LocaleMatch, LocalePack, LocalePatternEntry, type LocaleResolverLogger, LocaleSupersedeKind, MAX_ITERATIONS_CEILING, MAX_PROCEDURE_STEPS, MAX_TRAJECTORY_STEPS_SHOWN, type Memory, type MemoryBaseMode, type MemoryContextBlocks, type MemoryMetadataDeps, type MemoryStoreAdapter, MemoryToolDeniedError, type MemoryToolDeps, MigrateEmbedderOptions, MigrationProgress, NON_INBOUND_ORIGINS, type NamedPostCompactionHook, type OnBudgetExceed, type OverflowMode, type ParsedTrigger, type PartialContextLocalePack, type PartitionResult, type PendingConflictInputLike, type PendingConflictRowLike, type PhaseListener, type PhaseOutcome, PipelineStage, type PostCompactionHook, type PostCompactionHookContext, type PrivacyConfig, type PrivacyDecision, type PrivacyDecisionReason, type PrivacyFilterContext, ProceduralMemory, ProcedureInductionNotConfiguredError, ProviderNotConfiguredError, QUERY_EXPANSION_SYSTEM_PROMPT, QuarantinePromotionRefusedError, QueryTransformOptions, QueryTransformer, RETRIEVAL_GRADE_SYSTEM_PROMPT, RRFReranker, RRF_DEFAULT_K, ReRankOptions, ReRanker, type ReanchorRecentResultsOptions, RecallExplanation, RecalledMemoryExplanation, ReconcileAction, ReconcileDecision, type RegisterTriggersOptions, type RegisterTriggersResult, RememberOutcome, type RenderedTemplate, ResolutionCandidate, ResolveDecisionInput, type ResolvedContextEngineConfig, RetrievalGrade, RetrievalGradeOptions, RetrievalGrader, RuleActivationContext, RuleInput, SUMMARY_TEMPLATE_NAME, SUMMARY_TEMPLATE_VERSION, type SchedulerLike, type ScopeResolver, SemanticMemory, type SemanticMemoryStoreExt, SessionCompactionPolicy, SessionCompactionResult, SessionMemory, type SessionMemoryStoreExt, type SessionMessageRecord, SharedMemory, type SkillMetadataCard, StageContext, StageOutcome, type Trajectory, type TrajectoryStep, type TriggerDeclarationLike, VERSION, type VerificationResult, WeightedRRFReranker, type WorkflowInducer, type WorkflowInductionOptions, WorkingBlockOverflowError, WorkingBlockReadOnlyError, WorkingBlockReplaceMismatchError, WorkingMemory, _getLocaleFallbackWarningsForTesting, _resetBypassWarningForTesting, _resetConsolidatorConfigWarningForTesting, _resetLocaleFallbackWarningsForTesting, adaptTokenCounter, allocate as allocateTokenBudget, annotate, assessQueryDifficulty, buildAdjudicationRequest, buildExpansionRequest, buildGradeRequest, buildHydeRequest, buildInductionRequest, buildMemoryTools, buildSummarizerPrompt, capInsightsBelowFacts, checkSuccessCriteria, clearOldToolResults, composeInboundPreamble, composeLayer1, composeLayer2, composeLayer4Skills, cosineSimilarity, countMessageTokens, createBlockAppendTool, createBlockReplaceTool, createBlockRethinkTool, createConflictPipeline, createConsolidator, createConsolidatorPlaceholder, createContextEngine, createConversationSearchTool, createDeepRecallTool, createFactForgetTool, createFactHistoryTool, createFactRememberTool, createFactSearchTool, createFactSupersedeTool, createFactValidateTool, createMemory, createProviderQueryTransformer, createProviderRetrievalGrader, createProviderWorkflowInducer, createRecallEpisodesTool, defaultLocaleHeuristicStrategy, defineAutoRecallStrategy, defineBlock, defineContextLocalePack, defineLocalePack, effectiveAcceptsSensitivity, enLocalePack, evaluateMarkers, executeCompaction, explainRecall, fitFusionWeights, formatRecallExplanation, fuseRrf, fuseWeighted, gatherMemoryMetadata, isForeignProvenance, migrateEmbedder, ndcgAtK, normalizeEntityName, normalizeInducedProcedure, parseAdjudication, parseGrade, parseHypothetical, parseInducedProcedure, parseQueryVariants, parseTriggerSpec, partition as partitionBySensitivity, pprActivation, decide as privacyDecide, reanchorPersonaBlock, reanchorPinnedFacts, reanchorProjectRules, reanchorRecentResults, reasonFromTrigger, reconcileToConflictDecision, registerConsolidatorTriggers, renderFinalSummary, renderMessageText, renderMetadataBlock, resolveAutoCompactionDefault, resolveEntityDecision, resolveLocalePack, resolveTriggerThreshold, runConflictPipeline, runIterativeRetrieval, runWorkflowInduction, shouldFireInboundPreamble, toSpanAttributes, trajectoryFromRunState, truncateToTokens, trustDiscount };
|
|
107
106
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuCa"}
|
package/dist/index.js
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { version } from "./package.js";
|
|
1
2
|
import { defineLocalePack, evaluateMarkers } from "./conflict/locale-packs/types.js";
|
|
2
3
|
import { DEFAULT_CONFLICT_THRESHOLDS, reconcileToConflictDecision } from "./conflict/types.js";
|
|
3
4
|
import { _resetBypassWarningForTesting, createConflictPipeline, runConflictPipeline } from "./conflict/pipeline.js";
|
|
@@ -92,8 +93,8 @@ import "./tiers/index.js";
|
|
|
92
93
|
*
|
|
93
94
|
* @packageDocumentation
|
|
94
95
|
*/
|
|
95
|
-
/** Canonical version constant
|
|
96
|
-
const VERSION =
|
|
96
|
+
/** Canonical version constant, derived from `package.json` at build time. */
|
|
97
|
+
const VERSION = version;
|
|
97
98
|
|
|
98
99
|
//#endregion
|
|
99
100
|
export { BASE_TEMPLATE_EN_FULL, BASE_TEMPLATE_EN_MINIMAL, BudgetExceededError, CLEARED_TOOL_RESULT_MARKER, CONSOLIDATOR_TIER_DEFAULTS, CONTENT_ORIGIN_ATTR, CustomTierMisconfiguredError, DEFAULT_ADJUDICATE_THRESHOLD, DEFAULT_CONFLICT_THRESHOLDS, DEFAULT_DIFFICULTY_THRESHOLD, DEFAULT_INDUCTION_MAX_TOKENS, DEFAULT_LAYER_PRIORITY, DEFAULT_MAX_ITERATIONS, DEFAULT_MAX_QUERY_VARIANTS, DEFAULT_MERGE_THRESHOLD, DEFAULT_PPR_DAMPING, DEFAULT_PRESERVE_RECENT_TURNS, DEFAULT_RESERVED_FOR_COMPACTION, DEFAULT_RESERVED_FOR_RESPONSE, DEFAULT_THRESHOLD_RATIO, EmbedderMigrationAbortedError, EmbedderMigrationLockedError, EmbedderMigrationStateError, EmbedderRegistrationError, EntityResolver, EpisodicMemory, GraphorinMemoryError, HEURISTIC_TOKEN_COUNTER, HYDE_SYSTEM_PROMPT, INBOUND_SANITIZATION_PREAMBLE_EN, INBOUND_TRUST_ATTR, INDUCTION_SYSTEM_PROMPT, InsightMemory, MAX_ITERATIONS_CEILING, MAX_PROCEDURE_STEPS, MAX_TRAJECTORY_STEPS_SHOWN, MemoryToolDeniedError, NON_INBOUND_ORIGINS, ProceduralMemory, ProcedureInductionNotConfiguredError, ProviderNotConfiguredError, QUERY_EXPANSION_SYSTEM_PROMPT, QuarantinePromotionRefusedError, RETRIEVAL_GRADE_SYSTEM_PROMPT, RRFReranker, RRF_DEFAULT_K, SUMMARY_TEMPLATE_NAME, SUMMARY_TEMPLATE_VERSION, SemanticMemory, SessionMemory, SharedMemory, VERSION, WeightedRRFReranker, WorkingBlockOverflowError, WorkingBlockReadOnlyError, WorkingBlockReplaceMismatchError, WorkingMemory, _getLocaleFallbackWarningsForTesting, _resetBypassWarningForTesting, _resetConsolidatorConfigWarningForTesting, _resetLocaleFallbackWarningsForTesting, adaptTokenCounter, allocate as allocateTokenBudget, annotate, assessQueryDifficulty, buildAdjudicationRequest, buildExpansionRequest, buildGradeRequest, buildHydeRequest, buildInductionRequest, buildMemoryTools, buildSummarizerPrompt, capInsightsBelowFacts, checkSuccessCriteria, clearOldToolResults, composeInboundPreamble, composeLayer1, composeLayer2, composeLayer4Skills, cosineSimilarity, countMessageTokens, createBlockAppendTool, createBlockReplaceTool, createBlockRethinkTool, createConflictPipeline, createConsolidator, createConsolidatorPlaceholder, createContextEngine, createConversationSearchTool, createDeepRecallTool, createFactForgetTool, createFactHistoryTool, createFactRememberTool, createFactSearchTool, createFactSupersedeTool, createFactValidateTool, createMemory, createProviderQueryTransformer, createProviderRetrievalGrader, createProviderWorkflowInducer, createRecallEpisodesTool, defaultLocaleHeuristicStrategy, defineAutoRecallStrategy, defineBlock, defineContextLocalePack, defineLocalePack, effectiveAcceptsSensitivity, enLocalePack, evaluateMarkers, executeCompaction, explainRecall, fitFusionWeights, formatRecallExplanation, fuseRrf, fuseWeighted, gatherMemoryMetadata, isForeignProvenance, migrateEmbedder, ndcgAtK, normalizeEntityName, normalizeInducedProcedure, parseAdjudication, parseGrade, parseHypothetical, parseInducedProcedure, parseQueryVariants, parseTriggerSpec, partition as partitionBySensitivity, pprActivation, decide as privacyDecide, reanchorPersonaBlock, reanchorPinnedFacts, reanchorProjectRules, reanchorRecentResults, reasonFromTrigger, reconcileToConflictDecision, registerConsolidatorTriggers, renderFinalSummary, renderMessageText, renderMetadataBlock, resolveAutoCompactionDefault, resolveEntityDecision, resolveLocalePack, resolveTriggerThreshold, runConflictPipeline, runIterativeRetrieval, runWorkflowInduction, shouldFireInboundPreamble, toSpanAttributes, trajectoryFromRunState, truncateToTokens, trustDiscount };
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * `@graphorin/memory` - seven-tier memory system for the Graphorin\n * framework (MST-13: working / session / episodic / semantic /\n * procedural / shared + the read-only insight tier from P1-1).\n *\n * Surface overview:\n *\n * - The {@link createMemory} facade that wires every tier sub-module\n * + the memory tools + the search reranker + the context-engine +\n * the consolidator.\n * - Tier sub-modules under `./tiers`: {@link WorkingMemory},\n * {@link SessionMemory}, {@link EpisodicMemory}, {@link SemanticMemory},\n * {@link ProceduralMemory}, {@link SharedMemory}, plus the read-only\n * {@link InsightMemory}.\n * - Eleven memory tools under `./tools` (plus the gated twelfth,\n * `deep_recall`, registered only when iterative retrieval is\n * configured): `block_append`, `block_replace`, `block_rethink`,\n * `fact_remember`, `fact_search`, `fact_supersede`, `fact_forget`,\n * `recall_episodes`, `conversation_search`, `fact_history` (P0-2),\n * `fact_validate` (P1-4).\n * - The hybrid search composition under `./search`, including the\n * built-in {@link RRFReranker} (k=60 default) and the\n * {@link ReRanker} contract.\n * - The embedder migration runner under `./migration`\n * ({@link migrateEmbedder} with three coexistence policies).\n * - Typed errors under `./errors`.\n *\n * Forward-looking surfaces (for ergonomic typing today):\n *\n * - {@link MemoryContextBlocks} + {@link CompileOptions} from `./context-engine`.\n * - {@link Consolidator}, {@link ConsolidatorTriggerSpec},\n * {@link ConsolidatorTier} from `./consolidator`.\n *\n * @packageDocumentation\n */\n\n/** Canonical version constant
|
|
1
|
+
{"version":3,"file":"index.js","names":["VERSION: string","pkg.version"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * `@graphorin/memory` - seven-tier memory system for the Graphorin\n * framework (MST-13: working / session / episodic / semantic /\n * procedural / shared + the read-only insight tier from P1-1).\n *\n * Surface overview:\n *\n * - The {@link createMemory} facade that wires every tier sub-module\n * + the memory tools + the search reranker + the context-engine +\n * the consolidator.\n * - Tier sub-modules under `./tiers`: {@link WorkingMemory},\n * {@link SessionMemory}, {@link EpisodicMemory}, {@link SemanticMemory},\n * {@link ProceduralMemory}, {@link SharedMemory}, plus the read-only\n * {@link InsightMemory}.\n * - Eleven memory tools under `./tools` (plus the gated twelfth,\n * `deep_recall`, registered only when iterative retrieval is\n * configured): `block_append`, `block_replace`, `block_rethink`,\n * `fact_remember`, `fact_search`, `fact_supersede`, `fact_forget`,\n * `recall_episodes`, `conversation_search`, `fact_history` (P0-2),\n * `fact_validate` (P1-4).\n * - The hybrid search composition under `./search`, including the\n * built-in {@link RRFReranker} (k=60 default) and the\n * {@link ReRanker} contract.\n * - The embedder migration runner under `./migration`\n * ({@link migrateEmbedder} with three coexistence policies).\n * - Typed errors under `./errors`.\n *\n * Forward-looking surfaces (for ergonomic typing today):\n *\n * - {@link MemoryContextBlocks} + {@link CompileOptions} from `./context-engine`.\n * - {@link Consolidator}, {@link ConsolidatorTriggerSpec},\n * {@link ConsolidatorTier} from `./consolidator`.\n *\n * @packageDocumentation\n */\n\n/** Canonical version constant, derived from `package.json` at build time. */\nimport pkg from '../package.json' with { type: 'json' };\n\nexport const VERSION: string = pkg.version;\n\nexport * from './conflict/index.js';\nexport {\n BudgetExceededError,\n buildInductionRequest,\n CONSOLIDATOR_TIER_DEFAULTS,\n type Consolidator,\n type ConsolidatorBudgetSnapshot,\n type ConsolidatorCatchupPolicy,\n type ConsolidatorCeilings,\n type ConsolidatorConfig,\n type ConsolidatorLastRuns,\n type ConsolidatorPhase,\n type ConsolidatorStatus,\n type ConsolidatorTier,\n type ConsolidatorTriggerReason,\n type ConsolidatorTriggerSpec,\n type CreateConsolidatorOptions,\n CustomTierMisconfiguredError,\n checkSuccessCriteria,\n createConsolidator,\n createConsolidatorPlaceholder,\n createProviderWorkflowInducer,\n DEFAULT_INDUCTION_MAX_TOKENS,\n INDUCTION_SYSTEM_PROMPT,\n type InducedProcedure,\n MAX_PROCEDURE_STEPS,\n MAX_TRAJECTORY_STEPS_SHOWN,\n normalizeInducedProcedure,\n type OnBudgetExceed,\n type ParsedTrigger,\n type PhaseListener,\n type PhaseOutcome,\n ProviderNotConfiguredError,\n parseInducedProcedure,\n parseTriggerSpec,\n type RegisterTriggersOptions,\n type RegisterTriggersResult,\n reasonFromTrigger,\n registerConsolidatorTriggers,\n runWorkflowInduction,\n type SchedulerLike,\n type Trajectory,\n type TrajectoryStep,\n type TriggerDeclarationLike,\n trajectoryFromRunState,\n type VerificationResult,\n type WorkflowInducer,\n type WorkflowInductionOptions,\n} from './consolidator/index.js';\nexport {\n _getLocaleFallbackWarningsForTesting,\n _resetLocaleFallbackWarningsForTesting,\n type AllocationResult,\n type AnnotatedPart,\n type AssembledPrompt,\n type AssembleInput,\n type AutoCompactionDefault,\n type AutoRecallConfig,\n type AutoRecallStrategy,\n type AutoRecallStrategyContext,\n type AutoRecallTriggerResult,\n type AutoRecallTriggers,\n adaptTokenCounter,\n allocateTokenBudget,\n annotate,\n BASE_TEMPLATE_EN_FULL,\n BASE_TEMPLATE_EN_MINIMAL,\n type BaseTemplateFragments,\n buildSummarizerPrompt,\n CLEARED_TOOL_RESULT_MARKER,\n type ClearToolResultsOptions,\n type ClearToolResultsOutcome,\n CONTENT_ORIGIN_ATTR,\n type CompactionConfig,\n type CompactionContext,\n type CompactionMetadataPayload,\n type CompactionResult,\n type CompactionSource,\n type CompactionStrategy,\n type CompactionSummarizer,\n type CompactionSummaryTemplate,\n type CompactionTriggerConfig,\n type CompileOptions,\n type CompileScope,\n type ContentAnnotation,\n type ContentOrigin,\n type ContextEngine,\n type ContextEngineConfig,\n type ContextLocalePack,\n type ContextTokenCounter,\n clearOldToolResults,\n composeInboundPreamble,\n composeLayer1,\n composeLayer2,\n composeLayer4Skills,\n countMessageTokens,\n createContextEngine,\n DEFAULT_LAYER_PRIORITY,\n DEFAULT_PRESERVE_RECENT_TURNS,\n DEFAULT_RESERVED_FOR_COMPACTION,\n DEFAULT_RESERVED_FOR_RESPONSE,\n DEFAULT_THRESHOLD_RATIO,\n defaultLocaleHeuristicStrategy,\n defineAutoRecallStrategy,\n defineContextLocalePack,\n type ExecuteCompactionInput,\n effectiveAcceptsSensitivity,\n enLocalePack,\n executeCompaction,\n gatherMemoryMetadata,\n HEURISTIC_TOKEN_COUNTER,\n INBOUND_SANITIZATION_PREAMBLE_EN,\n INBOUND_TRUST_ATTR,\n type InboundSanitizationPreamble,\n type InboundTrust,\n type LayerAllocation,\n type LayerCandidate,\n type LayerConfig,\n type LayerId,\n type LocaleResolverLogger,\n type MemoryBaseMode,\n type MemoryContextBlocks,\n type MemoryMetadataDeps,\n type NamedPostCompactionHook,\n NON_INBOUND_ORIGINS,\n type OverflowMode,\n type PartialContextLocalePack,\n type PartitionResult,\n type PostCompactionHook,\n type PostCompactionHookContext,\n type PrivacyConfig,\n type PrivacyDecision,\n type PrivacyDecisionReason,\n type PrivacyFilterContext,\n partitionBySensitivity,\n privacyDecide,\n type ReanchorRecentResultsOptions,\n type RenderedTemplate,\n type ResolvedContextEngineConfig,\n reanchorPersonaBlock,\n reanchorPinnedFacts,\n reanchorProjectRules,\n reanchorRecentResults,\n renderFinalSummary,\n renderMessageText,\n renderMetadataBlock,\n resolveAutoCompactionDefault,\n resolveLocalePack,\n resolveTriggerThreshold,\n type SkillMetadataCard,\n SUMMARY_TEMPLATE_NAME,\n SUMMARY_TEMPLATE_VERSION,\n shouldFireInboundPreamble,\n toSpanAttributes,\n truncateToTokens,\n} from './context-engine/index.js';\nexport * from './errors/index.js';\nexport {\n _resetConsolidatorConfigWarningForTesting,\n type CreateMemoryOptions,\n createMemory,\n type Memory,\n} from './facade.js';\nexport * from './graph/index.js';\nexport type { ContextualRetrievalMode } from './internal/contextualize.js';\nexport type {\n ConflictAuditDecision,\n ConflictAuditInputLike,\n ConflictAuditStage,\n ConflictMemoryStoreExt,\n ConsolidatorMemoryStoreExt,\n ConsolidatorRunFinish,\n ConsolidatorRunInput,\n ConsolidatorStatePatch,\n ConsolidatorStateRow,\n DecayMemoryStoreExt,\n DlqBatchInput,\n DlqBatchRow,\n EmbeddedWriteOptions,\n EmbeddingMetaRegistryLike,\n EpisodicMemoryStoreExt,\n InsightListOptions as InsightStoreListOptions,\n InsightMemoryStoreExt,\n InsightSearchStoreOptions,\n MemoryStoreAdapter,\n PendingConflictInputLike,\n PendingConflictRowLike,\n SemanticMemoryStoreExt,\n SessionMemoryStoreExt,\n SessionMessageRecord,\n} from './internal/storage-adapter.js';\nexport * from './migration/index.js';\nexport * from './search/index.js';\nexport * from './tiers/index.js';\nexport {\n type BuildMemoryToolsOptions,\n buildMemoryTools,\n createBlockAppendTool,\n createBlockReplaceTool,\n createBlockRethinkTool,\n createConversationSearchTool,\n createDeepRecallTool,\n createFactForgetTool,\n createFactHistoryTool,\n createFactRememberTool,\n createFactSearchTool,\n createFactSupersedeTool,\n createFactValidateTool,\n createRecallEpisodesTool,\n type MemoryToolDeps,\n type ScopeResolver,\n} from './tools/index.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,MAAaA,UAAkBC"}
|
package/dist/package.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"package.js","names":[],"sources":["../package.json"],"sourcesContent":["{\n \"name\": \"@graphorin/memory\",\n \"version\": \"0.6.1\",\n \"description\": \"Six-tier memory system for the Graphorin framework: createMemory() facade with working / session / episodic / semantic / procedural / shared sub-modules, eleven memory tools wired into @graphorin/tools, hybrid vector + FTS5 search composed through Reciprocal Rank Fusion (k=60 default) with a pluggable reranker hook, a multi-stage conflict resolution pipeline (exact dedup → embedding three-zone → heuristic regex → subject/predicate → defer-to-deep) with an English locale pack default + plug-in locales, an embedder migration runner with three coexistence policies (lock-on-first / multi-active / auto-migrate), per-record embedder_id enforcement, multi-agent attribution, append-only writes with soft-delete + supersede semantics, default-on bi-temporal storage, provenance + quarantine safety gate for synthesized memory, AISpan emission for every operation, and tier-aware memory-modification guard wiring.\",\n \"license\": \"MIT\",\n \"author\": \"Oleksiy Stepurenko\",\n \"homepage\": \"https://github.com/o-stepper/graphorin/tree/main/packages/memory\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git+https://github.com/o-stepper/graphorin.git\",\n \"directory\": \"packages/memory\"\n },\n \"bugs\": {\n \"url\": \"https://github.com/o-stepper/graphorin/issues\"\n },\n \"keywords\": [\n \"graphorin\",\n \"ai\",\n \"agents\",\n \"framework\",\n \"memory\",\n \"long-term-memory\",\n \"working-memory\",\n \"session-memory\",\n \"episodic-memory\",\n \"semantic-memory\",\n \"procedural-memory\",\n \"shared-memory\",\n \"rrf\",\n \"hybrid-search\",\n \"rerank\",\n \"conflict-resolution\",\n \"embedder-migration\",\n \"bi-temporal\",\n \"multi-agent\"\n ],\n \"type\": \"module\",\n \"engines\": {\n \"node\": \">=22.0.0\"\n },\n \"main\": \"./dist/index.js\",\n \"module\": \"./dist/index.js\",\n \"types\": \"./dist/index.d.ts\",\n \"exports\": {\n \".\": {\n \"types\": \"./dist/index.d.ts\",\n \"import\": \"./dist/index.js\"\n },\n \"./facade\": {\n \"types\": \"./dist/facade.d.ts\",\n \"import\": \"./dist/facade.js\"\n },\n \"./tiers\": {\n \"types\": \"./dist/tiers/index.d.ts\",\n \"import\": \"./dist/tiers/index.js\"\n },\n \"./tools\": {\n \"types\": \"./dist/tools/index.d.ts\",\n \"import\": \"./dist/tools/index.js\"\n },\n \"./search\": {\n \"types\": \"./dist/search/index.d.ts\",\n \"import\": \"./dist/search/index.js\"\n },\n \"./conflict\": {\n \"types\": \"./dist/conflict/index.d.ts\",\n \"import\": \"./dist/conflict/index.js\"\n },\n \"./migration\": {\n \"types\": \"./dist/migration/index.d.ts\",\n \"import\": \"./dist/migration/index.js\"\n },\n \"./errors\": {\n \"types\": \"./dist/errors/index.d.ts\",\n \"import\": \"./dist/errors/index.js\"\n },\n \"./package.json\": \"./package.json\"\n },\n \"files\": [\n \"dist\",\n \"README.md\",\n \"CHANGELOG.md\",\n \"LICENSE\"\n ],\n \"scripts\": {\n \"build\": \"tsdown\",\n \"typecheck\": \"tsc --noEmit && tsc -p tsconfig.tests.json\",\n \"test\": \"vitest run\",\n \"lint\": \"biome check .\",\n \"clean\": \"rimraf dist .turbo *.tsbuildinfo\"\n },\n \"dependencies\": {\n \"@graphorin/core\": \"workspace:*\",\n \"@graphorin/observability\": \"workspace:*\",\n \"@graphorin/security\": \"workspace:*\",\n \"@graphorin/tools\": \"workspace:*\"\n },\n \"peerDependencies\": {\n \"zod\": \"^3.23.0 || ^4.0.0\"\n },\n \"peerDependenciesMeta\": {\n \"zod\": {\n \"optional\": false\n }\n },\n \"publishConfig\": {\n \"access\": \"public\",\n \"provenance\": true\n },\n \"devDependencies\": {\n \"@graphorin/store-sqlite\": \"workspace:*\",\n \"@graphorin/embedder-transformersjs\": \"workspace:*\",\n \"@graphorin/triggers\": \"workspace:*\",\n \"@types/better-sqlite3\": \"^7.6.13\",\n \"better-sqlite3\": \"^12.9.0\",\n \"fast-check\": \"^3.23.0\",\n \"zod\": \"^3.25.0\"\n }\n}\n"],"mappings":";cAEa"}
|
|
@@ -17,11 +17,11 @@ declare const blockAppendOutputSchema: z.ZodObject<{
|
|
|
17
17
|
label: z.ZodString;
|
|
18
18
|
length: z.ZodNumber;
|
|
19
19
|
}, "strip", z.ZodTypeAny, {
|
|
20
|
-
label: string;
|
|
21
20
|
length: number;
|
|
22
|
-
}, {
|
|
23
21
|
label: string;
|
|
22
|
+
}, {
|
|
24
23
|
length: number;
|
|
24
|
+
label: string;
|
|
25
25
|
}>;
|
|
26
26
|
type BlockAppendInput = z.infer<typeof blockAppendInputSchema>;
|
|
27
27
|
type BlockAppendOutput = z.infer<typeof blockAppendOutputSchema>;
|
|
@@ -42,11 +42,11 @@ declare const blockReplaceOutputSchema: z.ZodObject<{
|
|
|
42
42
|
label: z.ZodString;
|
|
43
43
|
length: z.ZodNumber;
|
|
44
44
|
}, "strip", z.ZodTypeAny, {
|
|
45
|
-
label: string;
|
|
46
45
|
length: number;
|
|
47
|
-
}, {
|
|
48
46
|
label: string;
|
|
47
|
+
}, {
|
|
49
48
|
length: number;
|
|
49
|
+
label: string;
|
|
50
50
|
}>;
|
|
51
51
|
type BlockReplaceInput = z.infer<typeof blockReplaceInputSchema>;
|
|
52
52
|
type BlockReplaceOutput = z.infer<typeof blockReplaceOutputSchema>;
|
|
@@ -64,11 +64,11 @@ declare const blockRethinkOutputSchema: z.ZodObject<{
|
|
|
64
64
|
label: z.ZodString;
|
|
65
65
|
length: z.ZodNumber;
|
|
66
66
|
}, "strip", z.ZodTypeAny, {
|
|
67
|
-
label: string;
|
|
68
67
|
length: number;
|
|
69
|
-
}, {
|
|
70
68
|
label: string;
|
|
69
|
+
}, {
|
|
71
70
|
length: number;
|
|
71
|
+
label: string;
|
|
72
72
|
}>;
|
|
73
73
|
type BlockRethinkInput = z.infer<typeof blockRethinkInputSchema>;
|
|
74
74
|
type BlockRethinkOutput = z.infer<typeof blockRethinkOutputSchema>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"block-tools.d.ts","names":[],"sources":["../../src/tools/block-tools.ts"],"sourcesContent":[],"mappings":";;;;;cAKM,wBAAsB,CAAA,CAAA;;EAAtB,OAAA,aAAA;;;;CAAsB,EAAA;EAAA,KAAA,EAAA,MAAA;EAItB,OAAA,EAAA,MAAA;;cAAA,yBAAuB,CAAA,CAAA;;EAAA,MAAA,aAAA;CAAA,EAAA,OAAA,cAAA,EAAA;EAKxB,
|
|
1
|
+
{"version":3,"file":"block-tools.d.ts","names":[],"sources":["../../src/tools/block-tools.ts"],"sourcesContent":[],"mappings":";;;;;cAKM,wBAAsB,CAAA,CAAA;;EAAtB,OAAA,aAAA;;;;CAAsB,EAAA;EAAA,KAAA,EAAA,MAAA;EAItB,OAAA,EAAA,MAAA;;cAAA,yBAAuB,CAAA,CAAA;;EAAA,MAAA,aAAA;CAAA,EAAA,OAAA,cAAA,EAAA;EAKxB,MAAA,EAAA,MAAA;EACA,KAAA,EAAA,MAAA;AAA2B,CAAA,EAAA;;;;KAD3B,gBAAA,GAAmB,CAAA,CAAE,aAAa;KAClC,iBAAA,GAAoB,CAAA,CAAE,KAEE,CAAA,OAFW,uBAEX,CAAA;cAAvB,uBAAuB,EAAA,CAAA,CAAA,SAAA,CAAA;EAKvB,KAAA,aAAA;;;;EAAwB,KAAA,EAAA,MAAA;EAAA,SAAA,EAAA,MAAA;EAKzB,OAAA,EAAA,MAAA;AAA2B,CAAA,EAAA;EAG1B,KAAA,EAAA,MAAA;;;;cARA,wBAQuB,EARC,CAAA,CAAA,SAQD,CAAA;EAAA,KAAA,aAAA;EAIvB,MAAA,aAAA;;;;CAAwB,EAAA;EAAA,MAAA,EAAA,MAAA;EAKzB,KAAA,EAAA,MAAA;AAA2B,CAAA,CAAA;AAShC,KArBK,iBAAA,GAAoB,CAAA,CAAE,KAqBU,CAAA,OArBG,uBAqBH,CAAA;KApBhC,kBAAA,GAAqB,CAAA,CAAE,KAqBpB,CAAA,OArBiC,wBAqBjC,CAAA;cAnBF,uBAoBE,EApBqB,CAAA,CAAA,SAoBrB,CAAA;EAAkB,KAAA,aAAA;EAAvB,QAAA,aAAA;CAAI,EAAA,OAAA,cAAA,EAAA;EA2BS,KAAA,EAAA,MAAA;EACR,QAAA,EAAA,MAAA;CACA,EAAA;EAAmB,KAAA,EAAA,MAAA;EAAxB,QAAA,EAAA,MAAA;CAAI,CAAA;AAyBP,cAtEM,wBAsEgC,EAtER,CAAA,CAAA,SAsEQ,CAAA;EAC9B,KAAA,aAAA;EACA,MAAA,aAAA;CAAmB,EAAA,OAAA,cAAA,EAAA;EAAxB,MAAA,EAAA,MAAA;EAAI,KAAA,EAAA,MAAA;;;;;KAnEF,iBAAA,GAAoB,CAAA,CAAE,aAAa;KACnC,kBAAA,GAAqB,CAAA,CAAE,aAAa;;;;;;;iBAQzB,qBAAA,OACR,iBACL,KAAK,kBAAkB;;;;;;;;iBA2BV,sBAAA,OACR,iBACL,KAAK,mBAAmB;;;;;;iBAyBX,sBAAA,OACR,iBACL,KAAK,mBAAmB"}
|
|
@@ -53,13 +53,13 @@ declare const factSearchInputSchema: z.ZodObject<{
|
|
|
53
53
|
asOf: z.ZodOptional<z.ZodString>;
|
|
54
54
|
}, "strip", z.ZodTypeAny, {
|
|
55
55
|
query: string;
|
|
56
|
-
tags?: string[] | undefined;
|
|
57
56
|
topK?: number | undefined;
|
|
57
|
+
tags?: string[] | undefined;
|
|
58
58
|
asOf?: string | undefined;
|
|
59
59
|
}, {
|
|
60
60
|
query: string;
|
|
61
|
-
tags?: string[] | undefined;
|
|
62
61
|
topK?: number | undefined;
|
|
62
|
+
tags?: string[] | undefined;
|
|
63
63
|
asOf?: string | undefined;
|
|
64
64
|
}>;
|
|
65
65
|
declare const factSearchOutputSchema: z.ZodObject<{
|
|
@@ -79,17 +79,17 @@ declare const factSearchOutputSchema: z.ZodObject<{
|
|
|
79
79
|
supersededBy: z.ZodOptional<z.ZodString>;
|
|
80
80
|
}, "strip", z.ZodTypeAny, {
|
|
81
81
|
text: string;
|
|
82
|
+
score: number;
|
|
82
83
|
sensitivity: "public" | "internal" | "secret";
|
|
83
84
|
factId: string;
|
|
84
|
-
score: number;
|
|
85
85
|
validTo?: string | undefined;
|
|
86
86
|
provenance?: "user" | "tool" | "extraction" | "reflection" | "induction" | "imported" | undefined;
|
|
87
87
|
supersededBy?: string | undefined;
|
|
88
88
|
}, {
|
|
89
89
|
text: string;
|
|
90
|
+
score: number;
|
|
90
91
|
sensitivity: "public" | "internal" | "secret";
|
|
91
92
|
factId: string;
|
|
92
|
-
score: number;
|
|
93
93
|
validTo?: string | undefined;
|
|
94
94
|
provenance?: "user" | "tool" | "extraction" | "reflection" | "induction" | "imported" | undefined;
|
|
95
95
|
supersededBy?: string | undefined;
|
|
@@ -97,9 +97,9 @@ declare const factSearchOutputSchema: z.ZodObject<{
|
|
|
97
97
|
}, "strip", z.ZodTypeAny, {
|
|
98
98
|
hits: {
|
|
99
99
|
text: string;
|
|
100
|
+
score: number;
|
|
100
101
|
sensitivity: "public" | "internal" | "secret";
|
|
101
102
|
factId: string;
|
|
102
|
-
score: number;
|
|
103
103
|
validTo?: string | undefined;
|
|
104
104
|
provenance?: "user" | "tool" | "extraction" | "reflection" | "induction" | "imported" | undefined;
|
|
105
105
|
supersededBy?: string | undefined;
|
|
@@ -107,9 +107,9 @@ declare const factSearchOutputSchema: z.ZodObject<{
|
|
|
107
107
|
}, {
|
|
108
108
|
hits: {
|
|
109
109
|
text: string;
|
|
110
|
+
score: number;
|
|
110
111
|
sensitivity: "public" | "internal" | "secret";
|
|
111
112
|
factId: string;
|
|
112
|
-
score: number;
|
|
113
113
|
validTo?: string | undefined;
|
|
114
114
|
provenance?: "user" | "tool" | "extraction" | "reflection" | "induction" | "imported" | undefined;
|
|
115
115
|
supersededBy?: string | undefined;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fact-tools.d.ts","names":[],"sources":["../../src/tools/fact-tools.ts"],"sourcesContent":[],"mappings":";;;;;cAgBM,yBAAuB,CAAA,CAAA;;EAAvB,IAAA,eAAA,WAOJ,YAAA,EAAA,MAAA,CAAA,CAAA;;;;;;;;;;;;;;EAP2B,IAAA,CAAA,EAAA,MAAA,EAAA,GAAA,SAAA;EAAA,UAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAQvB,WAAA,CAAA,EAAA,QAAA,GAAA,UAUJ,GAAA,QAAA,GAAA,SAAA;;;;cAVI,0BAAwB,CAAA,CAAA;;EAAA;;AAAA;AAYE;AACC;;;;;;;;;;EAEN,WAAA,EAAA,OAAA;EAAA,gBAAA,CAAA,EAAA,WAAA,GAAA,aAAA,GAAA,SAAA;AAAA,CAAA,CAAA;KAHtB,iBAAA,GAAoB,CAAA,CAAE,aAAa;KACnC,kBAAA,GAAqB,CAAA,CAAE,aAAa;cAEnC,uBAAqB,CAAA,CAAA;;;;;;;;;;;;EAMC,IAAA,CAAA,EAAA,MAAA,
|
|
1
|
+
{"version":3,"file":"fact-tools.d.ts","names":[],"sources":["../../src/tools/fact-tools.ts"],"sourcesContent":[],"mappings":"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"}
|
|
@@ -140,17 +140,17 @@ declare const deepRecallOutputSchema: z.ZodObject<{
|
|
|
140
140
|
supersededBy: z.ZodOptional<z.ZodString>;
|
|
141
141
|
}, "strip", z.ZodTypeAny, {
|
|
142
142
|
text: string;
|
|
143
|
+
score: number;
|
|
143
144
|
sensitivity: "public" | "internal" | "secret";
|
|
144
145
|
factId: string;
|
|
145
|
-
score: number;
|
|
146
146
|
validTo?: string | undefined;
|
|
147
147
|
provenance?: string | undefined;
|
|
148
148
|
supersededBy?: string | undefined;
|
|
149
149
|
}, {
|
|
150
150
|
text: string;
|
|
151
|
+
score: number;
|
|
151
152
|
sensitivity: "public" | "internal" | "secret";
|
|
152
153
|
factId: string;
|
|
153
|
-
score: number;
|
|
154
154
|
validTo?: string | undefined;
|
|
155
155
|
provenance?: string | undefined;
|
|
156
156
|
supersededBy?: string | undefined;
|
|
@@ -167,9 +167,9 @@ declare const deepRecallOutputSchema: z.ZodObject<{
|
|
|
167
167
|
}, "strip", z.ZodTypeAny, {
|
|
168
168
|
hits: {
|
|
169
169
|
text: string;
|
|
170
|
+
score: number;
|
|
170
171
|
sensitivity: "public" | "internal" | "secret";
|
|
171
172
|
factId: string;
|
|
172
|
-
score: number;
|
|
173
173
|
validTo?: string | undefined;
|
|
174
174
|
provenance?: string | undefined;
|
|
175
175
|
supersededBy?: string | undefined;
|
|
@@ -181,9 +181,9 @@ declare const deepRecallOutputSchema: z.ZodObject<{
|
|
|
181
181
|
}, {
|
|
182
182
|
hits: {
|
|
183
183
|
text: string;
|
|
184
|
+
score: number;
|
|
184
185
|
sensitivity: "public" | "internal" | "secret";
|
|
185
186
|
factId: string;
|
|
186
|
-
score: number;
|
|
187
187
|
validTo?: string | undefined;
|
|
188
188
|
provenance?: string | undefined;
|
|
189
189
|
supersededBy?: string | undefined;
|
|
@@ -24,38 +24,38 @@ declare const runbookSearchOutputSchema: z.ZodObject<{
|
|
|
24
24
|
priority: z.ZodNumber;
|
|
25
25
|
score: z.ZodNumber;
|
|
26
26
|
}, "strip", z.ZodTypeAny, {
|
|
27
|
-
text: string;
|
|
28
|
-
score: number;
|
|
29
27
|
id: string;
|
|
28
|
+
text: string;
|
|
30
29
|
priority: number;
|
|
30
|
+
score: number;
|
|
31
31
|
steps?: string[] | undefined;
|
|
32
32
|
variables?: string[] | undefined;
|
|
33
33
|
successCriteria?: string[] | undefined;
|
|
34
34
|
}, {
|
|
35
|
-
text: string;
|
|
36
|
-
score: number;
|
|
37
35
|
id: string;
|
|
36
|
+
text: string;
|
|
38
37
|
priority: number;
|
|
38
|
+
score: number;
|
|
39
39
|
steps?: string[] | undefined;
|
|
40
40
|
variables?: string[] | undefined;
|
|
41
41
|
successCriteria?: string[] | undefined;
|
|
42
42
|
}>, "many">;
|
|
43
43
|
}, "strip", z.ZodTypeAny, {
|
|
44
44
|
procedures: {
|
|
45
|
-
text: string;
|
|
46
|
-
score: number;
|
|
47
45
|
id: string;
|
|
46
|
+
text: string;
|
|
48
47
|
priority: number;
|
|
48
|
+
score: number;
|
|
49
49
|
steps?: string[] | undefined;
|
|
50
50
|
variables?: string[] | undefined;
|
|
51
51
|
successCriteria?: string[] | undefined;
|
|
52
52
|
}[];
|
|
53
53
|
}, {
|
|
54
54
|
procedures: {
|
|
55
|
-
text: string;
|
|
56
|
-
score: number;
|
|
57
55
|
id: string;
|
|
56
|
+
text: string;
|
|
58
57
|
priority: number;
|
|
58
|
+
score: number;
|
|
59
59
|
steps?: string[] | undefined;
|
|
60
60
|
variables?: string[] | undefined;
|
|
61
61
|
successCriteria?: string[] | undefined;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"runbook-tools.d.ts","names":[],"sources":["../../src/tools/runbook-tools.ts"],"sourcesContent":[],"mappings":";;;;;;cAiBM,0BAAwB,CAAA,CAAA;;;;;;;;;;cAIxB,2BAAyB,CAAA,CAAA;;;;;;IAAA,eAAA,eAAA,WAAA,YAAA,EAAA,MAAA,CAAA,CAAA;IAAA,QAAA,aAAA;IAc1B,KAAA,aAAkB;EAClB,CAAA,EAAA,OAAA,cAAmB,EAAA;IASR,
|
|
1
|
+
{"version":3,"file":"runbook-tools.d.ts","names":[],"sources":["../../src/tools/runbook-tools.ts"],"sourcesContent":[],"mappings":";;;;;;cAiBM,0BAAwB,CAAA,CAAA;;;;;;;;;;cAIxB,2BAAyB,CAAA,CAAA;;;;;;IAAA,eAAA,eAAA,WAAA,YAAA,EAAA,MAAA,CAAA,CAAA;IAAA,QAAA,aAAA;IAc1B,KAAA,aAAkB;EAClB,CAAA,EAAA,OAAA,cAAmB,EAAA;IASR,EAAA,EAAA,MAAA;IACR,IAAA,EAAA,MAAA;IACA,QAAA,EAAA,MAAA;IAAoB,KAAA,EAAA,MAAA;IAAzB,KAAA,CAAA,EAAA,MAAA,EAAA,GAAA,SAAA;IAAI,SAAA,CAAA,EAAA,MAAA,EAAA,GAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAZF,kBAAA,GAAqB,CAAA,CAAE,aAAa;KACpC,mBAAA,GAAsB,CAAA,CAAE,aAAa;;;;;;;;iBAS1B,uBAAA,OACR,iBACL,KAAK,oBAAoB"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@graphorin/memory",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.1",
|
|
4
4
|
"description": "Six-tier memory system for the Graphorin framework: createMemory() facade with working / session / episodic / semantic / procedural / shared sub-modules, eleven memory tools wired into @graphorin/tools, hybrid vector + FTS5 search composed through Reciprocal Rank Fusion (k=60 default) with a pluggable reranker hook, a multi-stage conflict resolution pipeline (exact dedup → embedding three-zone → heuristic regex → subject/predicate → defer-to-deep) with an English locale pack default + plug-in locales, an embedder migration runner with three coexistence policies (lock-on-first / multi-active / auto-migrate), per-record embedder_id enforcement, multi-agent attribution, append-only writes with soft-delete + supersede semantics, default-on bi-temporal storage, provenance + quarantine safety gate for synthesized memory, AISpan emission for every operation, and tier-aware memory-modification guard wiring.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Oleksiy Stepurenko",
|
|
@@ -83,10 +83,10 @@
|
|
|
83
83
|
"LICENSE"
|
|
84
84
|
],
|
|
85
85
|
"dependencies": {
|
|
86
|
-
"@graphorin/core": "0.6.
|
|
87
|
-
"@graphorin/observability": "0.6.
|
|
88
|
-
"@graphorin/security": "0.6.
|
|
89
|
-
"@graphorin/tools": "0.6.
|
|
86
|
+
"@graphorin/core": "0.6.1",
|
|
87
|
+
"@graphorin/observability": "0.6.1",
|
|
88
|
+
"@graphorin/security": "0.6.1",
|
|
89
|
+
"@graphorin/tools": "0.6.1"
|
|
90
90
|
},
|
|
91
91
|
"peerDependencies": {
|
|
92
92
|
"zod": "^3.23.0 || ^4.0.0"
|
|
@@ -105,9 +105,9 @@
|
|
|
105
105
|
"better-sqlite3": "^12.9.0",
|
|
106
106
|
"fast-check": "^3.23.0",
|
|
107
107
|
"zod": "^3.25.0",
|
|
108
|
-
"@graphorin/store-sqlite": "0.6.
|
|
109
|
-
"@graphorin/embedder-transformersjs": "0.6.
|
|
110
|
-
"@graphorin/triggers": "0.6.
|
|
108
|
+
"@graphorin/store-sqlite": "0.6.1",
|
|
109
|
+
"@graphorin/embedder-transformersjs": "0.6.1",
|
|
110
|
+
"@graphorin/triggers": "0.6.1"
|
|
111
111
|
},
|
|
112
112
|
"scripts": {
|
|
113
113
|
"build": "tsdown",
|