@feltdb/core 0.6.8 → 0.6.10

package/dist/http-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-db.d.ts","sourceRoot":"","sources":["../src/http-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,UAAU,QAAQ;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,kBAAkB;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iFAAiF;AACjF,qBAAa,QAAS,YAAW,IAAI;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,kBAAkB;IAKvC,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,QAAQ;IAQV,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAenC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAa5C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgBrD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAerD,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA8CvP,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAa5C,mEAAmE;IAC7D,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAOtE,qEAAqE;IAC/D,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAQzE,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAMxD,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAMxF,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAOxD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAQxD,iBAAiB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;YAMvD,aAAa;YA+Bb,OAAO;IASrB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC7D,UAAU,IAAI,QAAQ;IACtB,SAAS,IAAI,QAAQ;IACrB,QAAQ,IAAI,QAAQ;IACpB,aAAa,IAAI,QAAQ;IACzB,gBAAgB,IAAI,QAAQ;IAC5B,oBAAoB,IAAI,QAAQ;IAChC,2BAA2B,IAAI,QAAQ;IACvC,WAAW,IAAI,MAAM;IACrB,YAAY,IAAI,MAAM;CACvB"}
+{"version":3,"file":"http-db.d.ts","sourceRoot":"","sources":["../src/http-db.ts"],"names":[],"mappings":"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"}

package/dist/http-db.js

@@ -82,6 +82,25 @@ export class HttpJsDb {
             return { success: false, error: String(error) };
         }
     }
