@adonis-agora/agent 0.16.0 → 0.18.0

package/dist/src/rag/vector-store.js

@@ -1,3 +1,76 @@
+/**
+ * A destructive call was refused because its scope could not be trusted. Thrown by
+ * {@link VectorStore.removeWhere} — never for a filter that merely matched nothing (that is a legitimate
+ * result of `0`), only for one that would have deleted *more* than the caller plausibly meant.
+ */
+export class UnsafeRemovalError extends Error {
+    reason;
+    constructor(
+    /** Why the removal was refused. */
+    reason, message) {
+        super(message);
+        this.reason = reason;
+        this.name = 'UnsafeRemovalError';
+    }
+}
+/**
+ * Guard for {@link VectorStore.removeWhere}: refuse a filter that scopes nothing. Shared so all three
+ * stores refuse the same input with the same error, rather than each deciding for itself how much of the
+ * corpus an empty object means.
+ */
+export function assertRemovalFilter(filter) {
+    if (Object.keys(filter).length === 0) {
+        throw new UnsafeRemovalError('empty-filter', 'removeWhere refused an empty filter: it would delete every chunk in the store, which is far ' +
+            'more likely to be a filter built wrong than a deliberate request. For a deliberate wipe, ' +
+            'loop `remove` over `listDocumentIds()`, or drop the table/collection.');
+    }
+}
+/**
+ * Does this filter deny everything? True when any key carries an **empty array** — no value is a member
+ * of the empty set, so nothing can match (see {@link import('./filter.js').matchesFilter}).
+ *
+ * Every filter builder in this package already encodes that (`matchesFilter` returns false,
+ * `buildMetadataWhere` emits a `false` clause, `buildQdrantFilter` emits `any: []`), and the live specs
+ * confirm the backends agree. {@link VectorStore.removeWhere} checks it anyway and short-circuits before
+ * issuing anything: for the one operation where misreading a deny as "no filter" destroys the corpus, the
+ * deny should not depend on a backend's interpretation of an empty set.
+ */
+export function filterDeniesAll(filter) {
+    return Object.values(filter).some((value) => Array.isArray(value) && value.length === 0);
+}
+/**
+ * The keys of a `patch` that will actually be written — every key whose value is not `undefined`. Shared
+ * by all three stores so "an empty patch writes nothing and returns 0" means the same thing on each, and
+ * so none of them issues a round trip for a no-op.
+ */
+export function effectivePatchKeys(patch) {
+    return Object.keys(patch).filter((key) => patch[key] !== undefined);
+}
+/**
+ * Apply a {@link MetadataPatch} to one chunk's metadata, returning the new metadata object. The single
+ * definition of the merge, shared by every store that can do the merge in JS — so the semantics cannot
+ * drift between adapters. Pure: the input object is never mutated.
+ *
+ * Always returns an object (never `undefined`), so a patched chunk has metadata even if it had none
+ * before, and an all-deleting patch leaves `{}` rather than a hole. `{}` and absent metadata are
+ * indistinguishable to {@link import('./filter.js').matchesFilter} and to pgvector's `@>`, so this costs
+ * a caller nothing.
+ */
+export function applyMetadataPatch(metadata, patch) {
+    const next = { ...metadata };
+    for (const key of Object.keys(patch)) {
+        const value = patch[key];
+        if (value === undefined) {
+            continue; // JSON has no `undefined`; treat it as "key not present".
+        }
+        if (value === null) {
+            delete next[key]; // JSON Merge Patch: null REMOVES the key.
+            continue;
+        }
+        next[key] = value; // Replaced wholesale — shallow, so no recursive merge.
+    }
+    return next;
+}
 /** Collapse a chunk id (`${documentId}#<n>`) back to its source document id. */
 export function documentIdOf(chunkId) {
     return chunkId.replace(/#\d+$/, '');

package/dist/src/rag/vector-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"vector-store.js","sourceRoot":"","sources":["../../../src/rag/vector-store.ts"],"names":[],"mappings":"AA4DA,gFAAgF;AAChF,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"vector-store.js","sourceRoot":"","sources":["../../../src/rag/vector-store.ts"],"names":[],"mappings":"AAoIA;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGhC;IAFX;IACE,mCAAmC;IAC1B,MAAsB,EAC/B,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,WAAM,GAAN,MAAM,CAAgB;QAI/B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA+B;IACjE,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,kBAAkB,CAC1B,cAAc,EACd,8FAA8F;YAC5F,2FAA2F;YAC3F,uEAAuE,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,MAA+B;IAC7D,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;AAC3F,CAAC;AAuBD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAoB;IACrD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAA6C,EAC7C,KAAoB;IAEpB,MAAM,IAAI,GAA4B,EAAE,GAAG,QAAQ,EAAE,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS,CAAC,0DAA0D;QACtE,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,0CAA0C;YAC5D,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,uDAAuD;IAC5E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAQD,gFAAgF;AAChF,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/agent",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "Governed, durable-backed AI agent (chat + tool-calling + governance) for AdonisJS — part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {
@@ -99,10 +99,10 @@
     "@standard-schema/spec": "^1.0.0"
   },
   "peerDependencies": {
-    "@adonis-agora/authz": "^0.4.0",
-    "@adonis-agora/diagnostics": "^0.1.0",
-    "@adonis-agora/durable": "^0.8.0",
-    "@adonis-agora/telescope": "^0.4.0",
+    "@adonis-agora/authz": ">=0.4.2 <1.0.0",
+    "@adonis-agora/diagnostics": ">=0.1.0 <1.0.0",
+    "@adonis-agora/durable": ">=0.8.0 <1.0.0",
+    "@adonis-agora/telescope": ">=0.4.0 <1.0.0",
     "@adonisjs/assembler": "^8.4.0",
     "@adonisjs/core": "^7.3.0",
     "@adonisjs/lucid": "^22.4.0",
@@ -155,7 +155,10 @@
     }
   },
   "devDependencies": {
-    "@adonis-agora/durable": "^0.8.0",
+    "@adonis-agora/authz": "^0.10.1",
+    "@adonis-agora/diagnostics": "^0.2.5",
+    "@adonis-agora/durable": "^0.20.0",
+    "@adonis-agora/telescope": "^0.6.0",
     "@adonisjs/assembler": "^8.4.0",
     "@adonisjs/core": "^7.3.0",
     "@adonisjs/lucid": "^22.4.0",
@@ -172,7 +175,7 @@
     "zod": "^3.25.0"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=22.0.0 <23"
   },
   "keywords": [
     "adonisjs",
@@ -187,10 +190,12 @@
     "agora"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json && pnpm run copy:stubs",
+    "build": "pnpm run clean && tsc -p tsconfig.build.json && pnpm run copy:stubs && pnpm run check:dist",
+    "check:dist": "node ../../scripts/assert-build-output.mjs dist src/index.js",
+    "clean": "rm -rf dist",
     "copy:stubs": "mkdir -p dist/stubs/config dist/stubs/database/migrations && cp stubs/config/agent.stub dist/stubs/config/agent.stub && cp -r stubs/database/migrations/. dist/stubs/database/migrations/",
     "test": "vitest run --passWithNoTests",
     "test:watch": "vitest",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.tests.json"
   }
 }