@plur-ai/core 0.9.5 → 0.9.6

package/dist/index.d.ts

@@ -2252,6 +2252,16 @@ declare class Plur {
      * freshness and closes the race. See issue #25.
      */
     private _writeEngrams;
+    /**
+     * Resolve a remote store for a write scope. Returns the RemoteStore driver
+     * if the engram's scope matches a registered remote entry, else null.
+     *
+     * Match rule (pilot scope): exact-match `entry.scope === engramScope`. We
+     * intentionally don't do prefix-match yet — agents that want to write to a
+     * narrower scope than they registered must explicitly register the narrower
+     * scope. Keeps routing predictable and prevents accidental cross-team writes.
+     */
+    private _resolveRemoteStoreForScope;
     /** Find which store owns an engram by ID. For namespaced IDs, strips prefix to find in store. */
     private _findEngramStore;
     /** Content hash fast-path dedup. */

package/dist/index.js

@@ -3442,6 +3442,31 @@ var Plur = class {
     saveEngrams(path3, engrams);
     this._engramCache.delete(path3);
   }
+  /**
+   * Resolve a remote store for a write scope. Returns the RemoteStore driver
+   * if the engram's scope matches a registered remote entry, else null.
+   *
+   * Match rule (pilot scope): exact-match `entry.scope === engramScope`. We
+   * intentionally don't do prefix-match yet — agents that want to write to a
+   * narrower scope than they registered must explicitly register the narrower
+   * scope. Keeps routing predictable and prevents accidental cross-team writes.
+   */
+  _resolveRemoteStoreForScope(scope) {
+    const stores = this.config.stores ?? [];
+    for (const entry of stores) {
+      if (!entry.url) continue;
+      if (entry.readonly === true) continue;
+      if (entry.scope !== scope) continue;
+      const key = `${entry.url}::${entry.scope}`;
+      let driver = this._remoteStores.get(key);
+      if (!driver) {
+        driver = new RemoteStore(entry.url, entry.token ?? "", entry.scope);
+        this._remoteStores.set(key, driver);
+      }
+      return driver;
+    }
+    return null;
+  }
   /** Find which store owns an engram by ID. For namespaced IDs, strips prefix to find in store. */
   _findEngramStore(id) {
     const primaryEngrams = this._loadCached(this.paths.engrams);
@@ -3572,6 +3597,19 @@ var Plur = class {
         } : void 0,
         pinned: context?.pinned === true ? true : void 0
       };
+      const remoteDriver = this._resolveRemoteStoreForScope(scope);
+      if (remoteDriver) {
+        void remoteDriver.append(engram).catch((err) => {
+          logger.error(`[plur:learn] remote append failed for ${engram.id} (scope=${scope}): ${err.message}`);
+        });
+        appendHistory(this.paths.root, {
+          event: "engram_created",
+          engram_id: engram.id,
+          timestamp: now,
+          data: { type: engram.type, scope: engram.scope, source: engram.source, routed_to: "remote" }
+        });
+        return engram;
+      }
       engrams.push(engram);
       this._writeEngrams(this.paths.engrams, engrams);
       this._syncIndex();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plur-ai/core",
-  "version": "0.9.5",
+  "version": "0.9.6",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",