@areev/areev 1.2.2 → 1.3.1

package/README.md

@@ -11,14 +11,14 @@ memory is one file, opened with a namespace, giving JavaScript agents durable
 add / recall / supersede / forget over content-addressed memory.
 
 ```js
-const { Areev } = require('areev')
+const { Areev } = require('@areev/areev')
 
 const mem = new Areev('caller.db', 'caller') // 3rd arg: passphrase for AES-256 at rest
 const h = await mem.addFact('john', 'prefers', 'tea', 0.95)
 console.log(await mem.recall('john')) // JSON string, newest-first
 
 await mem.setEmbedderCommand('python3 embed.py')   // vector recall via a host command
-await mem.migrate('mem0', exportJson, historyJson) // import from mem0/Zep/Letta/… (docs/migrate.md)
+await mem.migrate('mem0', exportJson, historyJson) // import an existing corpus (docs/migrate.md)
 await mem.memoryTool('{"command": "view", "path": "/memories"}') // Anthropic memory-tool backend
 ```
 

package/index.d.ts

@@ -1,7 +1,7 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
 export declare class Areev {
-  constructor(path: string, ns?: string | undefined | null, passphrase?: string | undefined | null, actor?: string | undefined | null, telemetry?: string | undefined | null, principal?: string | undefined | null, indexText?: boolean | undefined | null)
+  constructor(path: string, ns?: string | undefined | null, passphrase?: string | undefined | null, actor?: string | undefined | null, telemetry?: string | undefined | null, principal?: string | undefined | null, indexText?: boolean | undefined | null, anonKey?: string | undefined | null)
   /**
    * Release this handle's claim on the memory file.
    *
@@ -169,6 +169,21 @@ export declare class Areev {
    * (absent when the query raised none).
    */
   cal(query: string): Promise<string>
+  /**
+   * Parse and validate a statement now, and keep the plan, so the first
+   * real turn does not pay for it.
+   *
+   * The handle is the statement TEXT — there is no opaque handle object to
+   * leak or invalidate, because the executor already keys its plan cache on
+   * exactly that. Call this at startup for each statement your agent runs
+   * on the hot path: it turns a bad statement into a startup error instead
+   * of a first-turn error, and guarantees the plan is warm rather than
+   * hoping it is.
+   *
+   * Returns `{statement, cached}` where `cached` is the number of plans
+   * held.
+   */
+  calPrepare(query: string): Promise<string>
   /** Supersession-chain history for (subject, relation), newest first. */
   history(subject: string, relation: string, ns?: string | undefined | null): Promise<string>
   /**
@@ -273,6 +288,18 @@ export declare class Areev {
    * mutating it — retries show up as several records for one node.
    */
   stepActions(workflow: string, node?: string | undefined | null, limit?: number | undefined | null, ns?: string | undefined | null): Promise<string>
+  /**
+   * Last `n` grains of one conversation, oldest→newest (transcript order).
+   *
+   * The read a chat or voice agent makes on every single turn. Backed by
+   * `idx_thread(ns, session, seq)`, so the bound is n turns of THIS session
+   * rather than n rows of the namespace — unlike a namespace scan filtered
+   * afterwards, which can miss the conversation entirely on a busy
+   * namespace. Exact namespace only: a session lives in one by construction.
+   *
+   * Returns `{ns, session, grains: [{hash, type, fields}]}`.
+   */
+  threadTail(session: string, n?: number | undefined | null, ns?: string | undefined | null): Promise<string>
   /**
    * Record a tool call as a Tool grain — the flagship analyzer's food.
    *
@@ -407,9 +434,15 @@ export declare class Areev {
    * Start a governed run. Returns the session JSON:
    * `{"finished": …}` or `{"parked": envelope}`.
    */
-  runStart(workflow: string, runId: string, inputJson?: string | undefined | null, toolCmd?: string | undefined | null, maxTokens?: number | undefined | null, maxUsdMicros?: number | undefined | null, maxWallMs?: number | undefined | null, askTtlSec?: number | undefined | null): Promise<string>
-  /** Resume a parked/interrupted run from its latest checkpoint. */
-  runResume(runId: string, toolCmd?: string | undefined | null): Promise<string>
+  runStart(workflow: string, runId: string, inputJson?: string | undefined | null, toolCmd?: string | undefined | null, maxTokens?: number | undefined | null, maxUsdMicros?: number | undefined | null, maxWallMs?: number | undefined | null, askTtlSec?: number | undefined | null, model?: string | undefined | null, baseUrl?: string | undefined | null, keyEnv?: string | undefined | null, llmMaxTokens?: number | undefined | null): Promise<string>
+  /**
+   * Resume a parked/interrupted run from its latest checkpoint.
+   *
+   * Takes `model` for the same reason `runStart` does: resuming a plan with
+   * abstract nodes still has to execute them, and the backend is host config
+   * that is deliberately not journaled with the run.
+   */
+  runResume(runId: string, toolCmd?: string | undefined | null, model?: string | undefined | null, baseUrl?: string | undefined | null, keyEnv?: string | undefined | null, llmMaxTokens?: number | undefined | null): Promise<string>
   /**
    * Answer a pending Client ask. `responder` is REQUIRED — approval
    * separation of duties (responder ≠ triggering principal) is structural.
@@ -436,12 +469,106 @@ export declare class Areev {
   changesSince(afterOpSeq?: number | undefined | null, limit?: number | undefined | null): Promise<string>
   /** Recent run ids, newest first. JSON list string. */
   runList(limit?: number | undefined | null): Promise<string>
+  /**
+   * One run's full picture — manifest, budgets, phase, spend, pending
+   * asks, fork lineage. JSON report; same shape as `areev run inspect`.
+   */
+  runInspect(runId: string): Promise<string>
+  /**
+   * The EU AI Act Article 14 report — measured from the journal, not
+   * asserted. `runId` takes precedence; `plan` (a hex hash) resolves to
+   * that plan's newest run; neither given reports on the newest run
+   * overall. JSON report; same shape as `areev run oversight-report`.
+   */
+  runOversightReport(runId?: string | undefined | null, plan?: string | undefined | null): Promise<string>
+  /**
+   * Declare a trigger. `fieldsJson` is the same object `add("trigger", …)`
+   * takes (`kind`, `workflow`, and the kind's own requirements); `because`
+   * records why the rule exists, which is what makes it auditable.
+   *
+   * Prefer this over `add("trigger", …)`: both refuse an incoherent
+   * declaration, but only this path also parses the cron expression,
+   * refuses a non-UTC timezone (`TRG-E006`) and checks a composite's gate
+   * against its own members. A trigger that can never fire has exactly one
+   * symptom — nothing happening — so it is worth refusing at authoring
+   * time. Resolves to the content address.
+   */
+  triggerAdd(fieldsJson: string, because: string, ns?: string | undefined | null): Promise<string>
+  /** Every trigger declaration in this namespace, newest first. JSON list. */
+  triggerList(): Promise<string>
+  /**
+   * Runtime state for every trigger: due, paused, leased, exhausted, the
+   * last firing and the last error. JSON list, parity with
+   * `areev trigger status`.
+   *
+   * **Answers for THIS host.** Evaluation state lives in `trg:<hash>` meta
+   * rows that deliberately do not replicate, so a memory restored from
+   * production cannot inherit production's cursor and silently skip real
+   * work. A dashboard rendering this is reporting its own machine's
+   * scheduling health, not the fleet's.
+   *
+   * A row carrying `unusable` can never fire as written — a cron that does
+   * not parse, a timezone this build refuses, a composite gate naming a
+   * member the declaration does not carry. Reported rather than left to
+   * look like a healthy trigger waiting its turn.
+   */
+  triggerStatus(): Promise<string>
+  /** One trigger's state, by content address or a unique prefix of one. */
+  triggerShow(trigger: string): Promise<string>
+  /**
+   * Evaluate every due trigger once and resolve to the report.
+   *
+   * The whole command in one call: claim, poll, dedup, start. `dryRun`
+   * reports what would happen and touches nothing — the safe first call on
+   * a new deployment. `connectorCmd` executes polling connectors (without
+   * one a due polling trigger fails loudly with `TRG-E003` rather than
+   * looking healthy while doing nothing), and `toolCmd` is what lets a
+   * firing actually start its workflow — without it the pass ingests items
+   * and records firings but starts nothing, which is a useful mode rather
+   * than a broken one.
+   *
+   * `credentialsJson` maps a credential name to the **environment
+   * variable** its value is read from (`{"gmail": "GMAIL_TOKEN"}`), never
+   * to the value itself: the connector is handed the broker's address and
+   * never the secret. An unset variable is refused here rather than leaving
+   * the connector to make an unauthenticated call.
+   */
+  triggerRun(only?: string | undefined | null, dryRun?: boolean | undefined | null, leaseSecs?: number | undefined | null, maxItems?: number | undefined | null, connectorCmd?: string | undefined | null, toolCmd?: string | undefined | null, credentialsJson?: string | undefined | null, node?: string | undefined | null, model?: string | undefined | null, baseUrl?: string | undefined | null, keyEnv?: string | undefined | null): Promise<string>
+  /**
+   * Hand a webhook or manual payload to a trigger. Areev never opens a
+   * port: the host owns the listener and hands the payload over.
+   */
+  triggerDeliver(trigger: string, payloadJson: string, connectorCmd?: string | undefined | null, toolCmd?: string | undefined | null, credentialsJson?: string | undefined | null, model?: string | undefined | null, baseUrl?: string | undefined | null, keyEnv?: string | undefined | null): Promise<string>
+  /** Stop a trigger firing without deleting it. Mandatory reason. */
+  triggerPause(trigger: string, because: string): Promise<string>
+  /** Let a paused trigger fire again. Mandatory reason. */
+  triggerResume(trigger: string, because: string): Promise<string>
+  /**
+   * Render heartbeat config for infrastructure you already run
+   * (`cron`, `launchd`, `systemd`, `k8s-cronjob`) and create nothing.
+   *
+   * The rendered interval is the GCD of the declared intervals floored at
+   * 60s, not the shortest one — the memory owns the real cadence, so this
+   * is deliberately coarser. Resolves to
+   * `{"target", "heartbeatSecs", "config"}`; `config` is the text to
+   * install.
+   */
+  triggerRender(target: string, db: string, exe?: string | undefined | null, extraArgs?: string | undefined | null): Promise<string>
 }
 