+    /**
+     * Commit a multi-operation transaction through the authority.
+     *
+     * The whole transaction travels as one request and is committed as one
+     * durable record on the server. A refusal means nothing was applied.
+     */
+    async commit_transaction(request) {
+        const response = await fetch(`${this.url}/transactions`, {
+            method: 'POST',
+            headers: this.headers(true),
+            body: JSON.stringify(request),
+        });
+        if (!response.ok) {
+            const failure = await this.failure(response);
+            throw new Error(failure.error || `transaction failed with HTTP ${response.status}`);
+        }
+        const body = await response.json();
+        return body;
+    }
     async cas(params) {
         try {
             const [collection, id] = this.splitKey(params.key);
@@ -220,7 +239,16 @@ export class HttpJsDb {
                 if (controller.signal.aborted)
                     return;
             }
-            await new Promise(resolve => setTimeout(resolve, 1000));
+            if (controller.signal.aborted)
+                return;
+            // The retry timer must not keep a Node process alive on its own. An
+            // authority that has shut down would otherwise stop its clients from
+            // ever exiting, because this loop reconnects forever.
+            await new Promise(resolve => {
+                const timer = setTimeout(resolve, 1000);
+                timer?.unref?.();
+                controller.signal.addEventListener('abort', () => { clearTimeout(timer); resolve(); }, { once: true });
+            });
         }
     }
     async failure(response) {
@@ -242,5 +270,53 @@ export class HttpJsDb {
     get_pending_for_peer() { return { success: false, error: 'Operation transport is server-managed' }; }
     acknowledge_peer_operations() { return { success: false, error: 'Operation transport is server-managed' }; }
     instance_id() { return `remote:${this.url}`; }
+    /**
+     * `get_sequence()` is a hardcoded `0` here, and that is why it could never be
+     * the freshness contract: the client has no local counter worth reporting.
+     *
+     * The authority does have one. A single process advances `inner.sequence`
+     * inside the same critical section that writes the durable transaction
+     * record, so concurrent clients are serialized by the server and the revision
+     * is totally ordered. `GET /revision` reads it without performing a write.
+     */
     get_sequence() { return 0; }
+    async freshness() {
+        if (this.advertisedScope === undefined) {
+            // An authority that predates `/revision` cannot validate a cache by
+            // revision, and saying so is a real answer rather than a failure: the
+            // caller falls back to refresh, which is always correct. Only a 404
+            // degrades — a network error or a 500 is not evidence about what the
+            // server supports, so it is raised rather than reported as a capability.
+            const probe = await fetch(`${this.url}/revision`, { headers: this.headers() });
+            if (probe.status === 404) {
+                return {
+                    domain: 'single-authority',
+                    validation: 'refresh',
+                    invalidation: true,
+                    reason: 'this authority does not serve GET /revision, so it cannot report a committed revision',
+                };
+            }
+            this.absorb(await this.body(probe));
+        }
+        return {
+            domain: 'single-authority',
+            validation: 'revision',
+            invalidation: true,
+            revisionScope: this.advertisedScope,
+        };
+    }
+    async revision() {
+        const body = this.absorb(await this.body(await fetch(`${this.url}/revision`, { headers: this.headers() })));
+        return { value: body.revision, scope: body.scope };
+    }
+    async body(response) {
+        if (!response.ok) {
+            throw new Error(`revision request failed: ${response.status} ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    absorb(body) {
+        this.advertisedScope ?? (this.advertisedScope = body.scope);
+        return body;
+    }
 }

package/dist/index-backend.d.ts

@@ -19,6 +19,14 @@ export declare class IndexBackend implements IIndexBackend {
     initializeWasm(): Promise<void>;
     createIndex(config: IndexConfig): void;
     updateRecord(recordId: string, oldValue: Record<string, any> | null, newValue: Record<string, any>): void;
+    /**
+     * Discard indexed entries, keeping definitions. Reports whether it worked.
+     *
+     * The WASM backend exposes no reset, so a caller that needs the index to
+     * reflect a specific snapshot must treat `false` as "do not trust the index"
+     * rather than assuming the reset happened.
+     */
+    resetEntries(): boolean;
     queryIndex(name: string, query: IndexQuery): string[];
     queryCompoundIndex(name: string, values: Record<string, any>): string[];
     listIndexes(): IndexConfig[];

package/dist/index-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-backend.d.ts","sourceRoot":"","sources":["../src/index-backend.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACvC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAC1G,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAAC;IACtD,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC;IACxE,WAAW,IAAI,WAAW,EAAE,CAAC;CAC9B;AAyBD,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,OAAO,CAAkB;;IAM3B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAcrC,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAYtC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAezG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE;IAYrD,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE;IAgBvE,WAAW,IAAI,WAAW,EAAE;CAW7B"}
+{"version":3,"file":"index-backend.d.ts","sourceRoot":"","sources":["../src/index-backend.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACvC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAC1G,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAAC;IACtD,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC;IACxE,WAAW,IAAI,WAAW,EAAE,CAAC;CAC9B;AAyBD,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,OAAO,CAAkB;;IAM3B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAcrC,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAYtC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAezG;;;;;;OAMG;IACH,YAAY,IAAI,OAAO;IAMvB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE;IAYrD,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE;IAgBvE,WAAW,IAAI,WAAW,EAAE;CAW7B"}

package/dist/index-backend.js

@@ -72,6 +72,19 @@ export class IndexBackend {
         }
         this.tsBackend?.updateRecord(recordId, oldValue, newValue);
     }
+    /**
+     * Discard indexed entries, keeping definitions. Reports whether it worked.
+     *
+     * The WASM backend exposes no reset, so a caller that needs the index to
+     * reflect a specific snapshot must treat `false` as "do not trust the index"
+     * rather than assuming the reset happened.
+     */
+    resetEntries() {
+        if (this.useWasm && this.wasmBackend)
+            return false;
+        this.tsBackend?.resetEntries();
+        return this.tsBackend !== null;
+    }
     queryIndex(name, query) {
         if (this.useWasm && this.wasmBackend) {
             try {

package/dist/index-core.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Shared @feltdb/core surface.
+ *
+ * Everything here loads in any JavaScript environment. Modules that need Node
+ * built-ins are re-exported by `index.ts` (the Node entry) instead, so that a
+ * browser can load this graph without hitting a bare `fs` or `path`
+ * specifier.
+ *
+ * Applications import `@feltdb/core`, not this module directly.
+ */
+export * from './db.js';
+export * from './collection.js';
+export * from './transaction.js';
+export * from './freshness.js';
+export * from './cell.js';
+export * from './reactive-graph.js';
+export * from './index-types.js';
+export * from './index-backend.js';
+export * from './index-store.js';
+export * from './index-recovery.js';
+export * from './query-planner.js';
+export * from './index-analytics.js';
+export * from './analytics-backend.js';
+export * from './index-dashboard.js';
+export * from './index-monitoring.js';
+export * from './distributed-indexing.js';
+export * from './sharding.js';
+export * from './recovery.js';
+export * from './execution.js';
+export * from './workflow.js';
+export * from './capability.js';
+export * from './memory-db.js';
+export * from './http-db.js';
+export * from './http-client.js';
+export * from './indexeddb-db.js';
+export * from './flowspec.js';
+export * from './application-manifest.js';
+export * from './state-contract.js';
+export * from './revision-recovery.js';
+export * from './operation-admission.js';
+export * from './error-codes.js';
+export * from './authorization.js';
+export * from './sync-contract.js';
+export * from './workload.js';
+export * from './worker.js';
+export * from './artifact.js';
+export * from './bundle.js';
+export * from './release.js';
+export * from './observe.js';
+export * from './provider.js';
+export * from './identity.js';
+export * from './application-contract.js';
+export { ProtocolHandler, type Message, type Operation as ProtocolOperation, type Response as ProtocolResponse, } from './protocol.js';
+/**
+ * Agent Runtime APIs
+ */
+export * from './agent.js';
+export * from './agent-observation.js';
+export * from './agent-decision.js';
+export * from './agent-memory.js';
+export * from './agent-registry.js';
+export * from './agent-runtime.js';
+/**
+ * Telemetry APIs
+ */
+export { emitTelemetry, getTelemetryClient } from './telemetry.js';
+export type { TelemetryEvent, TelemetryEventType } from './telemetry.js';
+/**
+ * Observability and inspection APIs
+ */
+export type { ProvenanceGraph, ProvenanceNode, ProvenanceEdge, ProvenanceEdgeType, RuntimeDiagnostics, } from './db.js';
+/**
+ * Development Workspace APIs
+ *
+ * Shared development state for coordinating Browser, IDE, and Agent clients.
+ */
+export * from './workspace/browser.js';
+//# sourceMappingURL=index-core.d.ts.map

package/dist/index-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-core.d.ts","sourceRoot":"","sources":["../src/index-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EACL,eAAe,EACf,KAAK,OAAO,EACZ,KAAK,SAAS,IAAI,iBAAiB,EACnC,KAAK,QAAQ,IAAI,gBAAgB,GAClC,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAEnC;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzE;;GAEG;AACH,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,cAAc,wBAAwB,CAAC"}

package/dist/index-core.js

@@ -0,0 +1,72 @@
+/**
+ * Shared @feltdb/core surface.
+ *
+ * Everything here loads in any JavaScript environment. Modules that need Node
+ * built-ins are re-exported by `index.ts` (the Node entry) instead, so that a
+ * browser can load this graph without hitting a bare `fs` or `path`
+ * specifier.
+ *
+ * Applications import `@feltdb/core`, not this module directly.
+ */
+export * from './db.js';
+export * from './collection.js';
+export * from './transaction.js';
+export * from './freshness.js';
+export * from './cell.js';
+export * from './reactive-graph.js';
+export * from './index-types.js';
+export * from './index-backend.js';
+export * from './index-store.js';
+export * from './index-recovery.js';
+export * from './query-planner.js';
+export * from './index-analytics.js';
+export * from './analytics-backend.js';
+export * from './index-dashboard.js';
+export * from './index-monitoring.js';
+export * from './distributed-indexing.js';
+export * from './sharding.js';
+export * from './recovery.js';
+export * from './execution.js';
+export * from './workflow.js';
+export * from './capability.js';
+export * from './memory-db.js';
+export * from './http-db.js';
+export * from './http-client.js';
+export * from './indexeddb-db.js';
+export * from './flowspec.js';
+export * from './application-manifest.js';
+export * from './state-contract.js';
+export * from './revision-recovery.js';
+export * from './operation-admission.js';
+export * from './error-codes.js';
+export * from './authorization.js';
+export * from './sync-contract.js';
+export * from './workload.js';
+export * from './worker.js';
+export * from './artifact.js';
+export * from './bundle.js';
+export * from './release.js';
+export * from './observe.js';
+export * from './provider.js';
+export * from './identity.js';
+export * from './application-contract.js';
+export { ProtocolHandler, } from './protocol.js';
+/**
+ * Agent Runtime APIs
+ */
+export * from './agent.js';
+export * from './agent-observation.js';
+export * from './agent-decision.js';
+export * from './agent-memory.js';
+export * from './agent-registry.js';
+export * from './agent-runtime.js';
+/**
+ * Telemetry APIs
+ */
+export { emitTelemetry, getTelemetryClient } from './telemetry.js';
+/**
+ * Development Workspace APIs
+ *
+ * Shared development state for coordinating Browser, IDE, and Agent clients.
+ */
+export * from './workspace/browser.js';

package/dist/index-manager.d.ts

@@ -8,6 +8,17 @@ export declare class IndexManager {
     private indexes;
     private config;
     private indexStats;
+    /** Construct an empty index from its configuration. */
+    private buildIndex;
+    /**
+     * Discard every indexed entry while keeping the index definitions.
+     *
+     * A caller that derives its indexes from a snapshot of the data needs to
+     * rebuild them when that snapshot is replaced. Without this, entries for
+     * records that are no longer present would linger and a query could return
+     * ids the caller can no longer resolve.
+     */
+    resetEntries(): void;
     createIndex(config: IndexConfig): void;
     updateRecord(recordId: string, oldValue: Record<string, any> | null, newValue: Record<string, any>): void;
     queryIndex(name: string, query: IndexQuery): string[];

package/dist/index-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-manager.d.ts","sourceRoot":"","sources":["../src/index-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAc,UAAU,EAAE,UAAU,EAAe,SAAS,EAAiB,MAAM,kBAAkB,CAAC;AAyN/H,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAyE;IACxF,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,UAAU,CAAsC;IAExD,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IA8BtC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IA6BzG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE;IA0BrD,WAAW,IAAI,WAAW,EAAE;IAI5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAIzC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS;CAwCvC"}
+{"version":3,"file":"index-manager.d.ts","sourceRoot":"","sources":["../src/index-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAc,UAAU,EAAE,UAAU,EAAe,SAAS,EAAiB,MAAM,kBAAkB,CAAC;AAyN/H,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAyE;IACxF,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,UAAU,CAAsC;IAExD,uDAAuD;IACvD,OAAO,CAAC,UAAU;IAOlB;;;;;;;OAOG;IACH,YAAY,IAAI,IAAI;IAQpB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAqBtC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IA6BzG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE;IA0BrD,WAAW,IAAI,WAAW,EAAE;IAI5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAIzC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS;CAwCvC"}

package/dist/index-manager.js

@@ -201,23 +201,40 @@ export class IndexManager {
         this.config = new Map();
         this.indexStats = new Map();
     }
+    /** Construct an empty index from its configuration. */
+    buildIndex(config) {
+        if (config.type === 'hash' && config.field)
+            return new HashIndex(config.field);
+        if (config.type === 'sorted' && config.field)
+            return new SortedIndex(config.field);
+        if (config.type === 'text' && config.textFields)
+            return new TextIndex(config.textFields);
+        throw new Error(`Invalid index config: ${JSON.stringify(config)}`);
+    }
+    /**
+     * Discard every indexed entry while keeping the index definitions.
+     *
+     * A caller that derives its indexes from a snapshot of the data needs to
+     * rebuild them when that snapshot is replaced. Without this, entries for
+     * records that are no longer present would linger and a query could return
+     * ids the caller can no longer resolve.
+     */
+    resetEntries() {
+        for (const [name, config] of this.config) {
+            this.indexes.set(name, this.buildIndex(config));
+            const stats = this.indexStats.get(name);
+            if (stats) {
+                stats.entries = 0;
+                stats.size = 0;
+                stats.lastUpdated = Date.now();
+            }
+        }
+    }
     createIndex(config) {
         if (this.indexes.has(config.name)) {
             throw new Error(`Index ${config.name} already exists`);
         }
-        let index;
-        if (config.type === 'hash' && config.field) {
-            index = new HashIndex(config.field);
-        }
-        else if (config.type === 'sorted' && config.field) {
-            index = new SortedIndex(config.field);
-        }
-        else if (config.type === 'text' && config.textFields) {
-            index = new TextIndex(config.textFields);
-        }
-        else {
-            throw new Error(`Invalid index config: ${JSON.stringify(config)}`);
-        }
+        const index = this.buildIndex(config);
         this.indexes.set(config.name, index);
         this.config.set(config.name, config);
         this.indexStats.set(config.name, {

package/dist/index-types.d.ts

@@ -35,6 +35,23 @@ export interface IndexQuery {
     min?: any;
     max?: any;
 }
+/**
+ * How a `Collection.find` call was answered.
+ *
+ * Distinct from `QueryPlan`, which describes the cost-based planner's output.
+ * This records what a single collection read actually did.
+ */
+export interface CollectionQueryPlan {
+    strategy: 'index' | 'scan';
+    /** Present when the index was used. */
+    indexName?: string;
+    field?: string;
+    /** Present when a scan was chosen, explaining why. */
+    reason?: string;
+    /** Records the predicate was applied to. */
+    candidatesExamined: number;
+    recordsReturned: number;
+}
 export interface IndexScanPlan {
     indexName: string;
     indexType: IndexType;

package/dist/index-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-types.d.ts","sourceRoot":"","sources":["../src/index-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,mDAAmD;IACnD,IAAI,EAAE,SAAS,CAAC;IAEhB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG;IAC1C,GAAG,EAAE,CAAC,CAAC;IACP,MAAM,EAAE,CAAC,EAAE,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;IAC1F,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC;IACpE,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"index-types.d.ts","sourceRoot":"","sources":["../src/index-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,mDAAmD;IACnD,IAAI,EAAE,SAAS,CAAC;IAEhB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG;IAC1C,GAAG,EAAE,CAAC,CAAC;IACP,MAAM,EAAE,CAAC,EAAE,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;IAC1F,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC;IACpE,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/index.browser.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Browser entry point for @feltdb/core.
+ *
+ * Selected by the `browser` condition in the package exports map, so a browser
+ * application writing `import { createFeltDB } from '@feltdb/core'` gets a
+ * module graph with no Node built-ins in it.
+ *
+ * The browser runtime itself has no Node dependencies, so it is imported
+ * directly by `db.ts`. What this entry does is leave the file runtime out of
+ * the graph, which is what makes `createFeltDB({ browser: true })` — and
+ * therefore `db.transaction()` — reachable through the public package entry.
+ */
+export * from './index-core.js';
+//# sourceMappingURL=index.browser.d.ts.map

package/dist/index.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,iBAAiB,CAAC"}

package/dist/index.browser.js

@@ -0,0 +1,13 @@
+/**
+ * Browser entry point for @feltdb/core.
+ *
+ * Selected by the `browser` condition in the package exports map, so a browser
+ * application writing `import { createFeltDB } from '@feltdb/core'` gets a
+ * module graph with no Node built-ins in it.
+ *
+ * The browser runtime itself has no Node dependencies, so it is imported
+ * directly by `db.ts`. What this entry does is leave the file runtime out of
+ * the graph, which is what makes `createFeltDB({ browser: true })` — and
+ * therefore `db.transaction()` — reachable through the public package entry.
+ */
+export * from './index-core.js';

package/dist/index.d.ts

@@ -4,71 +4,20 @@
  * The primary interface for developers using FeltDB.
  * Provides a simple, state-first API for data persistence,
  * reactivity, and distributed operations.
+ *
+ * This is the Node entry point. It adds the runtimes and workspace tooling
+ * that need Node built-ins on top of the shared surface in `index-core.ts`.
+ * Browsers resolve `index.browser.ts` instead, through the package exports
+ * map, so that a bare `fs` import never enters a browser module graph.
  */
-export * from './db.js';
-export * from './collection.js';
-export * from './cell.js';
-export * from './reactive-graph.js';
-export * from './index-types.js';
-export * from './index-backend.js';
-export * from './index-store.js';
-export * from './index-recovery.js';
-export * from './query-planner.js';
-export * from './index-analytics.js';
-export * from './analytics-backend.js';
-export * from './index-dashboard.js';
-export * from './index-monitoring.js';
-export * from './distributed-indexing.js';
-export * from './sharding.js';
-export * from './recovery.js';
-export * from './execution.js';
-export * from './workflow.js';
-export * from './capability.js';
-export * from './memory-db.js';
-export * from './http-db.js';
-export * from './http-client.js';
-export * from './indexeddb-db.js';
+export * from './index-core.js';
 export * from './file-db.js';
-export * from './flowspec.js';
-export * from './application-manifest.js';
-export * from './state-contract.js';
-export * from './revision-recovery.js';
-export * from './operation-admission.js';
-export * from './error-codes.js';
-export * from './authorization.js';
-export * from './sync-contract.js';
-export * from './workload.js';
-export * from './worker.js';
-export * from './artifact.js';
-export * from './bundle.js';
-export * from './release.js';
-export * from './observe.js';
-export * from './provider.js';
-export * from './identity.js';
-export * from './application-contract.js';
-export { ProtocolHandler, type Message, type Operation as ProtocolOperation, type Response as ProtocolResponse, } from './protocol.js';
-/**
- * Agent Runtime APIs
- */
-export * from './agent.js';
-export * from './agent-observation.js';
-export * from './agent-decision.js';
-export * from './agent-memory.js';
-export * from './agent-registry.js';
-export * from './agent-runtime.js';
-/**
- * Telemetry APIs
- */
-export { emitTelemetry, getTelemetryClient } from './telemetry.js';
-export type { TelemetryEvent, TelemetryEventType } from './telemetry.js';
-/**
- * Observability and inspection APIs
- */
-export type { ProvenanceGraph, ProvenanceNode, ProvenanceEdge, ProvenanceEdgeType, RuntimeDiagnostics, } from './db.js';
 /**
  * Development Workspace APIs
  *
  * Shared development state for coordinating Browser, IDE, and Agent clients.
+ * The Node-only pieces (durable investigation store, supervisor, local
+ * development authority, Git inspection) are available from this entry only.
  */
 export * from './workspace/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EACL,eAAe,EACf,KAAK,OAAO,EACZ,KAAK,SAAS,IAAI,iBAAiB,EACnC,KAAK,QAAQ,IAAI,gBAAgB,GAClC,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAEnC;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzE;;GAEG;AACH,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAE7B;;;;;;GAMG;AACH,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -4,65 +4,22 @@
  * The primary interface for developers using FeltDB.
  * Provides a simple, state-first API for data persistence,
  * reactivity, and distributed operations.
+ *
+ * This is the Node entry point. It adds the runtimes and workspace tooling
+ * that need Node built-ins on top of the shared surface in `index-core.ts`.
+ * Browsers resolve `index.browser.ts` instead, through the package exports
+ * map, so that a bare `fs` import never enters a browser module graph.
  */
-export * from './db.js';
-export * from './collection.js';
-export * from './cell.js';
-export * from './reactive-graph.js';
-export * from './index-types.js';
-export * from './index-backend.js';
-export * from './index-store.js';
-export * from './index-recovery.js';
-export * from './query-planner.js';
-export * from './index-analytics.js';
-export * from './analytics-backend.js';
-export * from './index-dashboard.js';
-export * from './index-monitoring.js';
-export * from './distributed-indexing.js';
-export * from './sharding.js';
-export * from './recovery.js';
-export * from './execution.js';
-export * from './workflow.js';
-export * from './capability.js';
-export * from './memory-db.js';
-export * from './http-db.js';
-export * from './http-client.js';
-export * from './indexeddb-db.js';
+import { registerRuntime } from './runtime-registry.js';
+import { FileJsDb } from './file-db.js';
+registerRuntime('file', path => new FileJsDb(path));
+export * from './index-core.js';
 export * from './file-db.js';
-export * from './flowspec.js';
-export * from './application-manifest.js';
-export * from './state-contract.js';
-export * from './revision-recovery.js';
-export * from './operation-admission.js';
-export * from './error-codes.js';
-export * from './authorization.js';
-export * from './sync-contract.js';
-export * from './workload.js';
-export * from './worker.js';
-export * from './artifact.js';
-export * from './bundle.js';
-export * from './release.js';
-export * from './observe.js';
-export * from './provider.js';
-export * from './identity.js';
-export * from './application-contract.js';
-export { ProtocolHandler, } from './protocol.js';
-/**
- * Agent Runtime APIs
- */
-export * from './agent.js';
-export * from './agent-observation.js';
-export * from './agent-decision.js';
-export * from './agent-memory.js';
-export * from './agent-registry.js';
-export * from './agent-runtime.js';
-/**
- * Telemetry APIs
- */
-export { emitTelemetry, getTelemetryClient } from './telemetry.js';
 /**
  * Development Workspace APIs
  *
  * Shared development state for coordinating Browser, IDE, and Agent clients.
+ * The Node-only pieces (durable investigation store, supervisor, local
+ * development authority, Git inspection) are available from this entry only.
  */
 export * from './workspace/index.js';