@fgv/ts-agent-memory 5.1.0-37 → 5.1.0-39

package/lib/test/unit/tools/memoryTools.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryTools.test.js","sourceRoot":"","sources":["../../../../src/test/unit/tools/memoryTools.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n * SPDX-License-Identifier: MIT\n */\n\nimport '@fgv/ts-utils-jest';\nimport { Converter, Converters, Result, fail, succeed } from '@fgv/ts-utils';\nimport { FileTree, JsonObject } from '@fgv/ts-json-base';\nimport { AiAssist } from '@fgv/ts-extras';\nimport {\n  AdmissionDecision,\n  BodyConverterRegistry,\n  DEFAULT_MEMORY_TOOLS,\n  FileTreeMemoryStore,\n  HybridRetriever,\n  IBodyConverterRegistry,\n  IIdentityCodec,\n  IIndexedMemoryRecord,\n  IMemoryRecord,\n  IMemoryStore,\n  IMemoryToolResultItem,\n  IMemoryWriteResult,\n  IWritePolicy,\n  Kind,\n  KnowledgeIdentityCodec,\n  LinkTraversalRetriever,\n  MemoryIndex,\n  IIdentityCodecResult,\n  MemoryScopeKey,\n  MemoryToolName,\n  MtmIdentityCodec,\n  RecencyRetriever,\n  ScoreUnionMergeStrategy,\n  StructuredFilterRetriever,\n  TagRetriever,\n  createMemoryTools,\n  envelopeConverter\n} from '../../../index';\n\nconst knowledgeKind: Kind = 'knowledge' as Kind;\nconst mtmKind: Kind = 'mtm' as Kind;\n\n// ---------------------------------------------------------------------------\n// Fixtures\n// ---------------------------------------------------------------------------\n\nfunction mutableRoot(): FileTree.IMutableFileTreeDirectoryItem {\n  const tree = FileTree.inMemory([], { mutable: true }).orThrow();\n  const root = tree.getDirectory('/').orThrow();\n  if (!FileTree.isMutableDirectoryItem(root)) {\n    throw new Error('expected a mutable root directory');\n  }\n  return root;\n}\n\nfunction registryWith(\n  entries: ReadonlyArray<{ kind: Kind; converter?: Converter<string> }>\n): IBodyConverterRegistry {\n  const registry = BodyConverterRegistry.create().orThrow();\n  for (const entry of entries) {\n    registry.register(entry.kind, entry.converter ?? Converters.string);\n  }\n  return registry;\n}\n\nconst codecs: ReadonlyMap<Kind, IIdentityCodec> = new Map<Kind, IIdentityCodec>([\n  [knowledgeKind, new KnowledgeIdentityCodec()],\n  [mtmKind, new MtmIdentityCodec()]\n]);\n\n/** A write policy that always rejects — exercises the admit-reject → fail path. */\nclass RejectingPolicy implements IWritePolicy {\n  public readonly mutableFields: ReadonlyArray<string> = ['body'];\n  public admit(): Result<AdmissionDecision> {\n    return succeed({ decision: 'reject', reason: 'blocked by test policy' });\n  }\n  public applyUpdate(existing: IMemoryRecord<unknown>): Result<IMemoryRecord<unknown>> {\n    return succeed(existing);\n  }\n}\n\nfunction makeStore(\n  params: {\n    registry?: IBodyConverterRegistry;\n    writePolicies?: ReadonlyMap<Kind, IWritePolicy>;\n  } = {}\n): FileTreeMemoryStore {\n  return FileTreeMemoryStore.create({\n    root: mutableRoot(),\n    registry: params.registry ?? registryWith([{ kind: knowledgeKind }, { kind: mtmKind }]),\n    codecs,\n    writePolicies: params.writePolicies\n  }).orThrow();\n}\n\ninterface IEntrySpec {\n  readonly id: string;\n  readonly scope?: string;\n  readonly kind?: string;\n  readonly entityId?: string;\n  readonly tags?: ReadonlyArray<string>;\n  readonly updated?: number;\n  readonly links?: ReadonlyArray<string>;\n}\n\nfunction makeEntry(spec: IEntrySpec): IIndexedMemoryRecord {\n  const record: IMemoryRecord<unknown> = {\n    envelope: envelopeConverter\n      .convert({\n        id: spec.id,\n        entityId: spec.entityId ?? spec.id,\n        kind: spec.kind ?? 'knowledge',\n        tags: spec.tags ?? [],\n        links: (spec.links ?? []).map((target) => ({ type: 'rel', target })),\n        created: 0,\n        updated: spec.updated ?? 0,\n        seq: 0,\n        contentHash: 'h',\n        provenance: { source: 'agent' }\n      })\n      .orThrow(),\n    body: `body-${spec.id}`\n  };\n  return { scope: (spec.scope ?? 'knowledge') as MemoryScopeKey, record };\n}\n\nfunction makeIndex(specs: ReadonlyArray<IEntrySpec>): MemoryIndex {\n  const index = MemoryIndex.create().orThrow();\n  index.rebuild(specs.map(makeEntry)).orThrow();\n  return index;\n}\n\n/**\n * A HybridRetriever (structured + tag) over the given entries — the seedless\n * `memory_search` backing. A bare `LinkTraversalRetriever` is intentionally NOT\n * composed here: it hard-fails a seedless query, so link traversal is the\n * separate `memory_context` retriever.\n */\nfunction makeRetriever(specs: ReadonlyArray<IEntrySpec>): HybridRetriever {\n  const index = makeIndex(specs);\n  return HybridRetriever.create(\n    [\n      RecencyRetriever.create(index).orThrow(),\n      StructuredFilterRetriever.create(index).orThrow(),\n      TagRetriever.create(index).orThrow()\n    ],\n    ScoreUnionMergeStrategy.create().orThrow()\n  ).orThrow();\n}\n\n/** A LinkTraversalRetriever over the given entries — the `memory_context` backing. */\nfunction makeLinkRetriever(specs: ReadonlyArray<IEntrySpec>): LinkTraversalRetriever {\n  return LinkTraversalRetriever.create(makeIndex(specs)).orThrow();\n}\n\n/** Build the full five-tool suite for structural / annotation inspection. */\nfunction allTools(\n  overrides: Partial<Parameters<typeof createMemoryTools>[0]> = {}\n): ReadonlyArray<AiAssist.IAiClientTool> {\n  return createMemoryTools({\n    store: overrides.store ?? makeStore(),\n    retriever: overrides.retriever ?? makeRetriever([]),\n    registry: overrides.registry ?? registryWith([{ kind: knowledgeKind }, { kind: mtmKind }]),\n    codecs,\n    tools: ['memory_write', 'memory_read', 'memory_search', 'memory_context', 'memory_delete'],\n    ...overrides\n  });\n}\n\nfunction toolByName(\n  tools: ReadonlyArray<AiAssist.IAiClientTool>,\n  name: MemoryToolName\n): AiAssist.IAiClientTool {\n  const tool = tools.find((t) => t.config.name === name);\n  if (tool === undefined) {\n    throw new Error(`tool '${name}' not found`);\n  }\n  return tool;\n}\n\n/** The property names declared by a tool's JSON-schema. */\nfunction schemaProperties(tool: AiAssist.IAiClientTool): string[] {\n  const json = tool.config.parametersSchema.toJson() as JsonObject;\n  return Object.keys((json.properties as JsonObject) ?? {});\n}\n\n// ---------------------------------------------------------------------------\n// Tests\n// ---------------------------------------------------------------------------\n\ndescribe('createMemoryTools', () => {\n  describe('tool subset selection', () => {\n    test('defaults to the read-only set (excludes memory_write / memory_delete)', () => {\n      const tools = createMemoryTools({\n        store: makeStore(),\n        retriever: makeRetriever([]),\n        registry: registryWith([{ kind: knowledgeKind }])\n      });\n      expect(tools.map((t) => t.config.name)).toEqual(['memory_search', 'memory_context']);\n      expect(DEFAULT_MEMORY_TOOLS).toEqual(['memory_search', 'memory_context']);\n    });\n\n    test('includes memory_write / memory_delete only when named', () => {\n      const tools = createMemoryTools({\n        store: makeStore(),\n        retriever: makeRetriever([]),\n        registry: registryWith([{ kind: knowledgeKind }]),\n        codecs,\n        tools: ['memory_write', 'memory_delete']\n      });\n      expect(tools.map((t) => t.config.name)).toEqual(['memory_write', 'memory_delete']);\n    });\n\n    test('returns tools in a stable builder order regardless of selection order', () => {\n      const tools = createMemoryTools({\n        store: makeStore(),\n        retriever: makeRetriever([]),\n        registry: registryWith([{ kind: knowledgeKind }]),\n        codecs,\n        tools: ['memory_delete', 'memory_search', 'memory_write']\n      });\n      expect(tools.map((t) => t.config.name)).toEqual(['memory_write', 'memory_search', 'memory_delete']);\n    });\n\n    test('an empty selection yields no tools', () => {\n      const tools = createMemoryTools({\n        store: makeStore(),\n        retriever: makeRetriever([]),\n        registry: registryWith([{ kind: knowledgeKind }]),\n        tools: []\n      });\n      expect(tools).toEqual([]);\n    });\n  });\n\n  describe('scope isolation (adoption gate)', () => {\n    test('NO tool schema declares a scope (or scope-widening) property', () => {\n      const tools = allTools();\n      expect(tools).toHaveLength(5);\n      for (const tool of tools) {\n        const props = schemaProperties(tool);\n        expect(props.length).toBeGreaterThan(0);\n        for (const prop of props) {\n          expect(prop.toLowerCase()).not.toContain('scope');\n        }\n      }\n    });\n  });\n\n  describe('behavior annotations (Component 4)', () => {\n    test('read-only tools are readOnlyHint with openWorldHint false', () => {\n      const tools = allTools();\n      for (const name of ['memory_search', 'memory_context', 'memory_read'] as const) {\n        expect(toolByName(tools, name).config.annotations).toEqual({\n          readOnlyHint: true,\n          openWorldHint: false\n        });\n      }\n    });\n\n    test('memory_write is non-destructive, non-idempotent, closed-world', () => {\n      expect(toolByName(allTools(), 'memory_write').config.annotations).toEqual({\n        destructiveHint: false,\n        idempotentHint: false,\n        openWorldHint: false\n      });\n    });\n\n    test('memory_delete is destructive, idempotent, closed-world', () => {\n      expect(toolByName(allTools(), 'memory_delete').config.annotations).toEqual({\n        destructiveHint: true,\n        idempotentHint: true,\n        openWorldHint: false\n      });\n    });\n  });\n\n  describe('parametersSchema validation', () => {\n    test('memory_write accepts a well-formed record and rejects a missing body', () => {\n      const schema = toolByName(allTools(), 'memory_write').config.parametersSchema;\n      expect(schema.convert({ kind: 'knowledge', entityId: 'doc-1', body: 'hello' })).toSucceed();\n      expect(\n        schema.convert({\n          kind: 'knowledge',\n          entityId: 'doc-1',\n          body: 'hello',\n          tags: ['a'],\n          links: [{ type: 'rel', target: 'doc-2', confidence: 0.5 }]\n        })\n      ).toSucceed();\n      expect(schema.convert({ kind: 'knowledge', entityId: 'doc-1' })).toFail();\n    });\n\n    test('memory_read / memory_delete require kind and entityId', () => {\n      for (const name of ['memory_read', 'memory_delete'] as const) {\n        const schema = toolByName(allTools(), name).config.parametersSchema;\n        expect(schema.convert({ kind: 'knowledge', entityId: 'doc-1' })).toSucceed();\n        expect(schema.convert({ kind: 'knowledge' })).toFail();\n      }\n    });\n\n    test('memory_search rejects a non-integer limit and accepts an all-optional query', () => {\n      const schema = toolByName(allTools(), 'memory_search').config.parametersSchema;\n      expect(schema.convert({})).toSucceed();\n      expect(schema.convert({ tag: 'x', limit: 3 })).toSucceed();\n      expect(schema.convert({ limit: 'three' })).toFail();\n    });\n\n    test('memory_context requires a from seed', () => {\n      const schema = toolByName(allTools(), 'memory_context').config.parametersSchema;\n      expect(schema.convert({ from: 'doc-1' })).toSucceed();\n      expect(schema.convert({ hops: 2 })).toFail();\n    });\n  });\n\n  describe('memory_write', () => {\n    async function write(\n      tool: AiAssist.IAiClientTool,\n      args: Record<string, unknown>\n    ): Promise<Result<unknown>> {\n      return tool.execute(args);\n    }\n\n    test('writes a new record (outcome: written) and round-trips through memory_read', async () => {\n      const store = makeStore();\n      const tools = createMemoryTools({\n        store,\n        retriever: makeRetriever([]),\n        registry: registryWith([{ kind: knowledgeKind }]),\n        codecs,\n        tools: ['memory_write', 'memory_read']\n      });\n      const writeTool = toolByName(tools, 'memory_write');\n      expect(\n        await write(writeTool, { kind: 'knowledge', entityId: 'doc-1', body: 'first', tags: ['t'] })\n      ).toSucceedAndSatisfy((value) => {\n        const result = value as IMemoryWriteResult;\n        expect(result.outcome).toBe('written');\n        expect(result.id).toBe('doc-1');\n        expect(result.entityId).toBe('doc-1');\n      });\n      expect(\n        await toolByName(tools, 'memory_read').execute({ kind: 'knowledge', entityId: 'doc-1' })\n      ).toSucceedAndSatisfy((value) => {\n        const read = value as { found: boolean; item: IMemoryToolResultItem };\n        expect(read.found).toBe(true);\n        expect(read.item.body).toBe('first');\n        expect(read.item.tags).toEqual(['t']);\n      });\n    });\n\n    test('persists authored links (with confidence) on the written record', async () => {\n      const store = makeStore();\n      const tools = createMemoryTools({\n        store,\n        retriever: makeRetriever([]),\n        registry: registryWith([{ kind: knowledgeKind }]),\n        codecs,\n        tools: ['memory_write', 'memory_read']\n      });\n      expect(\n        await toolByName(tools, 'memory_write').execute({\n          kind: 'knowledge',\n          entityId: 'doc-1',\n          body: 'linked',\n          links: [\n            { type: 'rel', target: 'doc-2', confidence: 0.9 },\n            { type: 'rel', target: 'doc-3' }\n          ]\n        })\n      ).toSucceedAndSatisfy((v) => expect((v as IMemoryWriteResult).outcome).toBe('written'));\n      expect(\n        await toolByName(tools, 'memory_read').execute({ kind: 'knowledge', entityId: 'doc-1' })\n      ).toSucceedAndSatisfy(() => undefined);\n    });\n\n    test('an identical re-put of the same entity is a dedup no-op (outcome: deduped)', async () => {\n      const store = makeStore();\n      const tool = toolByName(allTools({ store }), 'memory_write');\n      expect(await write(tool, { kind: 'knowledge', entityId: 'doc-1', body: 'same' })).toSucceedAndSatisfy(\n        (v) => expect((v as IMemoryWriteResult).outcome).toBe('written')\n      );\n      expect(await write(tool, { kind: 'knowledge', entityId: 'doc-1', body: 'same' })).toSucceedAndSatisfy(\n        (v) => expect((v as IMemoryWriteResult).outcome).toBe('deduped')\n      );\n    });\n\n    test('content-scope dedup under a different entity reports deduped', async () => {\n      const store = makeStore();\n      const tool = toolByName(allTools({ store }), 'memory_write');\n      expect(await write(tool, { kind: 'knowledge', entityId: 'doc-a', body: 'shared' })).toSucceed();\n      // Knowledge dedups scope-wide: identical body under a different docId is a no-op\n      // that returns the existing (different-entity) record.\n      expect(await write(tool, { kind: 'knowledge', entityId: 'doc-b', body: 'shared' })).toSucceedAndSatisfy(\n        (v) => expect((v as IMemoryWriteResult).outcome).toBe('deduped')\n      );\n    });\n\n    test('an update with new content reports written', async () => {\n      const store = makeStore();\n      const tool = toolByName(allTools({ store }), 'memory_write');\n      expect(await write(tool, { kind: 'knowledge', entityId: 'doc-1', body: 'v1' })).toSucceed();\n      expect(await write(tool, { kind: 'knowledge', entityId: 'doc-1', body: 'v2' })).toSucceedAndSatisfy(\n        (v) => expect((v as IMemoryWriteResult).outcome).toBe('written')\n      );\n    });\n\n    test('maps an MTM composite entityId to its turn stem', async () => {\n      const store = makeStore();\n      const tools = createMemoryTools({\n        store,\n        retriever: makeRetriever([]),\n        registry: registryWith([{ kind: knowledgeKind }, { kind: mtmKind }]),\n        codecs,\n        tools: ['memory_write', 'memory_read']\n      });\n      expect(\n        await toolByName(tools, 'memory_write').execute({\n          kind: 'mtm',\n          entityId: 'conv-1:7',\n          body: 'turn body'\n        })\n      ).toSucceedAndSatisfy((value) => {\n        const result = value as IMemoryWriteResult;\n        expect(result.id).toBe('turn-7');\n        expect(result.entityId).toBe('conv-1:7');\n      });\n      // Read back via the same composite entityId.\n      expect(\n        await toolByName(tools, 'memory_read').execute({ kind: 'mtm', entityId: 'conv-1:7' })\n      ).toSucceedAndSatisfy((value) => {\n        expect((value as { found: boolean }).found).toBe(true);\n      });\n    });\n\n    test('a body the kind converter rejects fails the write', async () => {\n      const rejectBad: Converter<string> = Converters.string.map((s) =>\n        s === 'BAD' ? fail('body not allowed') : succeed(s)\n      );\n      const registry = registryWith([{ kind: knowledgeKind, converter: rejectBad }]);\n      const store = makeStore({ registry });\n      const tool = toolByName(allTools({ store, registry }), 'memory_write');\n      expect(await write(tool, { kind: 'knowledge', entityId: 'doc-1', body: 'BAD' })).toFailWith(\n        /invalid body|body not allowed/i\n      );\n    });\n\n    test('a policy admit-reject surfaces as a failure', async () => {\n      const store = makeStore({\n        writePolicies: new Map<Kind, IWritePolicy>([[knowledgeKind, new RejectingPolicy()]])\n      });\n      const tool = toolByName(allTools({ store }), 'memory_write');\n      expect(await write(tool, { kind: 'knowledge', entityId: 'doc-1', body: 'x' })).toFailWith(\n        /rejected by policy|blocked by test policy/i\n      );\n    });\n\n    test('fails when no codec is available for the kind', async () => {\n      const store = makeStore();\n      const tool = toolByName(\n        createMemoryTools({\n          store,\n          retriever: makeRetriever([]),\n          registry: registryWith([{ kind: knowledgeKind }]),\n          tools: ['memory_write'] // no codecs / defaultCodec supplied\n        }),\n        'memory_write'\n      );\n      expect(await write(tool, { kind: 'knowledge', entityId: 'doc-1', body: 'x' })).toFailWith(\n        /no identity codec available/i\n      );\n    });\n\n    test('rejects a kind with no registered converter', async () => {\n      const tool = toolByName(allTools(), 'memory_write');\n      expect(await write(tool, { kind: 'unregistered', entityId: 'doc-1', body: 'x' })).toFailWith(\n        /no registered body converter/i\n      );\n    });\n\n    test('rejects a kind outside the kinds whitelist', async () => {\n      const tool = toolByName(allTools({ kinds: [mtmKind] }), 'memory_write');\n      expect(await write(tool, { kind: 'knowledge', entityId: 'doc-1', body: 'x' })).toFailWith(\n        /not enabled for memory tools/i\n      );\n    });\n\n    test('propagates a store.get failure (does not mask a real fault as a fresh write)', async () => {\n      const failingStore: IMemoryStore = {\n        get: async () => fail('disk fault'),\n        getById: async () => fail('unused'),\n        list: async () => succeed([]),\n        put: async (record) => succeed(record),\n        delete: async () => fail('unused')\n      };\n      const tool = toolByName(\n        createMemoryTools({\n          store: failingStore,\n          retriever: makeRetriever([]),\n          registry: registryWith([{ kind: knowledgeKind }]),\n          codecs,\n          tools: ['memory_write']\n        }),\n        'memory_write'\n      );\n      expect(await write(tool, { kind: 'knowledge', entityId: 'doc-1', body: 'x' })).toFailWith(\n        /disk fault/i\n      );\n    });\n\n    test('rejects a versioned/temporal kind', async () => {\n      const versionedCodec: IIdentityCodec = {\n        encode: (entityId): Result<IIdentityCodecResult> =>\n          succeed({ scope: 'knowledge' as MemoryScopeKey, idStem: entityId as string, isVersioned: true }),\n        decode: (): Result<never> => fail('unused'),\n        verifyRoundTrip: (): Result<true> => succeed(true)\n      };\n      const tool = toolByName(\n        createMemoryTools({\n          store: makeStore(),\n          retriever: makeRetriever([]),\n          registry: registryWith([{ kind: knowledgeKind }]),\n          codecs: new Map<Kind, IIdentityCodec>([[knowledgeKind, versionedCodec]]),\n          tools: ['memory_write']\n        }),\n        'memory_write'\n      );\n      expect(await write(tool, { kind: 'knowledge', entityId: 'doc-1', body: 'x' })).toFailWith(\n        /versioned\\/temporal kind .* is not supported/i\n      );\n    });\n\n    test('rejects malformed arguments', async () => {\n      const tool = toolByName(allTools(), 'memory_write');\n      expect(await write(tool, { kind: 'knowledge', entityId: 'doc-1' })).toFailWith(/invalid arguments/i);\n    });\n  });\n\n  describe('memory_read', () => {\n    test('returns found:false when the record is absent', async () => {\n      const tool = toolByName(allTools(), 'memory_read');\n      expect(await tool.execute({ kind: 'knowledge', entityId: 'missing' })).toSucceedWith({ found: false });\n    });\n\n    test('applies the handleFor hook to the returned item', async () => {\n      const store = makeStore();\n      const tools = createMemoryTools({\n        store,\n        retriever: makeRetriever([]),\n        registry: registryWith([{ kind: knowledgeKind }]),\n        codecs,\n        tools: ['memory_write', 'memory_read'],\n        handleFor: (r) => `mnemonic:${r.envelope.id}`\n      });\n      await toolByName(tools, 'memory_write').execute({ kind: 'knowledge', entityId: 'doc-1', body: 'b' });\n      expect(\n        await toolByName(tools, 'memory_read').execute({ kind: 'knowledge', entityId: 'doc-1' })\n      ).toSucceedAndSatisfy((value) => {\n        const read = value as { found: boolean; item: IMemoryToolResultItem };\n        expect(read.item.handle).toBe('mnemonic:doc-1');\n      });\n    });\n\n    test('propagates a store failure (bad entityId)', async () => {\n      const tool = toolByName(allTools(), 'memory_read');\n      expect(await tool.execute({ kind: 'knowledge', entityId: '   ' })).toFail();\n    });\n  });\n\n  describe('memory_search', () => {\n    test('returns projected results keyed by raw MemoryId when no handleFor is supplied', async () => {\n      const retriever = makeRetriever([\n        { id: 'doc-1', tags: ['topic'] },\n        { id: 'doc-2', tags: ['topic'] }\n      ]);\n      const tool = toolByName(\n        createMemoryTools({\n          store: makeStore(),\n          retriever,\n          registry: registryWith([{ kind: knowledgeKind }])\n        }),\n        'memory_search'\n      );\n      expect(await tool.execute({ tag: 'topic' })).toSucceedAndSatisfy((value) => {\n        const out = value as { count: number; results: ReadonlyArray<IMemoryToolResultItem> };\n        expect(out.count).toBe(2);\n        expect(out.results.map((r) => r.handle).sort()).toEqual(['doc-1', 'doc-2']);\n      });\n    });\n\n    test('uses the host handle (mnemonic) as the agent-visible key when handleFor is supplied', async () => {\n      const retriever = makeRetriever([{ id: 'doc-1', tags: ['topic'] }]);\n      const tool = toolByName(\n        createMemoryTools({\n          store: makeStore(),\n          retriever,\n          registry: registryWith([{ kind: knowledgeKind }]),\n          handleFor: (r) => `@${r.envelope.id}`\n        }),\n        'memory_search'\n      );\n      expect(await tool.execute({ tag: 'topic', limit: 5 })).toSucceedAndSatisfy((value) => {\n        const out = value as { results: ReadonlyArray<IMemoryToolResultItem> };\n        expect(out.results[0].handle).toBe('@doc-1');\n      });\n    });\n\n    test('falls back to the raw id when a throwing handleFor would otherwise escape', async () => {\n      const retriever = makeRetriever([{ id: 'doc-1', tags: ['topic'] }]);\n      const tool = toolByName(\n        createMemoryTools({\n          store: makeStore(),\n          retriever,\n          registry: registryWith([{ kind: knowledgeKind }]),\n          handleFor: () => {\n            throw new Error('host handle hook blew up');\n          }\n        }),\n        'memory_search'\n      );\n      // A throwing host callback must not crash the search; the item degrades to the raw id.\n      expect(await tool.execute({ tag: 'topic', limit: 5 })).toSucceedAndSatisfy((value) => {\n        const out = value as { results: ReadonlyArray<IMemoryToolResultItem> };\n        expect(out.results[0].handle).toBe('doc-1');\n      });\n    });\n\n    test('loud-degrades on the unwired semantic axis', async () => {\n      const retriever = makeRetriever([{ id: 'doc-1' }]);\n      const tool = toolByName(\n        createMemoryTools({\n          store: makeStore(),\n          retriever,\n          registry: registryWith([{ kind: knowledgeKind }])\n        }),\n        'memory_search'\n      );\n      expect(await tool.execute({ semantic: 'find me' })).toFailWith(\n        /semantic recall requires a vector index/i\n      );\n    });\n\n    test('rejects a kind outside the kinds whitelist', async () => {\n      const retriever = makeRetriever([{ id: 'doc-1' }]);\n      const tool = toolByName(\n        createMemoryTools({\n          store: makeStore(),\n          retriever,\n          registry: registryWith([{ kind: knowledgeKind }]),\n          kinds: [knowledgeKind]\n        }),\n        'memory_search'\n      );\n      expect(await tool.execute({ kind: 'mtm' })).toFailWith(/no registered body converter|not enabled/i);\n    });\n\n    test('filters by a validated kind', async () => {\n      const retriever = makeRetriever([\n        { id: 'doc-1', kind: 'knowledge' },\n        { id: 'turn-0', kind: 'mtm', scope: 'conversations/conv-1' }\n      ]);\n      const tool = toolByName(\n        createMemoryTools({\n          store: makeStore(),\n          retriever,\n          registry: registryWith([{ kind: knowledgeKind }, { kind: mtmKind }])\n        }),\n        'memory_search'\n      );\n      expect(await tool.execute({ kind: 'knowledge' })).toSucceedAndSatisfy((value) => {\n        const out = value as { results: ReadonlyArray<IMemoryToolResultItem> };\n        expect(out.results.map((r) => r.handle)).toEqual(['doc-1']);\n      });\n    });\n\n    test('rejects malformed arguments', async () => {\n      const tool = toolByName(allTools(), 'memory_search');\n      expect(await tool.execute({ limit: 'nope' })).toFailWith(/invalid arguments/i);\n    });\n  });\n\n  describe('memory_context', () => {\n    test('returns the neighbors reachable from a seed', async () => {\n      const retriever = makeLinkRetriever([\n        { id: 'a', links: ['b', 'c'] },\n        { id: 'b', updated: 20 },\n        { id: 'c', updated: 10 }\n      ]);\n      const tool = toolByName(\n        createMemoryTools({\n          store: makeStore(),\n          retriever,\n          registry: registryWith([{ kind: knowledgeKind }])\n        }),\n        'memory_context'\n      );\n      expect(await tool.execute({ from: 'a' })).toSucceedAndSatisfy((value) => {\n        const out = value as { seed: string; count: number; results: ReadonlyArray<IMemoryToolResultItem> };\n        expect(out.seed).toBe('a');\n        expect(out.results.map((r) => r.handle)).toEqual(['b', 'c']);\n      });\n    });\n\n    test('honors hops, kind, tag, and limit filters', async () => {\n      const retriever = makeLinkRetriever([\n        { id: 'a', links: ['b'] },\n        { id: 'b', links: ['c'], tags: ['keep'] },\n        { id: 'c', tags: ['keep'] }\n      ]);\n      const tool = toolByName(\n        createMemoryTools({\n          store: makeStore(),\n          retriever,\n          registry: registryWith([{ kind: knowledgeKind }])\n        }),\n        'memory_context'\n      );\n      expect(\n        await tool.execute({ from: 'a', hops: 2, tag: 'keep', kind: 'knowledge', limit: 5 })\n      ).toSucceedAndSatisfy((value) => {\n        const out = value as { results: ReadonlyArray<IMemoryToolResultItem> };\n        expect(out.results.map((r) => r.handle).sort()).toEqual(['b', 'c']);\n      });\n    });\n\n    test('rejects an invalid seed id', async () => {\n      const tool = toolByName(allTools(), 'memory_context');\n      expect(await tool.execute({ from: 'a/b' })).toFail();\n    });\n\n    test('rejects malformed arguments', async () => {\n      const tool = toolByName(allTools(), 'memory_context');\n      expect(await tool.execute({ hops: 1 })).toFailWith(/invalid arguments/i);\n    });\n  });\n\n  describe('memory_delete', () => {\n    test('deletes an existing record', async () => {\n      const store = makeStore();\n      const tools = createMemoryTools({\n        store,\n        retriever: makeRetriever([]),\n        registry: registryWith([{ kind: knowledgeKind }]),\n        codecs,\n        tools: ['memory_write', 'memory_delete', 'memory_read']\n      });\n      await toolByName(tools, 'memory_write').execute({ kind: 'knowledge', entityId: 'doc-1', body: 'b' });\n      expect(\n        await toolByName(tools, 'memory_delete').execute({ kind: 'knowledge', entityId: 'doc-1' })\n      ).toSucceedWith({ deleted: true, id: 'doc-1', entityId: 'doc-1', kind: 'knowledge' });\n      expect(\n        await toolByName(tools, 'memory_read').execute({ kind: 'knowledge', entityId: 'doc-1' })\n      ).toSucceedWith({ found: false });\n    });\n\n    test('propagates a store failure when the record is absent', async () => {\n      const tool = toolByName(allTools(), 'memory_delete');\n      expect(await tool.execute({ kind: 'knowledge', entityId: 'missing' })).toFailWith(/no record found/i);\n    });\n\n    test('rejects a kind outside the whitelist', async () => {\n      const tool = toolByName(allTools({ kinds: [knowledgeKind] }), 'memory_delete');\n      expect(await tool.execute({ kind: 'mtm', entityId: 'conv-1:0' })).toFailWith(/not enabled/i);\n    });\n\n    test('rejects malformed arguments', async () => {\n      const tool = toolByName(allTools(), 'memory_delete');\n      expect(await tool.execute({ kind: 'knowledge' })).toFailWith(/invalid arguments/i);\n    });\n  });\n});\n"]}

