@fgv/ts-agent-memory-sqlite-vec 5.1.0-46 → 5.1.0-48

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

@@ -1,1167 +0,0 @@
-{
-  "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 fragment — so it keys the `vec0` table on `target_key` as a **`PARTITION KEY`** (many rows may share it) and stores each fragment's identity in three auxiliary columns (`+start_off`, `+end_off`, `+fragment_id`) that ride alongside the vector and are returned on query but never filtered — in particular `fragment_id` is stored and returned verbatim, never parsed and never part of the query path. A query is a brute-force `vec0` KNN scan across all partitions returning per-fragment hits, each carrying its record `target` plus whichever identity fields the stored fragment was added with (a fragment must carry at least one).\n *\n * **`vec0` schema changes require a drop-and-re-index.** A `CREATE VIRTUAL TABLE IF NOT EXISTS` is a no-op against an existing table (SQLite does not compare schemas) and `vec0` has no `ALTER TABLE ADD COLUMN`, so a database written by an earlier version of this package keeps its old auxiliary columns. `create` detects that by parsing the stored `CREATE VIRTUAL TABLE` SQL and fails with an actionable message naming the expected and found columns, rather than letting a widened `INSERT` surface an opaque `no such column` at statement-prepare time. There are no in-place migrations: drop the table (or use a fresh `tableName`) and re-index. Fragment vectors are re-derivable from the records, so this costs embedding time, never data.\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), verifies its auxiliary-column set matches this version's and 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, the extension fails to load, or the existing table was written by a version with a different auxiliary-column set (which requires a drop-and-re-index — `vec0` cannot be altered in place).\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
-            }
-          ]
-        }
-      ]
-    }
-  ]
-}