@feltdb/core 0.2.0 → 0.4.0

package/dist/index-store.js

@@ -0,0 +1,141 @@
+/**
+ * Index Persistence Layer
+ *
+ * Handles serialization and storage of indexes for durability.
+ * Indexes are stored in a special collection alongside application data.
+ */
+export class IndexStore {
+    constructor(db, collectionName) {
+        this.db = db;
+        this.collectionName = collectionName;
+    }
+    /**
+     * Save index metadata to storage.
+     * Stores index configuration but not the actual index data (rebuilt on demand).
+     */
+    async saveIndexConfig(config, entryCount) {
+        const key = `__indexes__:${this.collectionName}:${config.name}`;
+        const stored = {
+            config,
+            version: 1,
+            createdAt: Date.now(),
+            lastUpdated: Date.now(),
+            entryCount,
+        };
+        const result = await this.db.insert(key, JSON.stringify(stored));
+        if (!result.success) {
+            console.warn(`Failed to save index config for ${config.name}: ${result.error}`);
+        }
+    }
+    /**
+     * Load all index configurations for a collection.
+     */
+    async loadIndexConfigs() {
+        const result = await this.db.query(`__indexes__:${this.collectionName}`);
+        if (!result.success || !result.data) {
+            return [];
+        }
+        try {
+            const stored = JSON.parse(result.data);
+            return stored.map(s => s.config);
+        }
+        catch {
+            console.warn(`Failed to parse index configs for ${this.collectionName}`);
+            return [];
+        }
+    }
+    /**
+     * Get specific index configuration.
+     */
+    async getIndexConfig(indexName) {
+        const key = `__indexes__:${this.collectionName}:${indexName}`;
+        const result = await this.db.get(key);
+        if (!result.success || !result.data) {
+            return null;
+        }
+        try {
+            const stored = JSON.parse(result.data);
+            return stored.config;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Delete index metadata from storage.
+     */
+    async deleteIndexConfig(indexName) {
+        const key = `__indexes__:${this.collectionName}:${indexName}`;
+        if (!this.db.delete) {
+            console.warn(`Failed to delete index config for ${indexName}: delete is not supported`);
+            return;
+        }
+        const deleteResult = this.db.delete(key);
+        const result = deleteResult instanceof Promise ? await deleteResult : deleteResult;
+        if (!result?.success) {
+            console.warn(`Failed to delete index config for ${indexName}: ${result?.error}`);
+        }
+    }
+    /**
+     * Update index metadata (entry count, timestamp).
+     */
+    async updateIndexStats(indexName, entryCount) {
+        const key = `__indexes__:${this.collectionName}:${indexName}`;
+        const result = await this.db.get(key);
+        if (!result.success || !result.data) {
+            return;
+        }
+        try {
+            const stored = JSON.parse(result.data);
+            stored.lastUpdated = Date.now();
+            stored.entryCount = entryCount;
+            await this.db.insert(key, JSON.stringify(stored));
+        }
+        catch {
+            console.warn(`Failed to update index stats for ${indexName}`);
+        }
+    }
+    /**
+     * Get full index snapshot (configuration + metadata).
+     */
+    async getSnapshot() {
+        const configs = await this.loadIndexConfigs();
+        return {
+            collectionName: this.collectionName,
+            indexes: configs.map(config => ({
+                config,
+                version: 1,
+                createdAt: Date.now(),
+                lastUpdated: Date.now(),
+                entryCount: 0,
+            })),
+            timestamp: Date.now(),
+        };
+    }
+}
+/**
+ * Index rebuilder - reconstructs indexes from collection data.
+ * Used when loading persisted indexes at startup.
+ */
+export class IndexRebuilder {
+    static async rebuildIndexes(db, collectionName, items, indexConfigs) {
+        const indexes = new Map();
+        for (const config of indexConfigs) {
+            // For now, just track that we need to rebuild these indexes.
+            // Actual rebuilding happens in the IndexBackend when collections initialize.
+            indexes.set(config.name, {
+                config,
+                needsRebuild: true,
+                itemCount: items.length,
+            });
+        }
+        return indexes;
+    }
+    /**
+     * Check if an index is stale by comparing entry count to collection size.
+     */
+    static isStale(indexEntryCount, collectionSize) {
+        // If entry count is significantly less than collection size, index is likely stale
+        return indexEntryCount < collectionSize * 0.9;
+    }
+}

package/dist/index-types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Index Types and Interfaces
+ *
+ * Defines the contract for different index types and query strategies.
+ */
+export type IndexType = 'hash' | 'sorted' | 'compound' | 'text';
+export interface IndexConfig {
+    /** Unique name for this index */
+    name: string;
+    /** Type of index (hash, sorted, compound, text) */
+    type: IndexType;
+    /** For single-field indexes: the field name */
+    field?: string;
+    /** For compound indexes: array of field names */
+    fields?: string[];
+    /** For text indexes: fields to search */
+    textFields?: string[];
+    /** Whether to maintain the index in-memory */
+    inmemory?: boolean;
+    /** Whether to persist this index to storage */
+    persistent?: boolean;
+    /** Optional description */
+    description?: string;
+}
+export interface IndexEntry<K = any, V = any> {
+    key: K;
+    values: V[];
+    count: number;
+}
+export interface IndexQuery {
+    field: string;
+    operator: 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'contains' | 'startsWith' | 'range';
+    value?: any;
+    values?: any[];
+    min?: any;
+    max?: any;
+}
+export interface IndexScanPlan {
+    indexName: string;
+    indexType: IndexType;
+    estimatedRows: number;
+    cost: number;
+    canPruneAll: boolean;
+    requiresPostFilter: boolean;
+}
+export interface QueryPlan {
+    strategy: 'full-scan' | 'index-scan' | 'index-merge' | 'index-join';
+    indexes: IndexScanPlan[];
+    estimatedRows: number;
+    totalCost: number;
+    explanation: string;
+}
+export interface IndexStats {
+    name: string;
+    type: IndexType;
+    entries: number;
+    size: number;
+    lastUpdated: number;
+    reads: number;
+    writes: number;
+    selectivity: number;
+}
+export interface IndexResult<T> {
+    recordIds: string[];
+    count: number;
+    indexUsed: string;
+    executionTimeMs: number;
+    cost: number;
+}
+//# sourceMappingURL=index-types.d.ts.map

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

@@ -0,0 +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"}

package/dist/index-types.js

@@ -0,0 +1,6 @@
+/**
+ * Index Types and Interfaces
+ *
+ * Defines the contract for different index types and query strategies.
+ */
+export {};

package/dist/index.d.ts

@@ -8,14 +8,40 @@
 export * from './db.js';
 export * from './collection.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 './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
  */

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,qBAAqB,CAAC;AACpC,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,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAE9B;;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,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}
+{"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,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,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,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -8,14 +8,40 @@
 export * from './db.js';
 export * from './collection.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 './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
  */

package/dist/observe.d.ts

@@ -0,0 +1,51 @@
+export interface CausalEvent {
+    event_id: string;
+    causal_id: string;
+    parent_event_id?: string;
+    timestamp: number;
+    tenant_id: string;
+    application_id: string;
+    revision_id?: string;
+    subject_id: string;
+    subject_type: string;
+    authorization_decision_id?: string;
+    capability?: string;
+    resource?: string;
+    operation: string;
+    workload_id?: string;
+    attempt_id?: string;
+    worker_id?: string;
+    connection_id?: string;
+    execution_id?: string;
+    state_version?: string;
+    operation_ids: string[];
+    artifact_ids: string[];
+    result_id?: string;
+    status: string;
+    error_code?: string;
+    metadata: Record<string, unknown>;
+    schema_version: number;
+}
+export declare class ObserveClient {
+    private baseUrl;
+    private fetcher;
+    constructor(baseUrl?: string, fetcher?: typeof fetch);
+    private json;
+    events(applicationId: string): Promise<{
+        events: CausalEvent[];
+    }>;
+    cause(causalId: string): Promise<{
+        events: CausalEvent[];
+    }>;
+    workload(workloadId: string): Promise<{
+        events: CausalEvent[];
+    }>;
+    execution(executionId: string): Promise<{
+        events: CausalEvent[];
+    }>;
+    revision(revisionId: string): Promise<{
+        events: CausalEvent[];
+    }>;
+    append(event: CausalEvent): Promise<CausalEvent>;
+}
+//# sourceMappingURL=observe.d.ts.map

package/dist/observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../src/observe.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAAC,QAAQ,EAAC,MAAM,CAAC;IAAA,SAAS,EAAC,MAAM,CAAC;IAAA,eAAe,CAAC,EAAC,MAAM,CAAC;IAAA,SAAS,EAAC,MAAM,CAAC;IAAA,SAAS,EAAC,MAAM,CAAC;IAAA,cAAc,EAAC,MAAM,CAAC;IAAA,WAAW,CAAC,EAAC,MAAM,CAAC;IAAA,UAAU,EAAC,MAAM,CAAC;IAAA,YAAY,EAAC,MAAM,CAAC;IAAA,yBAAyB,CAAC,EAAC,MAAM,CAAC;IAAA,UAAU,CAAC,EAAC,MAAM,CAAC;IAAA,QAAQ,CAAC,EAAC,MAAM,CAAC;IAAA,SAAS,EAAC,MAAM,CAAC;IAAA,WAAW,CAAC,EAAC,MAAM,CAAC;IAAA,UAAU,CAAC,EAAC,MAAM,CAAC;IAAA,SAAS,CAAC,EAAC,MAAM,CAAC;IAAA,aAAa,CAAC,EAAC,MAAM,CAAC;IAAA,YAAY,CAAC,EAAC,MAAM,CAAC;IAAA,aAAa,CAAC,EAAC,MAAM,CAAC;IAAA,aAAa,EAAC,MAAM,EAAE,CAAC;IAAA,YAAY,EAAC,MAAM,EAAE,CAAC;IAAA,SAAS,CAAC,EAAC,MAAM,CAAC;IAAA,MAAM,EAAC,MAAM,CAAC;IAAA,UAAU,CAAC,EAAC,MAAM,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC,MAAM,EAAC,OAAO,CAAC,CAAC;IAAA,cAAc,EAAC,MAAM,CAAA;CAAC;AAC/iB,qBAAa,aAAa;IAAa,OAAO,CAAC,OAAO;IAAI,OAAO,CAAC,OAAO;gBAA1B,OAAO,SAAG,EAAS,OAAO,GAAC,OAAO,KAAW;YAAiB,IAAI;IAA+R,MAAM,CAAC,aAAa,EAAC,MAAM;gBAA2B,WAAW,EAAE;;IAAmF,KAAK,CAAC,QAAQ,EAAC,MAAM;gBAA2B,WAAW,EAAE;;IAA+D,QAAQ,CAAC,UAAU,EAAC,MAAM;gBAA2B,WAAW,EAAE;;IAA6E,SAAS,CAAC,WAAW,EAAC,MAAM;gBAA2B,WAAW,EAAE;;IAA+E,QAAQ,CAAC,UAAU,EAAC,MAAM;gBAA2B,WAAW,EAAE;;IAA6E,MAAM,CAAC,KAAK,EAAC,WAAW;CAA0G"}

package/dist/observe.js

@@ -0,0 +1,14 @@
+export class ObserveClient {
+    constructor(baseUrl = '', fetcher = fetch) {
+        this.baseUrl = baseUrl;
+        this.fetcher = fetcher;
+    }
+    async json(path, init) { const r = await this.fetcher(`${this.baseUrl}${path}`, { credentials: 'include', headers: { 'content-type': 'application/json' }, ...init }); const v = await r.json(); if (!r.ok)
+        throw new Error(v?.error || `Observe request failed (${r.status})`); return v; }
+    events(applicationId) { return this.json(`/v1/observability/events?application_id=${encodeURIComponent(applicationId)}`); }
+    cause(causalId) { return this.json(`/v1/observability/causes/${encodeURIComponent(causalId)}`); }
+    workload(workloadId) { return this.json(`/v1/observability/workloads/${encodeURIComponent(workloadId)}/timeline`); }
+    execution(executionId) { return this.json(`/v1/observability/executions/${encodeURIComponent(executionId)}/timeline`); }
+    revision(revisionId) { return this.json(`/v1/observability/revisions/${encodeURIComponent(revisionId)}/timeline`); }
+    append(event) { return this.json('/v1/observability/events', { method: 'POST', body: JSON.stringify({ event }) }); }
+}

package/dist/protocol.d.ts

@@ -0,0 +1,25 @@
+/**
+ * FeltDB Protocol - Low-level communication protocol
+ */
+export interface Message {
+    type: string;
+    payload: any;
+    id?: string;
+}
+export interface Operation {
+    type: 'insert' | 'update' | 'delete' | 'query';
+    collection?: string;
+    data?: any;
+    id?: string;
+}
+export interface Response {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+export declare class ProtocolHandler {
+    static encode(message: Message): string;
+    static decode(data: string): Message;
+    static createOperation(op: Operation): Message;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,GAAG,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,eAAe;IAC1B,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAIvC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO;CAO/C"}

package/dist/protocol.js

@@ -0,0 +1,18 @@
+/**
+ * FeltDB Protocol - Low-level communication protocol
+ */
+export class ProtocolHandler {
+    static encode(message) {
+        return JSON.stringify(message);
+    }
+    static decode(data) {
+        return JSON.parse(data);
+    }
+    static createOperation(op) {
+        return {
+            type: 'operation',
+            payload: op,
+            id: `op-${Date.now()}`,
+        };
+    }
+}

package/dist/provider.d.ts

@@ -0,0 +1,61 @@
+export type ProviderType = 'connection' | 'storage' | 'search' | 'vector' | 'llm' | 'embedding' | 'identity' | 'delivery' | 'worker' | 'execution' | 'scheduler' | 'deployment' | 'observability' | 'ui' | 'workflow' | 'capability' | 'agent';
+export type ProviderStatus = 'INSTALLED' | 'AVAILABLE' | 'ENABLED' | 'DISABLED' | 'REVOKED' | 'UPGRADE_PENDING' | 'FAILED';
+export interface ProviderManifest {
+    provider_id: string;
+    namespace: string;
+    provider_type: ProviderType;
+    version: string;
+    feltdb_contract: string;
+    capabilities: string[];
+    permissions: string[];
+    environments: string[];
+    runtimes: string[];
+    dependencies: Record<string, string>;
+    configuration_schema: unknown;
+    secret_requirements: string[];
+    migration_required: boolean;
+    publisher: string;
+    package_ref: string;
+    package_hash: string;
+    signature?: string;
+}
+export interface InstalledProvider {
+    manifest: ProviderManifest;
+    status: ProviderStatus;
+    installed_at: number;
+    tenant_bindings: string[];
+    application_bindings: string[];
+    granted_capabilities: string[];
+    configuration_revision?: string;
+    health: {
+        status: string;
+        ready: boolean;
+        version: string;
+        last_invocation?: number;
+        last_failure?: string;
+    };
+}
+export declare class ProviderClient {
+    private baseUrl;
+    private fetcher;
+    constructor(baseUrl?: string, fetcher?: typeof fetch);
+    private json;
+    list(): Promise<{
+        providers: InstalledProvider[];
+    }>;
+    inspect(id: string): Promise<InstalledProvider>;
+    install(manifest: ProviderManifest, tenantId?: string, applicationId?: string): Promise<InstalledProvider>;
+    enable(id: string): Promise<InstalledProvider>;
+    disable(id: string): Promise<InstalledProvider>;
+    revoke(id: string): Promise<InstalledProvider>;
+    status(id: string, status: ProviderStatus): Promise<InstalledProvider>;
+    health(id: string): Promise<{
+        status: string;
+        ready: boolean;
+        version: string;
+        last_invocation?: number;
+        last_failure?: string;
+    }>;
+    dependencies(id: string): Promise<Record<string, string>>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAC,YAAY,GAAC,SAAS,GAAC,QAAQ,GAAC,QAAQ,GAAC,KAAK,GAAC,WAAW,GAAC,UAAU,GAAC,UAAU,GAAC,QAAQ,GAAC,WAAW,GAAC,WAAW,GAAC,YAAY,GAAC,eAAe,GAAC,IAAI,GAAC,UAAU,GAAC,YAAY,GAAC,OAAO,CAAC;AAAA,MAAM,MAAM,cAAc,GAAC,WAAW,GAAC,WAAW,GAAC,SAAS,GAAC,UAAU,GAAC,SAAS,GAAC,iBAAiB,GAAC,QAAQ,CAAC;AAAA,MAAM,WAAW,gBAAgB;IAAC,WAAW,EAAC,MAAM,CAAC;IAAA,SAAS,EAAC,MAAM,CAAC;IAAA,aAAa,EAAC,YAAY,CAAC;IAAA,OAAO,EAAC,MAAM,CAAC;IAAA,eAAe,EAAC,MAAM,CAAC;IAAA,YAAY,EAAC,MAAM,EAAE,CAAC;IAAA,WAAW,EAAC,MAAM,EAAE,CAAC;IAAA,YAAY,EAAC,MAAM,EAAE,CAAC;IAAA,QAAQ,EAAC,MAAM,EAAE,CAAC;IAAA,YAAY,EAAC,MAAM,CAAC,MAAM,EAAC,MAAM,CAAC,CAAC;IAAA,oBAAoB,EAAC,OAAO,CAAC;IAAA,mBAAmB,EAAC,MAAM,EAAE,CAAC;IAAA,kBAAkB,EAAC,OAAO,CAAC;IAAA,SAAS,EAAC,MAAM,CAAC;IAAA,WAAW,EAAC,MAAM,CAAC;IAAA,YAAY,EAAC,MAAM,CAAC;IAAA,SAAS,CAAC,EAAC,MAAM,CAAA;CAAC;AACttB,MAAM,WAAW,iBAAiB;IAAC,QAAQ,EAAC,gBAAgB,CAAC;IAAA,MAAM,EAAC,cAAc,CAAC;IAAA,YAAY,EAAC,MAAM,CAAC;IAAA,eAAe,EAAC,MAAM,EAAE,CAAC;IAAA,oBAAoB,EAAC,MAAM,EAAE,CAAC;IAAA,oBAAoB,EAAC,MAAM,EAAE,CAAC;IAAA,sBAAsB,CAAC,EAAC,MAAM,CAAC;IAAA,MAAM,EAAC;QAAC,MAAM,EAAC,MAAM,CAAC;QAAA,KAAK,EAAC,OAAO,CAAC;QAAA,OAAO,EAAC,MAAM,CAAC;QAAA,eAAe,CAAC,EAAC,MAAM,CAAC;QAAA,YAAY,CAAC,EAAC,MAAM,CAAA;KAAC,CAAA;CAAC;AAC5T,qBAAa,cAAc;IAAa,OAAO,CAAC,OAAO;IAAI,OAAO,CAAC,OAAO;gBAA1B,OAAO,SAAG,EAAS,OAAO,GAAC,OAAO,KAAW;YAAiB,IAAI;IAAgS,IAAI;mBAA+B,iBAAiB,EAAE;;IAAoB,OAAO,CAAC,EAAE,EAAC,MAAM;IAAiF,OAAO,CAAC,QAAQ,EAAC,gBAAgB,EAAC,QAAQ,CAAC,EAAC,MAAM,EAAC,aAAa,CAAC,EAAC,MAAM;IAAuJ,MAAM,CAAC,EAAE,EAAC,MAAM;IAAmC,OAAO,CAAC,EAAE,EAAC,MAAM;IAAoC,MAAM,CAAC,EAAE,EAAC,MAAM;IAAmC,MAAM,CAAC,EAAE,EAAC,MAAM,EAAC,MAAM,EAAC,cAAc;IAAsI,MAAM,CAAC,EAAE,EAAC,MAAM;gBAD14B,MAAM;eAAO,OAAO;iBAAS,MAAM;0BAAkB,MAAM;uBAAe,MAAM;;IAC45B,YAAY,CAAC,EAAE,EAAC,MAAM;CAAmG"}

package/dist/provider.js

@@ -0,0 +1,17 @@
+export class ProviderClient {
+    constructor(baseUrl = '', fetcher = fetch) {
+        this.baseUrl = baseUrl;
+        this.fetcher = fetcher;
+    }
+    async json(path, init) { const r = await this.fetcher(`${this.baseUrl}${path}`, { credentials: 'include', headers: { 'content-type': 'application/json' }, ...init }); const v = await r.json(); if (!r.ok)
+        throw new Error(v?.error || `Provider request failed (${r.status})`); return v; }
+    list() { return this.json('/v1/providers'); }
+    inspect(id) { return this.json(`/v1/providers/${encodeURIComponent(id)}`); }
+    install(manifest, tenantId, applicationId) { return this.json('/v1/providers', { method: 'POST', body: JSON.stringify({ manifest, tenant_id: tenantId, application_id: applicationId }) }); }
+    enable(id) { return this.status(id, 'ENABLED'); }
+    disable(id) { return this.status(id, 'DISABLED'); }
+    revoke(id) { return this.status(id, 'REVOKED'); }
+    status(id, status) { return this.json(`/v1/providers/${encodeURIComponent(id)}/status`, { method: 'POST', body: JSON.stringify({ status }) }); }
+    health(id) { return this.json(`/v1/providers/${encodeURIComponent(id)}/health`); }
+    dependencies(id) { return this.json(`/v1/providers/${encodeURIComponent(id)}/dependencies`); }
+}

package/dist/query-planner.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Query Planner - Cost-Based Index Selection
+ *
+ * Analyzes queries and selects the optimal index to use.
+ * Uses cardinality estimation and index statistics to minimize query cost.
+ */
+import type { IndexConfig } from './index-types.js';
+export interface QueryPredicate {
+    field: string;
+    operator: 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'range' | 'contains' | 'startsWith';
+    value?: any;
+    values?: any[];
+}
+export interface IndexScoreboard {
+    indexName: string;
+    indexType: string;
+    fields: string[];
+    score: number;
+    coverage: number;
+    estimatedRows: number;
+    cost: number;
+}
+export declare class QueryPlanner {
+    /**
+     * Analyze a predicate and select the best index.
+     */
+    static planQuery(predicates: QueryPredicate[], indexes: IndexConfig[]): IndexScoreboard | null;
+    /**
+     * Score how well an index covers the given predicates.
+     */
+    private static scoreIndex;
+    /**
+     * Explain the query plan (for debugging).
+     */
+    static explainPlan(predicates: QueryPredicate[], indexes: IndexConfig[], selectedIndex?: IndexScoreboard): string;
+}
+/**
+ * Compound query builder for multi-field searches.
+ */
+export declare class CompoundQuery {
+    private predicates;
+    private fields;
+    /**
+     * Add a predicate for a field.
+     */
+    addPredicate(field: string, operator: QueryPredicate['operator'], value: any): this;
+    /**
+     * Get all predicates.
+     */
+    getPredicates(): QueryPredicate[];
+    /**
+     * Get fields involved in this query.
+     */
+    getFields(): string[];
+    /**
+     * Find best index for this compound query.
+     */
+    planWith(indexes: IndexConfig[]): IndexScoreboard | null;
+}
+/**
+ * Index recommendation engine - suggests indexes to create.
+ */
+export declare class IndexRecommender {
+    /**
+     * Analyze query patterns and recommend indexes.
+     */
+    static recommendIndexes(queries: QueryPredicate[][]): IndexConfig[];
+}
+//# sourceMappingURL=query-planner.d.ts.map

package/dist/query-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-planner.d.ts","sourceRoot":"","sources":["../src/query-planner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,CAAC;IAC1F,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,SAAS,CACd,UAAU,EAAE,cAAc,EAAE,EAC5B,OAAO,EAAE,WAAW,EAAE,GACrB,eAAe,GAAG,IAAI;IAazB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IA0DzB;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,UAAU,EAAE,cAAc,EAAE,EAC5B,OAAO,EAAE,WAAW,EAAE,EACtB,aAAa,CAAC,EAAE,eAAe,GAC9B,MAAM;CAgBV;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAA0C;IAC5D,OAAO,CAAC,MAAM,CAAgB;IAE9B;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAQnF;;OAEG;IACH,aAAa,IAAI,cAAc,EAAE;IAIjC;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,eAAe,GAAG,IAAI;CAGzD;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,GAAG,WAAW,EAAE;CAgEpE"}