package/lib/test/unit/types/temporalCodec.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=temporalCodec.test.d.ts.map

package/lib/test/unit/types/temporalCodec.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporalCodec.test.d.ts","sourceRoot":"","sources":["../../../../src/test/unit/types/temporalCodec.test.ts"],"names":[],"mappings":"AAKA,OAAO,oBAAoB,CAAC"}

package/lib/test/unit/types/temporalCodec.test.js

@@ -0,0 +1,205 @@
+"use strict";
+/*
+ * Copyright (c) 2026 Erik Fortune
+ * SPDX-License-Identifier: MIT
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+require("@fgv/ts-utils-jest");
+const types_1 = require("../../../packlets/types");
+const converters_1 = require("../../../packlets/converters");
+const codec = types_1.TemporalIdentityCodec.create('facts').orThrow();
+describe('TemporalIdentityCodec', () => {
+    describe('create', () => {
+        test('rejects a non-portable base scope', () => {
+            expect(types_1.TemporalIdentityCodec.create('has/slash')).toFailWith(/baseScope/i);
+        });
+    });
+    describe('encode', () => {
+        test('maps an entityId to the entity subtree, versioned', () => {
+            expect(codec.encode('fact-1')).toSucceedWith({
+                scope: 'facts/entities/fact-1',
+                idStem: 'fact-1',
+                isVersioned: true
+            });
+        });
+        test('rejects a non-portable entityId', () => {
+            expect(codec.encode('bad/id')).toFailWith(/entityId/i);
+        });
+    });
+    describe('encodeVersion', () => {
+        test('forms the <entityId>-v<seq> stem', () => {
+            expect(codec.encodeVersion('fact-1', 7)).toSucceedWith('fact-1-v7');
+        });
+        test('rejects a negative or non-integer seq', () => {
+            expect(codec.encodeVersion('fact-1', -1)).toFailWith(/non-negative integer/i);
+            expect(codec.encodeVersion('fact-1', 1.5)).toFailWith(/non-negative integer/i);
+        });
+        test('rejects a non-portable entityId', () => {
+            expect(codec.encodeVersion('bad/id', 1)).toFailWith(/entityId/i);
+        });
+    });
+    describe('decode / decodeVersion', () => {
+        test('recovers the entityId and seq from a (scope, version stem)', () => {
+            expect(codec.decodeVersion('facts/entities/fact-1', 'fact-1-v3')).toSucceedWith({
+                entityId: 'fact-1',
+                seq: 3
+            });
+            expect(codec.decode('facts/entities/fact-1', 'fact-1-v3')).toSucceedWith('fact-1');
+        });
+        test('disambiguates an entityId that itself ends in -v<digits> via the scope', () => {
+            // The subtree scope is authoritative for the entityId, so a stem whose
+            // entityId is `rev-v2` parses correctly.
+            expect(codec.decodeVersion('facts/entities/rev-v2', 'rev-v2-v5')).toSucceedWith({
+                entityId: 'rev-v2',
+                seq: 5
+            });
+        });
+        test('rejects a scope that is not <base>/entities/<entityId>', () => {
+            expect(codec.decodeVersion('facts/fact-1', 'fact-1-v0')).toFailWith(/must be 'facts\/entities\/<entityId>'/i);
+            expect(codec.decodeVersion('other/entities/fact-1', 'fact-1-v0')).toFailWith(/must be 'facts\/entities\/<entityId>'/i);
+        });
+        test('rejects a non-portable entityId embedded in the scope', () => {
+            expect(codec.decodeVersion('facts/entities/ ', ' -v0')).toFailWith(/entityId/i);
+        });
+        test('rejects a stem that does not carry the entity prefix', () => {
+            expect(codec.decodeVersion('facts/entities/fact-1', 'other-v0')).toFailWith(/must begin with 'fact-1-v'/i);
+        });
+        test('rejects a stem with a non-integer version suffix', () => {
+            expect(codec.decodeVersion('facts/entities/fact-1', 'fact-1-vX')).toFailWith(/non-integer version suffix/i);
+        });
+        test('rejects a version suffix outside the safe integer range (corruption/tamper guard)', () => {
+            // A very long digit run passes the regex but overflows Number.MAX_SAFE_INTEGER;
+            // parseInt would silently lose precision, so decode must fail rather than corrupt seq.
+            expect(codec.decodeVersion('facts/entities/fact-1', 'fact-1-v99999999999999999999')).toFailWith(/outside the safe integer range/i);
+        });
+    });
+    describe('verifyRoundTrip', () => {
+        test('succeeds for a well-formed (scope, version stem)', () => {
+            expect(codec.verifyRoundTrip('facts/entities/fact-1', 'fact-1-v9')).toSucceedWith(true);
+        });
+        test('fails when the stem cannot be decoded', () => {
+            expect(codec.verifyRoundTrip('facts/entities/fact-1', 'fact-1-vZ')).toFailWith(/non-integer version suffix/i);
+        });
+        test('fails on a non-canonical (zero-padded) seq stem', () => {
+            // `-v007` decodes to seq 7 but re-encodes to `-v7`, so it is not canonical.
+            expect(codec.verifyRoundTrip('facts/entities/fact-1', 'fact-1-v007')).toFailWith(/round-trip mismatch/i);
+        });
+    });
+});
+describe('isTemporalIdentityCodec', () => {
+    test('is true for a temporal codec', () => {
+        expect((0, types_1.isTemporalIdentityCodec)(codec)).toBe(true);
+    });
+    test('is false for a flat codec', () => {
+        const flat = new types_1.KnowledgeIdentityCodec();
+        expect((0, types_1.isTemporalIdentityCodec)(flat)).toBe(false);
+    });
+});
+/** Build a temporal version record for the selection-helper tests. */
+// eslint-disable-next-line @rushstack/no-new-null -- invalid_at null is the meaningful still-valid sentinel
+function versionRecord(seq, validAt, invalidAt) {
+    const temporal = { valid_at: validAt };
+    if (invalidAt !== undefined) {
+        temporal.invalid_at = invalidAt;
+    }
+    return {
+        envelope: converters_1.envelopeConverter
+            .convert({
+            id: `fact-1-v${seq}`,
+            entityId: 'fact-1',
+            kind: 'fact',
+            tags: [],
+            links: [],
+            created: validAt,
+            updated: validAt,
+            seq,
+            contentHash: `h${seq}`,
+            provenance: { source: 'agent' },
+            temporal
+        })
+            .orThrow(),
+        body: `body v${seq}`
+    };
+}
+describe('temporal selection helpers', () => {
+    const v1 = versionRecord(1, 100, 200);
+    const v2 = versionRecord(2, 200);
+    const atemporal = {
+        envelope: converters_1.envelopeConverter
+            .convert({
+            id: 'doc',
+            entityId: 'doc',
+            kind: 'knowledge',
+            tags: [],
+            links: [],
+            created: 0,
+            updated: 0,
+            seq: 0,
+            contentHash: 'h',
+            provenance: { source: 'agent' }
+        })
+            .orThrow(),
+        body: 'flat'
+    };
+    test('isTemporalRecord keys off the temporal block', () => {
+        expect((0, types_1.isTemporalRecord)(v1)).toBe(true);
+        expect((0, types_1.isTemporalRecord)(atemporal)).toBe(false);
+    });
+    test('isVersionCurrent is true only for a null/absent invalid_at', () => {
+        expect((0, types_1.isVersionCurrent)(v1)).toBe(false);
+        expect((0, types_1.isVersionCurrent)(v2)).toBe(true);
+        expect((0, types_1.isVersionCurrent)(versionRecord(3, 300, null))).toBe(true);
+        expect((0, types_1.isVersionCurrent)(atemporal)).toBe(false);
+    });
+    test('isVersionValidAt bounds by valid_at and invalid_at', () => {
+        expect((0, types_1.isVersionValidAt)(v1, 50)).toBe(false); // before valid_at
+        expect((0, types_1.isVersionValidAt)(v1, 150)).toBe(true); // within [100, 200)
+        expect((0, types_1.isVersionValidAt)(v1, 200)).toBe(false); // at invalid_at (exclusive)
+        expect((0, types_1.isVersionValidAt)(v2, 500)).toBe(true); // still valid
+        expect((0, types_1.isVersionValidAt)(atemporal, 500)).toBe(false);
+    });
+    test('isVersionValidAt defaults valid_at to created when absent', () => {
+        const noValidAt = {
+            envelope: converters_1.envelopeConverter
+                .convert({
+                id: 'fact-1-v4',
+                entityId: 'fact-1',
+                kind: 'fact',
+                tags: [],
+                links: [],
+                created: 400,
+                updated: 400,
+                seq: 4,
+                contentHash: 'h4',
+                provenance: { source: 'agent' },
+                temporal: {}
+            })
+                .orThrow(),
+            body: 'v4'
+        };
+        expect((0, types_1.isVersionValidAt)(noValidAt, 399)).toBe(false);
+        expect((0, types_1.isVersionValidAt)(noValidAt, 400)).toBe(true);
+    });
+    test('selectCurrentVersion returns the highest-seq current version', () => {
+        var _a;
+        expect((_a = (0, types_1.selectCurrentVersion)([v1, v2])) === null || _a === void 0 ? void 0 : _a.envelope.id).toBe('fact-1-v2');
+        // A fully-invalidated entity has no current version.
+        expect((0, types_1.selectCurrentVersion)([v1])).toBeUndefined();
+        expect((0, types_1.selectCurrentVersion)([])).toBeUndefined();
+    });
+    test('selectCurrentVersion is order-independent (highest seq wins on an unsorted input)', () => {
+        var _a, _b;
+        const v3 = versionRecord(3, 300);
+        // Descending input: the first candidate is already the max, so a later
+        // candidate must NOT displace it.
+        expect((_a = (0, types_1.selectCurrentVersion)([v3, v2])) === null || _a === void 0 ? void 0 : _a.envelope.id).toBe('fact-1-v3');
+        expect((_b = (0, types_1.selectCurrentVersion)([v2, v3])) === null || _b === void 0 ? void 0 : _b.envelope.id).toBe('fact-1-v3');
+    });
+    test('selectVersionAsOf returns the highest-seq version valid at the instant', () => {
+        var _a, _b;
+        expect((_a = (0, types_1.selectVersionAsOf)([v1, v2], 150)) === null || _a === void 0 ? void 0 : _a.envelope.id).toBe('fact-1-v1');
+        expect((_b = (0, types_1.selectVersionAsOf)([v1, v2], 250)) === null || _b === void 0 ? void 0 : _b.envelope.id).toBe('fact-1-v2');
+        expect((0, types_1.selectVersionAsOf)([v1, v2], 50)).toBeUndefined();
+    });
+});
+//# sourceMappingURL=temporalCodec.test.js.map

