@fgv/ts-agent-memory-sqlite-vec 5.1.0-42

package/temp/ts-agent-memory-sqlite-vec.api.json

@@ -0,0 +1,1167 @@
+{
+  "metadata": {
+    "toolPackage": "@microsoft/api-extractor",
+    "toolVersion": "7.58.9",
+    "schemaVersion": 1011,
+    "oldestForwardsCompatibleVersion": 1001,
+    "tsdocConfig": {
+      "$schema": "https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json",
+      "noStandardTags": true,
+      "tagDefinitions": [
+        {
+          "tagName": "@alpha",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@beta",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@defaultValue",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@decorator",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@deprecated",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@eventProperty",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@example",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@experimental",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@inheritDoc",
+          "syntaxKind": "inline"
+        },
+        {
+          "tagName": "@internal",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@label",
+          "syntaxKind": "inline"
+        },
+        {
+          "tagName": "@link",
+          "syntaxKind": "inline",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@override",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@packageDocumentation",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@param",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@privateRemarks",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@public",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@readonly",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@remarks",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@returns",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@sealed",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@see",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@throws",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@typeParam",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@virtual",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@jsx",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxRuntime",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxFrag",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxImportSource",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@betaDocumentation",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@internalRemarks",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@preapproved",
+          "syntaxKind": "modifier"
+        }
+      ],
+      "supportForTags": {
+        "@alpha": true,
+        "@beta": true,
+        "@defaultValue": true,
+        "@decorator": true,
+        "@deprecated": true,
+        "@eventProperty": true,
+        "@example": true,
+        "@experimental": true,
+        "@inheritDoc": true,
+        "@internal": true,
+        "@label": true,
+        "@link": true,
+        "@override": true,
+        "@packageDocumentation": true,
+        "@param": true,
+        "@privateRemarks": true,
+        "@public": true,
+        "@readonly": true,
+        "@remarks": true,
+        "@returns": true,
+        "@sealed": true,
+        "@see": true,
+        "@throws": true,
+        "@typeParam": true,
+        "@virtual": true,
+        "@betaDocumentation": true,
+        "@internalRemarks": true,
+        "@preapproved": true
+      },
+      "reportUnsupportedHtmlElements": false
+    }
+  },
+  "kind": "Package",
+  "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!",
+  "docComment": "",
+  "name": "@fgv/ts-agent-memory-sqlite-vec",
+  "preserveMemberOrder": false,
+  "members": [
+    {
+      "kind": "EntryPoint",
+      "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!",
+      "name": "",
+      "preserveMemberOrder": false,
+      "members": [
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!ISqliteVecFragmentIndexCreateParams:interface",
+          "docComment": "/**\n * Parameters for {@link SqliteVecFragmentIndex.create}.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface ISqliteVecFragmentIndexCreateParams "
+            }
+          ],
+          "fileUrlPath": "src/packlets/sqlite-vec-index/model.ts",
+          "releaseTag": "Public",
+          "name": "ISqliteVecFragmentIndexCreateParams",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!ISqliteVecFragmentIndexCreateParams#database:member",
+              "docComment": "/**\n * A `better-sqlite3` `Database` the consumer owns (bring-your-own, mirroring {@link ISqliteVecVectorIndexCreateParams.database}). The consumer opens it and owns its lifecycle — this index never closes it. `create` loads the `sqlite-vec` extension onto the connection and, if the fragment table already exists (a reopened persistent file), recovers its established dimension so no re-embedding is required on open.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly database: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "BetterSqlite3.Database",
+                  "canonicalReference": "@types/better-sqlite3!Database.Database:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "database",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!ISqliteVecFragmentIndexCreateParams#tableName:member",
+              "docComment": "/**\n * Name of the `vec0` virtual table that holds the fragment embeddings. Must be a simple SQL identifier (`[A-Za-z_][A-Za-z0-9_]*`). Defaults to `'memory_fragments'`. Supply a distinct name (distinct from any record-level {@link SqliteVecVectorIndex} table) to hold more than one independent index in a single database file.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly tableName?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "tableName",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!ISqliteVecVectorIndexCreateParams:interface",
+          "docComment": "/**\n * Parameters for {@link SqliteVecVectorIndex.create}.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface ISqliteVecVectorIndexCreateParams "
+            }
+          ],
+          "fileUrlPath": "src/packlets/sqlite-vec-index/model.ts",
+          "releaseTag": "Public",
+          "name": "ISqliteVecVectorIndexCreateParams",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!ISqliteVecVectorIndexCreateParams#database:member",
+              "docComment": "/**\n * A `better-sqlite3` `Database` the consumer owns (bring-your-own, mirroring the boundary-package convention). The consumer opens it (`new Database(path)` for a persistent file, or `new Database(':memory:')` for an ephemeral index) and owns its lifecycle — this index never closes it. `create` loads the `sqlite-vec` extension onto the connection and, if the vector table already exists (a reopened persistent file), recovers its established dimension so no re-embedding is required on open.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly database: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "BetterSqlite3.Database",
+                  "canonicalReference": "@types/better-sqlite3!Database.Database:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "database",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!ISqliteVecVectorIndexCreateParams#tableName:member",
+              "docComment": "/**\n * Name of the `vec0` virtual table that holds the embeddings. Must be a simple SQL identifier (`[A-Za-z_][A-Za-z0-9_]*`). Defaults to `'memory_vectors'`. Supply a distinct name to hold more than one independent index in a single database file.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly tableName?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "tableName",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Class",
+          "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecFragmentIndex:class",
+          "docComment": "/**\n * A persistent, `sqlite-vec`-backed `IFragmentVectorIndex` (from `@fgv/ts-agent-memory`) — the fragment-granular sibling of {@link SqliteVecVectorIndex}, and the **durable** counterpart to the in-memory `InMemoryFragmentCosineIndex`.\n *\n * @remarks\n *\n * Where {@link SqliteVecVectorIndex} keys one vector per record on a `target_key` primary key, this index holds **many** vectors per record — one per in-record `[start, end)` span — so it keys the `vec0` table on `target_key` as a **`PARTITION KEY`** (many rows may share it) and stores each fragment's locator offsets in two auxiliary columns (`+start_off`, `+end_off`) that ride alongside the vector and are returned on query but never filtered. A query is a brute-force `vec0` KNN scan across all partitions returning per-fragment hits, each carrying its record `target` and the matched `locator`.\n *\n * Semantics match `InMemoryFragmentCosineIndex` exactly: `addFragments` is whole-record-replace (a single transaction deletes every prior fragment of the target, then inserts the new set), `remove` drops every fragment of a target, and `query` applies the optional `maxPerRecord` cap **during selection, before the topK cut** — so one long document cannot crowd others out. The dimension is established by the first `addFragments` (the `vec0` column is fixed-width) and recovered from the table schema when a persistent file is reopened; similarity is cosine (`score = 1 - cosineDistance`), byte-identical to the in-memory index. Large-N ANN indexing is explicitly out of scope, same regime as the record index.\n *\n * The `better-sqlite3` `Database` is consumer-owned (bring-your-own): this index loads the `sqlite-vec` extension onto it and reads/writes the table, but never opens or closes the connection.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare class SqliteVecFragmentIndex implements "
+            },
+            {
+              "kind": "Reference",
+              "text": "IFragmentVectorIndex",
+              "canonicalReference": "@fgv/ts-agent-memory!IFragmentVectorIndex:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " "
+            }
+          ],
+          "fileUrlPath": "src/packlets/sqlite-vec-index/sqliteVecFragmentIndex.ts",
+          "releaseTag": "Public",
+          "isAbstract": false,
+          "name": "SqliteVecFragmentIndex",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecFragmentIndex#addFragments:member(1)",
+              "docComment": "/**\n * {@inheritDoc IFragmentVectorIndex.addFragments}\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "addFragments(target: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IEdgeTarget",
+                  "canonicalReference": "@fgv/ts-agent-memory!IEdgeTarget:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", fragments: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ReadonlyArray",
+                  "canonicalReference": "!ReadonlyArray:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IEmbeddedFragment",
+                  "canonicalReference": "@fgv/ts-agent-memory!IEmbeddedFragment:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<number>>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 8,
+                "endIndex": 12
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "target",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "fragments",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 7
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "addFragments"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecFragmentIndex.create:member(1)",
+              "docComment": "/**\n * Family-convention factory. Loads the `sqlite-vec` extension onto the supplied `better-sqlite3` connection and, if the fragment table already exists (a reopened persistent file), recovers its established dimension so no re-embedding is needed on open.\n *\n * @param params - See {@link ISqliteVecFragmentIndexCreateParams}.\n *\n * @returns `Success` with the index, or `Failure` if the table name is not a simple identifier or the extension fails to load.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "static create(params: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ISqliteVecFragmentIndexCreateParams",
+                  "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!ISqliteVecFragmentIndexCreateParams:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "SqliteVecFragmentIndex",
+                  "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecFragmentIndex:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": true,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 9
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "params",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "create"
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecFragmentIndex#fragmentCount:member",
+              "docComment": "/**\n * The total number of fragments currently held across all records. Zero before the first add.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get fragmentCount(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "fragmentCount",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecFragmentIndex#query:member(1)",
+              "docComment": "/**\n * {@inheritDoc IFragmentVectorIndex.query}\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "query(vector: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Float32Array",
+                  "canonicalReference": "!Float32Array:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", topK: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", maxPerRecord?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ReadonlyArray",
+                  "canonicalReference": "!ReadonlyArray:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IVectorQueryHit",
+                  "canonicalReference": "@fgv/ts-agent-memory!IVectorQueryHit:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">>>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 7,
+                "endIndex": 15
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "vector",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "topK",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "maxPerRecord",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "query"
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecFragmentIndex#recordCount:member",
+              "docComment": "/**\n * The number of records that currently have at least one stored fragment. Zero before the first add.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get recordCount(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "recordCount",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecFragmentIndex#remove:member(1)",
+              "docComment": "/**\n * {@inheritDoc IFragmentVectorIndex.remove}\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "remove(target: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IEdgeTarget",
+                  "canonicalReference": "@fgv/ts-agent-memory!IEdgeTarget:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IEdgeTarget",
+                  "canonicalReference": "@fgv/ts-agent-memory!IEdgeTarget:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 9
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "target",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "remove"
+            }
+          ],
+          "implementsTokenRanges": [
+            {
+              "startIndex": 1,
+              "endIndex": 2
+            }
+          ]
+        },
+        {
+          "kind": "Class",
+          "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecVectorIndex:class",
+          "docComment": "/**\n * A persistent, `sqlite-vec`-backed `IVectorIndex` for `@fgv/ts-agent-memory`.\n *\n * @remarks\n *\n * This is the **durable** counterpart to the in-memory `InMemoryCosineIndex`: embeddings live in a `sqlite-vec` `vec0` virtual table inside a `better-sqlite3` database, so they survive a process restart. A consumer that wires this index into `FileTreeMemoryStore` (instead of the in-memory index) opens an existing vault **without re-embedding it** — the vectors are already on disk. New writes still flow through the store's incremental embed-on-write path; there is no core store change.\n *\n * The index is keyed by the canonical `edgeTargetKey` of each record's scope-qualified `(scope, id)` address (a `TEXT PRIMARY KEY` on the `vec0` table), so two records that share a filename stem across scopes never collide. The dimension is established by the first `add` (the `vec0` column is fixed-width) and recovered from the table schema when a persistent file is reopened; every later `add`/`query` must match it or fail loudly, exactly as the in-memory index does. Similarity is cosine (`distance_metric=cosine`): the returned `score` is `1 - cosineDistance`, i.e. cosine similarity in `[-1, 1]`, higher = more similar — byte-for-byte the same scoring contract as `InMemoryCosineIndex`.\n *\n * Query is a brute-force `vec0` KNN scan (not an ANN structure): correct and durable, appropriate for the same \"thousands of records\" regime the in-memory index targets. Large-N ANN indexing is explicitly out of scope — see the README.\n *\n * The `better-sqlite3` `Database` is consumer-owned (bring-your-own): this index loads the `sqlite-vec` extension onto it and reads/writes the table, but never opens or closes the connection.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare class SqliteVecVectorIndex implements "
+            },
+            {
+              "kind": "Reference",
+              "text": "IVectorIndex",
+              "canonicalReference": "@fgv/ts-agent-memory!IVectorIndex:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " "
+            }
+          ],
+          "fileUrlPath": "src/packlets/sqlite-vec-index/sqliteVecVectorIndex.ts",
+          "releaseTag": "Public",
+          "isAbstract": false,
+          "name": "SqliteVecVectorIndex",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecVectorIndex#add:member(1)",
+              "docComment": "/**\n * {@inheritDoc IVectorIndex.add}\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "add(target: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IEdgeTarget",
+                  "canonicalReference": "@fgv/ts-agent-memory!IEdgeTarget:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", vector: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Float32Array",
+                  "canonicalReference": "!Float32Array:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string>>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 9
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "target",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "vector",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "add"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecVectorIndex.create:member(1)",
+              "docComment": "/**\n * Family-convention factory. Loads the `sqlite-vec` extension onto the supplied `better-sqlite3` connection and, if the vector table already exists (a reopened persistent file), recovers its established dimension so no re-embedding is needed on open.\n *\n * @param params - See {@link ISqliteVecVectorIndexCreateParams}.\n *\n * @returns `Success` with the index, or `Failure` if the table name is not a simple identifier or the extension fails to load.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "static create(params: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ISqliteVecVectorIndexCreateParams",
+                  "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!ISqliteVecVectorIndexCreateParams:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "SqliteVecVectorIndex",
+                  "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecVectorIndex:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": true,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 9
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "params",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "create"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecVectorIndex#query:member(1)",
+              "docComment": "/**\n * {@inheritDoc IVectorIndex.query}\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "query(vector: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Float32Array",
+                  "canonicalReference": "!Float32Array:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", topK: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ReadonlyArray",
+                  "canonicalReference": "!ReadonlyArray:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IVectorQueryHit",
+                  "canonicalReference": "@fgv/ts-agent-memory!IVectorQueryHit:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">>>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 13
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "vector",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "topK",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "query"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecVectorIndex#remove:member(1)",
+              "docComment": "/**\n * {@inheritDoc IVectorIndex.remove}\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "remove(target: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IEdgeTarget",
+                  "canonicalReference": "@fgv/ts-agent-memory!IEdgeTarget:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IEdgeTarget",
+                  "canonicalReference": "@fgv/ts-agent-memory!IEdgeTarget:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 9
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "target",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "remove"
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@fgv/ts-agent-memory-sqlite-vec!SqliteVecVectorIndex#size:member",
+              "docComment": "/**\n * The number of vectors currently held. Zero before the first `add`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get size(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "size",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            }
+          ],
+          "implementsTokenRanges": [
+            {
+              "startIndex": 1,
+              "endIndex": 2
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}