@tangle-network/agent-knowledge 1.6.0 → 1.7.0

package/dist/memory/index.d.ts

@@ -0,0 +1,161 @@
+import { S as SourceRecord } from '../types-BEDGlXB-.js';
+import { z } from 'zod';
+
+type AgentMemoryKind = 'message' | 'entity' | 'fact' | 'preference' | 'observation' | 'reasoning-trace';
+interface AgentMemoryScope {
+    tenantId?: string;
+    userId?: string;
+    sessionId?: string;
+    namespace?: string;
+    tags?: Record<string, string>;
+}
+interface AgentMemoryHit {
+    id: string;
+    uri: string;
+    kind: AgentMemoryKind;
+    text: string;
+    title?: string;
+    score?: number;
+    normalizedScore?: number;
+    confidence?: number;
+    createdAt?: string;
+    validUntil?: string;
+    lastVerifiedAt?: string;
+    metadata?: Record<string, unknown>;
+}
+interface AgentMemoryContext {
+    query: string;
+    text: string;
+    hits: AgentMemoryHit[];
+    sourceRecords: SourceRecord[];
+    metadata?: Record<string, unknown>;
+}
+interface AgentMemorySearchOptions {
+    scope?: AgentMemoryScope;
+    limit?: number;
+    minScore?: number;
+    kinds?: AgentMemoryKind[];
+    metadata?: Record<string, unknown>;
+}
+interface AgentMemoryWriteInput {
+    kind: AgentMemoryKind;
+    text: string;
+    id?: string;
+    title?: string;
+    role?: 'system' | 'user' | 'assistant' | 'tool';
+    entityName?: string;
+    entityType?: string;
+    category?: string;
+    predicate?: string;
+    subject?: string;
+    object?: string;
+    confidence?: number;
+    scope?: AgentMemoryScope;
+    metadata?: Record<string, unknown>;
+}
+interface AgentMemoryWriteResult {
+    accepted: boolean;
+    id: string;
+    uri: string;
+    kind: AgentMemoryKind;
+    sourceRecord?: SourceRecord;
+    metadata?: Record<string, unknown>;
+}
+interface AgentMemoryAdapter {
+    readonly id: string;
+    search(query: string, options?: AgentMemorySearchOptions): Promise<AgentMemoryHit[]>;
+    getContext(query: string, options?: AgentMemorySearchOptions): Promise<AgentMemoryContext>;
+    write(input: AgentMemoryWriteInput): Promise<AgentMemoryWriteResult>;
+    flush?(): Promise<void>;
+}
+
+declare function defaultGetMemoryContext(adapter: Pick<AgentMemoryAdapter, 'search'>, query: string, options?: AgentMemorySearchOptions): Promise<AgentMemoryContext>;
+declare function renderMemoryContext(hits: AgentMemoryHit[]): string;
+
+interface Neo4jAgentMemoryAdapterOptions {
+    client: Record<string, unknown>;
+    id?: string;
+}
+declare function createNeo4jAgentMemoryAdapter(options: Neo4jAgentMemoryAdapterOptions): AgentMemoryAdapter;
+
+declare const AgentMemoryKindSchema: z.ZodEnum<{
+    preference: "preference";
+    message: "message";
+    entity: "entity";
+    fact: "fact";
+    observation: "observation";
+    "reasoning-trace": "reasoning-trace";
+}>;
+declare const AgentMemoryScopeSchema: z.ZodObject<{
+    tenantId: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+declare const AgentMemoryHitSchema: z.ZodObject<{
+    id: z.ZodString;
+    uri: z.ZodString;
+    kind: z.ZodEnum<{
+        preference: "preference";
+        message: "message";
+        entity: "entity";
+        fact: "fact";
+        observation: "observation";
+        "reasoning-trace": "reasoning-trace";
+    }>;
+    text: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    score: z.ZodOptional<z.ZodNumber>;
+    normalizedScore: z.ZodOptional<z.ZodNumber>;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    validUntil: z.ZodOptional<z.ZodString>;
+    lastVerifiedAt: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const AgentMemoryWriteInputSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        preference: "preference";
+        message: "message";
+        entity: "entity";
+        fact: "fact";
+        observation: "observation";
+        "reasoning-trace": "reasoning-trace";
+    }>;
+    text: z.ZodString;
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodEnum<{
+        system: "system";
+        user: "user";
+        assistant: "assistant";
+        tool: "tool";
+    }>>;
+    entityName: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    predicate: z.ZodOptional<z.ZodString>;
+    subject: z.ZodOptional<z.ZodString>;
+    object: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    scope: z.ZodOptional<z.ZodObject<{
+        tenantId: z.ZodOptional<z.ZodString>;
+        userId: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        namespace: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+
+declare function memoryHitToSourceRecord(hit: AgentMemoryHit, options?: {
+    now?: () => Date;
+    scope?: AgentMemoryScope;
+}): SourceRecord;
+declare function memoryWriteResultToSourceRecord(result: AgentMemoryWriteResult, text: string, options?: {
+    now?: () => Date;
+    scope?: AgentMemoryScope;
+}): SourceRecord;
+
+export { type AgentMemoryAdapter, type AgentMemoryContext, type AgentMemoryHit, AgentMemoryHitSchema, type AgentMemoryKind, AgentMemoryKindSchema, type AgentMemoryScope, AgentMemoryScopeSchema, type AgentMemorySearchOptions, type AgentMemoryWriteInput, AgentMemoryWriteInputSchema, type AgentMemoryWriteResult, type Neo4jAgentMemoryAdapterOptions, createNeo4jAgentMemoryAdapter, defaultGetMemoryContext, memoryHitToSourceRecord, memoryWriteResultToSourceRecord, renderMemoryContext };

package/dist/memory/index.js

@@ -0,0 +1,24 @@
+import {
+  AgentMemoryHitSchema,
+  AgentMemoryKindSchema,
+  AgentMemoryScopeSchema,
+  AgentMemoryWriteInputSchema,
+  createNeo4jAgentMemoryAdapter,
+  defaultGetMemoryContext,
+  memoryHitToSourceRecord,
+  memoryWriteResultToSourceRecord,
+  renderMemoryContext
+} from "../chunk-U6KQ4FS3.js";
+import "../chunk-YMKHCTS2.js";
+export {
+  AgentMemoryHitSchema,
+  AgentMemoryKindSchema,
+  AgentMemoryScopeSchema,
+  AgentMemoryWriteInputSchema,
+  createNeo4jAgentMemoryAdapter,
+  defaultGetMemoryContext,
+  memoryHitToSourceRecord,
+  memoryWriteResultToSourceRecord,
+  renderMemoryContext
+};
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-knowledge",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Source-grounded, eval-gated knowledge growth primitives for agents.",
   "homepage": "https://github.com/tangle-network/agent-knowledge#readme",
   "repository": {
@@ -29,6 +29,11 @@
       "import": "./dist/cli.js",
       "default": "./dist/cli.js"
     },
+    "./memory": {
+      "types": "./dist/memory/index.d.ts",
+      "import": "./dist/memory/index.js",
+      "default": "./dist/memory/index.js"
+    },
     "./sources": {
       "types": "./dist/sources/index.d.ts",
       "import": "./dist/sources/index.js",
@@ -69,6 +74,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.15",
+    "@neo4j-labs/agent-memory": "0.4.0",
     "@tangle-network/sandbox": "^0.4.0",
     "@types/node": "^25.6.0",
     "tsup": "^8.0.0",