package/lib/test/unit/types/temporalCodec.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporalCodec.test.js","sourceRoot":"","sources":["../../../../src/test/unit/types/temporalCodec.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n * SPDX-License-Identifier: MIT\n */\n\nimport '@fgv/ts-utils-jest';\nimport {\n  EntityId,\n  IIdentityCodec,\n  IMemoryRecord,\n  KnowledgeIdentityCodec,\n  MemoryScopeKey,\n  TemporalIdentityCodec,\n  isTemporalIdentityCodec,\n  isTemporalRecord,\n  isVersionCurrent,\n  isVersionValidAt,\n  selectCurrentVersion,\n  selectVersionAsOf\n} from '../../../packlets/types';\nimport { envelopeConverter } from '../../../packlets/converters';\n\nconst codec: TemporalIdentityCodec = TemporalIdentityCodec.create('facts').orThrow();\n\ndescribe('TemporalIdentityCodec', () => {\n  describe('create', () => {\n    test('rejects a non-portable base scope', () => {\n      expect(TemporalIdentityCodec.create('has/slash')).toFailWith(/baseScope/i);\n    });\n  });\n\n  describe('encode', () => {\n    test('maps an entityId to the entity subtree, versioned', () => {\n      expect(codec.encode('fact-1' as EntityId)).toSucceedWith({\n        scope: 'facts/entities/fact-1' as MemoryScopeKey,\n        idStem: 'fact-1',\n        isVersioned: true\n      });\n    });\n\n    test('rejects a non-portable entityId', () => {\n      expect(codec.encode('bad/id' as EntityId)).toFailWith(/entityId/i);\n    });\n  });\n\n  describe('encodeVersion', () => {\n    test('forms the <entityId>-v<seq> stem', () => {\n      expect(codec.encodeVersion('fact-1' as EntityId, 7)).toSucceedWith('fact-1-v7');\n    });\n\n    test('rejects a negative or non-integer seq', () => {\n      expect(codec.encodeVersion('fact-1' as EntityId, -1)).toFailWith(/non-negative integer/i);\n      expect(codec.encodeVersion('fact-1' as EntityId, 1.5)).toFailWith(/non-negative integer/i);\n    });\n\n    test('rejects a non-portable entityId', () => {\n      expect(codec.encodeVersion('bad/id' as EntityId, 1)).toFailWith(/entityId/i);\n    });\n  });\n\n  describe('decode / decodeVersion', () => {\n    test('recovers the entityId and seq from a (scope, version stem)', () => {\n      expect(codec.decodeVersion('facts/entities/fact-1' as MemoryScopeKey, 'fact-1-v3')).toSucceedWith({\n        entityId: 'fact-1' as EntityId,\n        seq: 3\n      });\n      expect(codec.decode('facts/entities/fact-1' as MemoryScopeKey, 'fact-1-v3')).toSucceedWith(\n        'fact-1' as EntityId\n      );\n    });\n\n    test('disambiguates an entityId that itself ends in -v<digits> via the scope', () => {\n      // The subtree scope is authoritative for the entityId, so a stem whose\n      // entityId is `rev-v2` parses correctly.\n      expect(codec.decodeVersion('facts/entities/rev-v2' as MemoryScopeKey, 'rev-v2-v5')).toSucceedWith({\n        entityId: 'rev-v2' as EntityId,\n        seq: 5\n      });\n    });\n\n    test('rejects a scope that is not <base>/entities/<entityId>', () => {\n      expect(codec.decodeVersion('facts/fact-1' as MemoryScopeKey, 'fact-1-v0')).toFailWith(\n        /must be 'facts\\/entities\\/<entityId>'/i\n      );\n      expect(codec.decodeVersion('other/entities/fact-1' as MemoryScopeKey, 'fact-1-v0')).toFailWith(\n        /must be 'facts\\/entities\\/<entityId>'/i\n      );\n    });\n\n    test('rejects a non-portable entityId embedded in the scope', () => {\n      expect(codec.decodeVersion('facts/entities/ ' as MemoryScopeKey, ' -v0')).toFailWith(/entityId/i);\n    });\n\n    test('rejects a stem that does not carry the entity prefix', () => {\n      expect(codec.decodeVersion('facts/entities/fact-1' as MemoryScopeKey, 'other-v0')).toFailWith(\n        /must begin with 'fact-1-v'/i\n      );\n    });\n\n    test('rejects a stem with a non-integer version suffix', () => {\n      expect(codec.decodeVersion('facts/entities/fact-1' as MemoryScopeKey, 'fact-1-vX')).toFailWith(\n        /non-integer version suffix/i\n      );\n    });\n\n    test('rejects a version suffix outside the safe integer range (corruption/tamper guard)', () => {\n      // A very long digit run passes the regex but overflows Number.MAX_SAFE_INTEGER;\n      // parseInt would silently lose precision, so decode must fail rather than corrupt seq.\n      expect(\n        codec.decodeVersion('facts/entities/fact-1' as MemoryScopeKey, 'fact-1-v99999999999999999999')\n      ).toFailWith(/outside the safe integer range/i);\n    });\n  });\n\n  describe('verifyRoundTrip', () => {\n    test('succeeds for a well-formed (scope, version stem)', () => {\n      expect(codec.verifyRoundTrip('facts/entities/fact-1' as MemoryScopeKey, 'fact-1-v9')).toSucceedWith(\n        true\n      );\n    });\n\n    test('fails when the stem cannot be decoded', () => {\n      expect(codec.verifyRoundTrip('facts/entities/fact-1' as MemoryScopeKey, 'fact-1-vZ')).toFailWith(\n        /non-integer version suffix/i\n      );\n    });\n\n    test('fails on a non-canonical (zero-padded) seq stem', () => {\n      // `-v007` decodes to seq 7 but re-encodes to `-v7`, so it is not canonical.\n      expect(codec.verifyRoundTrip('facts/entities/fact-1' as MemoryScopeKey, 'fact-1-v007')).toFailWith(\n        /round-trip mismatch/i\n      );\n    });\n  });\n});\n\ndescribe('isTemporalIdentityCodec', () => {\n  test('is true for a temporal codec', () => {\n    expect(isTemporalIdentityCodec(codec)).toBe(true);\n  });\n\n  test('is false for a flat codec', () => {\n    const flat: IIdentityCodec = new KnowledgeIdentityCodec();\n    expect(isTemporalIdentityCodec(flat)).toBe(false);\n  });\n});\n\n/** Build a temporal version record for the selection-helper tests. */\n// eslint-disable-next-line @rushstack/no-new-null -- invalid_at null is the meaningful still-valid sentinel\nfunction versionRecord(seq: number, validAt: number, invalidAt?: number | null): IMemoryRecord<unknown> {\n  const temporal: Record<string, unknown> = { valid_at: validAt };\n  if (invalidAt !== undefined) {\n    temporal.invalid_at = invalidAt;\n  }\n  return {\n    envelope: envelopeConverter\n      .convert({\n        id: `fact-1-v${seq}`,\n        entityId: 'fact-1',\n        kind: 'fact',\n        tags: [],\n        links: [],\n        created: validAt,\n        updated: validAt,\n        seq,\n        contentHash: `h${seq}`,\n        provenance: { source: 'agent' },\n        temporal\n      })\n      .orThrow(),\n    body: `body v${seq}`\n  };\n}\n\ndescribe('temporal selection helpers', () => {\n  const v1 = versionRecord(1, 100, 200);\n  const v2 = versionRecord(2, 200);\n  const atemporal: IMemoryRecord<unknown> = {\n    envelope: envelopeConverter\n      .convert({\n        id: 'doc',\n        entityId: 'doc',\n        kind: 'knowledge',\n        tags: [],\n        links: [],\n        created: 0,\n        updated: 0,\n        seq: 0,\n        contentHash: 'h',\n        provenance: { source: 'agent' }\n      })\n      .orThrow(),\n    body: 'flat'\n  };\n\n  test('isTemporalRecord keys off the temporal block', () => {\n    expect(isTemporalRecord(v1)).toBe(true);\n    expect(isTemporalRecord(atemporal)).toBe(false);\n  });\n\n  test('isVersionCurrent is true only for a null/absent invalid_at', () => {\n    expect(isVersionCurrent(v1)).toBe(false);\n    expect(isVersionCurrent(v2)).toBe(true);\n    expect(isVersionCurrent(versionRecord(3, 300, null))).toBe(true);\n    expect(isVersionCurrent(atemporal)).toBe(false);\n  });\n\n  test('isVersionValidAt bounds by valid_at and invalid_at', () => {\n    expect(isVersionValidAt(v1, 50)).toBe(false); // before valid_at\n    expect(isVersionValidAt(v1, 150)).toBe(true); // within [100, 200)\n    expect(isVersionValidAt(v1, 200)).toBe(false); // at invalid_at (exclusive)\n    expect(isVersionValidAt(v2, 500)).toBe(true); // still valid\n    expect(isVersionValidAt(atemporal, 500)).toBe(false);\n  });\n\n  test('isVersionValidAt defaults valid_at to created when absent', () => {\n    const noValidAt: IMemoryRecord<unknown> = {\n      envelope: envelopeConverter\n        .convert({\n          id: 'fact-1-v4',\n          entityId: 'fact-1',\n          kind: 'fact',\n          tags: [],\n          links: [],\n          created: 400,\n          updated: 400,\n          seq: 4,\n          contentHash: 'h4',\n          provenance: { source: 'agent' },\n          temporal: {}\n        })\n        .orThrow(),\n      body: 'v4'\n    };\n    expect(isVersionValidAt(noValidAt, 399)).toBe(false);\n    expect(isVersionValidAt(noValidAt, 400)).toBe(true);\n  });\n\n  test('selectCurrentVersion returns the highest-seq current version', () => {\n    expect(selectCurrentVersion([v1, v2])?.envelope.id).toBe('fact-1-v2');\n    // A fully-invalidated entity has no current version.\n    expect(selectCurrentVersion([v1])).toBeUndefined();\n    expect(selectCurrentVersion([])).toBeUndefined();\n  });\n\n  test('selectCurrentVersion is order-independent (highest seq wins on an unsorted input)', () => {\n    const v3 = versionRecord(3, 300);\n    // Descending input: the first candidate is already the max, so a later\n    // candidate must NOT displace it.\n    expect(selectCurrentVersion([v3, v2])?.envelope.id).toBe('fact-1-v3');\n    expect(selectCurrentVersion([v2, v3])?.envelope.id).toBe('fact-1-v3');\n  });\n\n  test('selectVersionAsOf returns the highest-seq version valid at the instant', () => {\n    expect(selectVersionAsOf([v1, v2], 150)?.envelope.id).toBe('fact-1-v1');\n    expect(selectVersionAsOf([v1, v2], 250)?.envelope.id).toBe('fact-1-v2');\n    expect(selectVersionAsOf([v1, v2], 50)).toBeUndefined();\n  });\n});\n"]}

package/lib/test/unit/types/temporalPolicy.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=temporalPolicy.test.d.ts.map

package/lib/test/unit/types/temporalPolicy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporalPolicy.test.d.ts","sourceRoot":"","sources":["../../../../src/test/unit/types/temporalPolicy.test.ts"],"names":[],"mappings":"AAKA,OAAO,oBAAoB,CAAC"}

package/lib/test/unit/types/temporalPolicy.test.js

@@ -0,0 +1,64 @@
+"use strict";
+/*
+ * Copyright (c) 2026 Erik Fortune
+ * SPDX-License-Identifier: MIT
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+require("@fgv/ts-utils-jest");
+const types_1 = require("../../../packlets/types");
+function makeRecord(overrides, body) {
+    const envelope = Object.assign({ id: 'fact-1-v1', entityId: 'fact-1', kind: 'fact', tags: ['sky'], links: [], created: 1000, updated: 1000, seq: 1, contentHash: 'hash-1', provenance: { source: 'agent' }, temporal: { valid_at: 1000 } }, overrides);
+    return { envelope, body: body !== null && body !== void 0 ? body : 'the sky is blue' };
+}
+describe('TemporalVersionedPolicy', () => {
+    let policy;
+    beforeEach(() => {
+        policy = types_1.TemporalVersionedPolicy.create().orThrow();
+    });
+    test('exposes the temporal mutable surface and entity dedup', () => {
+        expect(policy.mutableFields).toEqual(['body', 'tags', 'links', 'provenance', 'embeddingRef']);
+        expect(policy.dedupScope).toBe('entity');
+    });
+    describe('admit', () => {
+        test("always accepts (invalidate-don't-delete: never culls)", () => {
+            expect(policy.admit(makeRecord(), [])).toSucceedWith({ decision: 'accept' });
+            expect(policy.admit(makeRecord(), [makeRecord(), makeRecord()])).toSucceedWith({
+                decision: 'accept'
+            });
+        });
+    });
+    describe('applyUpdate (forms the new version content)', () => {
+        test('replaces a string body wholesale', () => {
+            const existing = makeRecord(undefined, 'the sky is blue');
+            expect(policy.applyUpdate(existing, { body: 'the sky is grey' })).toSucceedAndSatisfy((updated) => {
+                expect(updated.body).toBe('the sky is grey');
+            });
+        });
+        test('merges tags / provenance and preserves untouched envelope metadata', () => {
+            const existing = makeRecord({ provenance: { source: 'agent', by: 'curator' } });
+            expect(policy.applyUpdate(existing, { tags: ['sky', 'weather'], provenance: { model: 'gpt' } })).toSucceedAndSatisfy((updated) => {
+                expect(updated.envelope.tags).toEqual(['sky', 'weather']);
+                expect(updated.envelope.provenance).toEqual({ source: 'agent', by: 'curator', model: 'gpt' });
+                // Identity/transaction-time fields are carried verbatim (the store restamps them).
+                expect(updated.envelope.entityId).toBe('fact-1');
+            });
+        });
+        test('rejects a patch that deletes a required field', () => {
+            expect(policy.applyUpdate(makeRecord(), { body: null })).toFailWith(/may not delete required field/i);
+        });
+        test('restores embeddingRef as absent when a null patch drops it (hash-stable)', () => {
+            const existing = makeRecord({ embeddingRef: 'vec-1' });
+            expect(policy.applyUpdate(existing, { embeddingRef: null })).toSucceedAndSatisfy((updated) => {
+                expect(updated.envelope.embeddingRef).toBeUndefined();
+            });
+        });
+        test('carries an untouched embeddingRef through a body-only patch', () => {
+            const existing = makeRecord({ embeddingRef: 'vec-1' }, 'the sky is blue');
+            expect(policy.applyUpdate(existing, { body: 'the sky is grey' })).toSucceedAndSatisfy((updated) => {
+                expect(updated.body).toBe('the sky is grey');
+                expect(updated.envelope.embeddingRef).toBe('vec-1');
+            });
+        });
+    });
+});
+//# sourceMappingURL=temporalPolicy.test.js.map

package/lib/test/unit/types/temporalPolicy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporalPolicy.test.js","sourceRoot":"","sources":["../../../../src/test/unit/types/temporalPolicy.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n * SPDX-License-Identifier: MIT\n */\n\nimport '@fgv/ts-utils-jest';\nimport {\n  EntityId,\n  IMemoryEnvelope,\n  IMemoryRecord,\n  IProvenance,\n  Kind,\n  MemoryId,\n  Tag,\n  TemporalVersionedPolicy\n} from '../../../packlets/types';\n\nfunction makeRecord(overrides?: Partial<IMemoryEnvelope>, body?: unknown): IMemoryRecord<unknown> {\n  const envelope: IMemoryEnvelope = {\n    id: 'fact-1-v1' as MemoryId,\n    entityId: 'fact-1' as EntityId,\n    kind: 'fact' as Kind,\n    tags: ['sky'] as Tag[],\n    links: [],\n    created: 1000,\n    updated: 1000,\n    seq: 1,\n    contentHash: 'hash-1',\n    provenance: { source: 'agent' } as IProvenance,\n    temporal: { valid_at: 1000 },\n    ...overrides\n  };\n  return { envelope, body: body ?? 'the sky is blue' };\n}\n\ndescribe('TemporalVersionedPolicy', () => {\n  let policy: TemporalVersionedPolicy;\n\n  beforeEach(() => {\n    policy = TemporalVersionedPolicy.create().orThrow();\n  });\n\n  test('exposes the temporal mutable surface and entity dedup', () => {\n    expect(policy.mutableFields).toEqual(['body', 'tags', 'links', 'provenance', 'embeddingRef']);\n    expect(policy.dedupScope).toBe('entity');\n  });\n\n  describe('admit', () => {\n    test(\"always accepts (invalidate-don't-delete: never culls)\", () => {\n      expect(policy.admit(makeRecord(), [])).toSucceedWith({ decision: 'accept' });\n      expect(policy.admit(makeRecord(), [makeRecord(), makeRecord()])).toSucceedWith({\n        decision: 'accept'\n      });\n    });\n  });\n\n  describe('applyUpdate (forms the new version content)', () => {\n    test('replaces a string body wholesale', () => {\n      const existing = makeRecord(undefined, 'the sky is blue');\n      expect(policy.applyUpdate(existing, { body: 'the sky is grey' })).toSucceedAndSatisfy((updated) => {\n        expect(updated.body).toBe('the sky is grey');\n      });\n    });\n\n    test('merges tags / provenance and preserves untouched envelope metadata', () => {\n      const existing = makeRecord({ provenance: { source: 'agent', by: 'curator' } as IProvenance });\n      expect(\n        policy.applyUpdate(existing, { tags: ['sky', 'weather'], provenance: { model: 'gpt' } })\n      ).toSucceedAndSatisfy((updated) => {\n        expect(updated.envelope.tags).toEqual(['sky', 'weather']);\n        expect(updated.envelope.provenance).toEqual({ source: 'agent', by: 'curator', model: 'gpt' });\n        // Identity/transaction-time fields are carried verbatim (the store restamps them).\n        expect(updated.envelope.entityId).toBe('fact-1');\n      });\n    });\n\n    test('rejects a patch that deletes a required field', () => {\n      expect(policy.applyUpdate(makeRecord(), { body: null })).toFailWith(/may not delete required field/i);\n    });\n\n    test('restores embeddingRef as absent when a null patch drops it (hash-stable)', () => {\n      const existing = makeRecord({ embeddingRef: 'vec-1' });\n      expect(policy.applyUpdate(existing, { embeddingRef: null })).toSucceedAndSatisfy((updated) => {\n        expect(updated.envelope.embeddingRef).toBeUndefined();\n      });\n    });\n\n    test('carries an untouched embeddingRef through a body-only patch', () => {\n      const existing = makeRecord({ embeddingRef: 'vec-1' }, 'the sky is blue');\n      expect(policy.applyUpdate(existing, { body: 'the sky is grey' })).toSucceedAndSatisfy((updated) => {\n        expect(updated.body).toBe('the sky is grey');\n        expect(updated.envelope.embeddingRef).toBe('vec-1');\n      });\n    });\n  });\n});\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-agent-memory",
-  "version": "5.1.0-37",
+  "version": "5.1.0-39",
   "description": "FileTree-backed storage and retrieval substrate for agent memory and knowledge",
   "main": "lib/index.js",
   "types": "dist/ts-agent-memory.d.ts",
@@ -35,10 +35,10 @@
   },
   "dependencies": {
     "tslib": "^2.8.1",
-    "@fgv/ts-json": "5.1.0-37",
-    "@fgv/ts-extras": "5.1.0-37",
-    "@fgv/ts-utils": "5.1.0-37",
-    "@fgv/ts-json-base": "5.1.0-37"
+    "@fgv/ts-extras": "5.1.0-39",
+    "@fgv/ts-json": "5.1.0-39",
+    "@fgv/ts-json-base": "5.1.0-39",
+    "@fgv/ts-utils": "5.1.0-39"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.55.2",
@@ -65,8 +65,8 @@
     "@rushstack/heft-node-rig": "2.11.27",
     "@types/heft-jest": "1.0.6",
     "eslint-plugin-tsdoc": "~0.5.2",
-    "@fgv/heft-dual-rig": "5.1.0-37",
-    "@fgv/ts-utils-jest": "5.1.0-37"
+    "@fgv/heft-dual-rig": "5.1.0-39",
+    "@fgv/ts-utils-jest": "5.1.0-39"
   },
   "scripts": {
     "build": "heft build --clean",

package/rush-logs/ts-agent-memory.build.cache.log

@@ -1,3 +1,3 @@
 Caching build output folders: dist, lib, temp, .rush/temp/operation/build
 Successfully set cache entry.
-Cache key: 6dfc331ddf74dc2db0d4483d0c96ea971f351c83
+Cache key: b82cf6bdece20481260e6bab946179eeec9d7b46

package/rush-logs/ts-agent-memory.build.log

@@ -2,8 +2,8 @@ Invoking: heft build --clean
  ---- build started ---- 
 [build:typescript] The TypeScript compiler version 5.9.3 is newer than the latest version that was tested with Heft (5.8); it may not work correctly.
 [build:typescript] Using TypeScript version 5.9.3
-[build:lint] Using ESLint version 9.39.4
-[build:api-extractor] Using API Extractor version 7.58.7
+[build:lint] Using ESLint version 9.39.5
+[build:api-extractor] Using API Extractor version 7.58.9
 [build:api-extractor] Analysis will use the bundled TypeScript version 5.9.3
- ---- build finished (23.804s) ---- 
--------------------- Finished (23.809s) --------------------
+ ---- build finished (27.335s) ---- 
+-------------------- Finished (27.352s) --------------------

package/src/index.ts

@@ -10,3 +10,5 @@ export * from './packlets/index';
 export * from './packlets/retrieve';
 export * from './packlets/observe';
 export * from './packlets/vector';
+export * from './packlets/tools';
+export * from './packlets/ingest';