+export declare function dropPostgresSchema(url: string, schema: string): void
+
 /**
  * Drop a memory schema entirely — the postgres backend's memory-level
  * erasure primitive (`DROP SCHEMA … CASCADE`), the analogue of deleting a
  * memory file. Destroys the memory AND its telemetry/blobs. Admin surface:
  * gate it like any destructive operation in your host.
+ * Read one CAS blob from a memory's `.blobs` sidecar without opening the
+ * database.
+ *
+ * The embedded backend's lock is exclusive, so a `--tool-cmd` subprocess
+ * cannot open the memory its own run is holding. No lock is needed: a blob is
+ * immutable and its address is its checksum, re-verified here. `null` means
+ * the blob is sealed — open the memory with its passphrase for that.
  */
-export declare function dropPostgresSchema(url: string, schema: string): void
+export declare function readBlobOffline(dbPath: string, uri: string): Buffer | null

package/index.js

@@ -75,10 +75,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-android-arm64')
-        const bindingPackageVersion = require('areev-android-arm64/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-android-arm64')
+        const bindingPackageVersion = require('@areev/areev-android-arm64/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -91,10 +91,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-android-arm-eabi')
-        const bindingPackageVersion = require('areev-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-android-arm-eabi')
+        const bindingPackageVersion = require('@areev/areev-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -112,10 +112,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-win32-x64-gnu')
-        const bindingPackageVersion = require('areev-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-win32-x64-gnu')
+        const bindingPackageVersion = require('@areev/areev-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -128,10 +128,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-win32-x64-msvc')
-        const bindingPackageVersion = require('areev-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-win32-x64-msvc')
+        const bindingPackageVersion = require('@areev/areev-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -145,10 +145,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-win32-ia32-msvc')
-        const bindingPackageVersion = require('areev-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-win32-ia32-msvc')
+        const bindingPackageVersion = require('@areev/areev-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -161,10 +161,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-win32-arm64-msvc')
-        const bindingPackageVersion = require('areev-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-win32-arm64-msvc')
+        const bindingPackageVersion = require('@areev/areev-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -180,10 +180,10 @@ function requireNative() {
       loadErrors.push(e)
     }
     try {
-      const binding = require('areev-darwin-universal')
-      const bindingPackageVersion = require('areev-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      const binding = require('@areev/areev-darwin-universal')
+      const bindingPackageVersion = require('@areev/areev-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -196,10 +196,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-darwin-x64')
-        const bindingPackageVersion = require('areev-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-darwin-x64')
+        const bindingPackageVersion = require('@areev/areev-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -212,10 +212,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-darwin-arm64')
-        const bindingPackageVersion = require('areev-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-darwin-arm64')
+        const bindingPackageVersion = require('@areev/areev-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -232,10 +232,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-freebsd-x64')
-        const bindingPackageVersion = require('areev-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-freebsd-x64')
+        const bindingPackageVersion = require('@areev/areev-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -248,10 +248,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-freebsd-arm64')
-        const bindingPackageVersion = require('areev-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-freebsd-arm64')
+        const bindingPackageVersion = require('@areev/areev-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -269,10 +269,10 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          const binding = require('areev-linux-x64-musl')
-          const bindingPackageVersion = require('areev-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          const binding = require('@areev/areev-linux-x64-musl')
+          const bindingPackageVersion = require('@areev/areev-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -285,10 +285,10 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          const binding = require('areev-linux-x64-gnu')
-          const bindingPackageVersion = require('areev-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          const binding = require('@areev/areev-linux-x64-gnu')
+          const bindingPackageVersion = require('@areev/areev-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -303,10 +303,10 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          const binding = require('areev-linux-arm64-musl')
-          const bindingPackageVersion = require('areev-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          const binding = require('@areev/areev-linux-arm64-musl')
+          const bindingPackageVersion = require('@areev/areev-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -319,10 +319,10 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          const binding = require('areev-linux-arm64-gnu')
-          const bindingPackageVersion = require('areev-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          const binding = require('@areev/areev-linux-arm64-gnu')
+          const bindingPackageVersion = require('@areev/areev-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -337,10 +337,10 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          const binding = require('areev-linux-arm-musleabihf')
-          const bindingPackageVersion = require('areev-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          const binding = require('@areev/areev-linux-arm-musleabihf')
+          const bindingPackageVersion = require('@areev/areev-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -353,10 +353,10 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          const binding = require('areev-linux-arm-gnueabihf')
-          const bindingPackageVersion = require('areev-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          const binding = require('@areev/areev-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('@areev/areev-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -371,10 +371,10 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          const binding = require('areev-linux-loong64-musl')
-          const bindingPackageVersion = require('areev-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          const binding = require('@areev/areev-linux-loong64-musl')
+          const bindingPackageVersion = require('@areev/areev-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -387,10 +387,10 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          const binding = require('areev-linux-loong64-gnu')
-          const bindingPackageVersion = require('areev-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          const binding = require('@areev/areev-linux-loong64-gnu')
+          const bindingPackageVersion = require('@areev/areev-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -405,10 +405,10 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          const binding = require('areev-linux-riscv64-musl')
-          const bindingPackageVersion = require('areev-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          const binding = require('@areev/areev-linux-riscv64-musl')
+          const bindingPackageVersion = require('@areev/areev-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -421,10 +421,10 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          const binding = require('areev-linux-riscv64-gnu')
-          const bindingPackageVersion = require('areev-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          const binding = require('@areev/areev-linux-riscv64-gnu')
+          const bindingPackageVersion = require('@areev/areev-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -438,10 +438,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-linux-ppc64-gnu')
-        const bindingPackageVersion = require('areev-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-linux-ppc64-gnu')
+        const bindingPackageVersion = require('@areev/areev-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -454,10 +454,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-linux-s390x-gnu')
-        const bindingPackageVersion = require('areev-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-linux-s390x-gnu')
+        const bindingPackageVersion = require('@areev/areev-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -474,10 +474,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-openharmony-arm64')
-        const bindingPackageVersion = require('areev-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-openharmony-arm64')
+        const bindingPackageVersion = require('@areev/areev-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -490,10 +490,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-openharmony-x64')
-        const bindingPackageVersion = require('areev-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-openharmony-x64')
+        const bindingPackageVersion = require('@areev/areev-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -506,10 +506,10 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        const binding = require('areev-openharmony-arm')
-        const bindingPackageVersion = require('areev-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '1.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        const binding = require('@areev/areev-openharmony-arm')
+        const bindingPackageVersion = require('@areev/areev-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '1.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -643,16 +643,16 @@ if (!nativeBinding || forceWasi) {
     let candidateError = null
     let candidateFailed = false
     try {
-      candidateError = __napiWasiResolveCandidate('areev-wasm32-wasi', true, undefined)
+      candidateError = __napiWasiResolveCandidate('@areev/areev-wasm32-wasi', true, undefined)
       candidateFailed = candidateError !== null
       if (!candidateFailed) {
         if (process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          const bindingPackageVersion = require('areev-wasm32-wasi/package.json').version
-          if (bindingPackageVersion !== '1.2.2') {
-            throw new Error(`WASI binding package version mismatch, expected 1.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          const bindingPackageVersion = require('@areev/areev-wasm32-wasi/package.json').version
+          if (bindingPackageVersion !== '1.3.1') {
+            throw new Error(`WASI binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
         }
-        wasiBinding = require('areev-wasm32-wasi')
+        wasiBinding = require('@areev/areev-wasm32-wasi')
         nativeBinding = wasiBinding
         wasiBindingLoaded = true
       }
@@ -702,3 +702,4 @@ if (!nativeBinding) {
 module.exports = nativeBinding
 module.exports.Areev = nativeBinding.Areev
 module.exports.dropPostgresSchema = nativeBinding.dropPostgresSchema
+module.exports.readBlobOffline = nativeBinding.readBlobOffline

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@areev/areev",
-  "version": "1.2.2",
+  "version": "1.3.1",
   "description": "Node.js bindings for Areev, the embedded memory engine for AI agents.",
   "license": "MIT OR Apache-2.0",
   "author": "MindGryd Software Private Limited",
@@ -46,10 +46,10 @@
     "@napi-rs/cli": "^3"
   },
   "optionalDependencies": {
-    "areev-darwin-arm64": "1.2.2",
-    "areev-darwin-x64": "1.2.2",
-    "areev-linux-arm64-gnu": "1.2.2",
-    "areev-linux-x64-gnu": "1.2.2",
-    "areev-win32-x64-msvc": "1.2.2"
+    "@areev/areev-darwin-arm64": "1.3.1",
+    "@areev/areev-darwin-x64": "1.3.1",
+    "@areev/areev-linux-arm64-gnu": "1.3.1",
+    "@areev/areev-linux-x64-gnu": "1.3.1",
+    "@areev/areev-win32-x64-msvc": "1.3.1"
   }
 }