@almadar/server 2.0.2 → 2.0.4

package/dist/contracts.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Server Service Contracts
+ *
+ * Type-safe contract definitions for the three main services
+ * callable from .orb schemas via `["call-service", ...]`.
+ *
+ * Each contract maps action names to their params/result types,
+ * and the corresponding `ServiceContract<Actions>` type ensures
+ * the runtime `execute(action, params)` call is fully typed.
+ *
+ * @packageDocumentation
+ */
+import type { ServiceContract, ServiceEvents } from '@almadar/core';
+/** Actions available on the data service (CRUD over collections). */
+export type DataServiceActions = {
+    list: {
+        params: {
+            collection: string;
+        };
+        result: {
+            items: unknown[];
+        };
+    };
+    getById: {
+        params: {
+            collection: string;
+            id: string;
+        };
+        result: {
+            item: unknown | null;
+        };
+    };
+    create: {
+        params: {
+            collection: string;
+            data: Record<string, unknown>;
+        };
+        result: {
+            item: unknown;
+        };
+    };
+    update: {
+        params: {
+            collection: string;
+            id: string;
+            data: Record<string, unknown>;
+        };
+        result: {
+            item: unknown | null;
+        };
+    };
+    delete: {
+        params: {
+            collection: string;
+            id: string;
+        };
+        result: {
+            deleted: boolean;
+        };
+    };
+};
+/** Typed contract for the data service. */
+export type DataServiceContract = ServiceContract<DataServiceActions>;
+/** Actions available on the event bus service. */
+export type EventBusActions = {
+    emit: {
+        params: {
+            event: string;
+            payload?: unknown;
+        };
+        result: {
+            delivered: number;
+        };
+    };
+    getListenerCounts: {
+        params: Record<string, never>;
+        result: {
+            counts: Record<string, number>;
+        };
+    };
+};
+/** Typed contract for the event bus service. */
+export type EventBusServiceContract = ServiceContract<EventBusActions>;
+/** Shape of a discovered service instance. */
+interface DiscoveredService {
+    name: string;
+    instanceId: string;
+    host: string;
+    port: number;
+}
+/** Actions available on the service discovery service. */
+export type ServiceDiscoveryActions = {
+    register: {
+        params: {
+            name: string;
+            instanceId: string;
+            host: string;
+            port: number;
+            emits: string[];
+            listens: string[];
+        };
+        result: {
+            registered: boolean;
+        };
+    };
+    findListeners: {
+        params: {
+            event: string;
+        };
+        result: {
+            services: DiscoveredService[];
+        };
+    };
+    findEmitters: {
+        params: {
+            event: string;
+        };
+        result: {
+            services: DiscoveredService[];
+        };
+    };
+};
+/** Typed contract for the service discovery service. */
+export type ServiceDiscoveryContract = ServiceContract<ServiceDiscoveryActions>;
+/** Events emitted by entity CRUD operations. */
+export type EntityCrudEventMap = {
+    [K in `${string}_CREATED`]: Record<string, unknown>;
+} & {
+    [K in `${string}_UPDATED`]: Record<string, unknown>;
+} & {
+    [K in `${string}_DELETED`]: Record<string, unknown>;
+};
+/** Events emitted/consumed by the server infrastructure. */
+export type ServerEventMap = {
+    /** Emitted when a service instance registers with ServiceDiscovery. */
+    SERVICE_REGISTERED: {
+        name: string;
+        instanceId: string;
+        host: string;
+        port: number;
+    };
+    /** Emitted when a service instance deregisters or expires. */
+    SERVICE_DEREGISTERED: {
+        name: string;
+        instanceId: string;
+        reason: 'explicit' | 'expired';
+    };
+    /** Emitted when a service health check fails. */
+    SERVICE_HEALTH_FAILED: {
+        name: string;
+        instanceId: string;
+        error: string;
+    };
+    /** Emitted when the distributed event bus connects. */
+    TRANSPORT_CONNECTED: {
+        instanceId: string;
+        transport: string;
+    };
+    /** Emitted when the distributed event bus disconnects. */
+    TRANSPORT_DISCONNECTED: {
+        instanceId: string;
+        reason: string;
+    };
+};
+/** Typed event emitter for server events. */
+export type ServerServiceEvents = ServiceEvents<ServerEventMap>;
+/** All server service contracts keyed by service name. */
+export type ServerServiceContracts = {
+    data: DataServiceContract;
+    eventBus: EventBusServiceContract;
+    serviceDiscovery: ServiceDiscoveryContract;
+};
+export {};
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"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"}

package/dist/deepagent/memory.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/db.ts","../../src/deepagent/memory.ts"],"names":[],"mappings":";;;;AAoFA,SAAS,MAAA,GAAwB;AAC/B,EAAA,IAAI,KAAA,CAAM,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG;AAC3B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACA,EAAA,OAAO,MAAM,GAAA,EAAI;AACnB;AAKO,SAAS,YAAA,GAA0C;AACxD,EAAA,OAAO,MAAA,GAAS,SAAA,EAAU;AAC5B;AAgBO,IAAM,EAAA,GAAK,IAAI,KAAA,CAAM,EAAC,EAAgC;AAAA,EAC3D,GAAA,CAAI,OAAA,EAAS,IAAA,EAAM,QAAA,EAAU;AAC3B,IAAA,MAAM,YAAY,YAAA,EAAa;AAC/B,IAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,GAAA,CAAI,SAAA,EAAW,MAAM,QAAQ,CAAA;AACnD,IAAA,OAAO,OAAO,KAAA,KAAU,UAAA,GAAa,KAAA,CAAM,IAAA,CAAK,SAAS,CAAA,GAAI,KAAA;AAAA,EAC/D;AACF,CAAC,CAAA;;;AC9GD,IAAI,aAAA,GAAsC,IAAA;AAKnC,SAAS,gBAAA,GAAkC;AAChD,EAAA,IAAI,CAAC,aAAA,EAAe;AAClB,IAAA,aAAA,GAAgB,IAAI,aAAA,CAAc;AAAA,MAChC,EAAA;AAAA,MACA,eAAA,EAAiB,oBAAA;AAAA,MACjB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,qBAAA,EAAuB,0BAAA;AAAA,MACvB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,oBAAA,EAAsB,yBAAA;AAAA,MACtB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,qBAAA,EAAuB,0BAAA;AAAA,MACvB,yBAAA,EAA2B;AAAA,KAC5B,CAAA;AAAA,EACH;AACA,EAAA,OAAO,aAAA;AACT;AAKO,SAAS,kBAAA,GAA2B;AACzC,EAAA,aAAA,GAAgB,IAAA;AAClB","file":"memory.js","sourcesContent":["/**\n * Database Accessors & Initialization\n *\n * This module provides:\n * - `initializeFirebase()` — convenience function to init Firebase from env vars\n * - `getFirestore()`, `getAuth()` — accessors for Firebase services\n * - `db` — lazy Firestore proxy (no eager initialization)\n *\n * The consuming application MUST call `initializeFirebase()` or\n * `admin.initializeApp()` before using any Firebase-dependent features.\n */\n\nimport admin from 'firebase-admin';\n\n/**\n * Initialize Firebase Admin SDK from environment variables.\n *\n * Reads: FIREBASE_PROJECT_ID, FIREBASE_CLIENT_EMAIL, FIREBASE_PRIVATE_KEY,\n *        FIREBASE_SERVICE_ACCOUNT_PATH, FIRESTORE_EMULATOR_HOST\n *\n * Safe to call multiple times — returns existing app if already initialized.\n */\nexport function initializeFirebase(): admin.app.App {\n  // Already initialized — return existing app\n  if (admin.apps.length > 0) {\n    return admin.app();\n  }\n\n  const projectId = process.env.FIREBASE_PROJECT_ID;\n  const emulatorHost = process.env.FIRESTORE_EMULATOR_HOST;\n\n  // Emulator mode — no credentials needed\n  if (emulatorHost) {\n    const app = admin.initializeApp({\n      projectId: projectId || 'demo-project',\n    });\n    console.log(`Firebase Admin initialized for emulator: ${emulatorHost}`);\n    return app;\n  }\n\n  // Service account file\n  const serviceAccountPath = process.env.FIREBASE_SERVICE_ACCOUNT_PATH;\n  if (serviceAccountPath) {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const serviceAccount = require(serviceAccountPath);\n    return admin.initializeApp({\n      credential: admin.credential.cert(serviceAccount),\n      projectId,\n    });\n  }\n\n  // Inline credentials\n  const clientEmail = process.env.FIREBASE_CLIENT_EMAIL;\n  const privateKey = process.env.FIREBASE_PRIVATE_KEY;\n  if (projectId && clientEmail && privateKey) {\n    return admin.initializeApp({\n      credential: admin.credential.cert({\n        projectId,\n        clientEmail,\n        privateKey: privateKey.replace(/\\\\n/g, '\\n'),\n      }),\n      projectId,\n    });\n  }\n\n  // Application default credentials (Cloud Run, etc.)\n  if (projectId) {\n    return admin.initializeApp({\n      credential: admin.credential.applicationDefault(),\n      projectId,\n    });\n  }\n\n  throw new Error(\n    '@almadar/server: Cannot initialize Firebase — no credentials found. ' +\n    'Set FIREBASE_PROJECT_ID + FIREBASE_CLIENT_EMAIL + FIREBASE_PRIVATE_KEY, ' +\n    'or FIREBASE_SERVICE_ACCOUNT_PATH, or FIRESTORE_EMULATOR_HOST.'\n  );\n}\n\n/**\n * Get the initialized Firebase app.\n * Throws if Firebase Admin SDK has not been initialized.\n */\nfunction getApp(): admin.app.App {\n  if (admin.apps.length === 0) {\n    throw new Error(\n      '@almadar/server: Firebase Admin SDK is not initialized. ' +\n      'Call initializeFirebase() or admin.initializeApp() before using @almadar/server.'\n    );\n  }\n  return admin.app();\n}\n\n/**\n * Get Firestore instance from the pre-initialized Firebase app.\n */\nexport function getFirestore(): admin.firestore.Firestore {\n  return getApp().firestore();\n}\n\n/**\n * Get Firebase Auth instance from the pre-initialized Firebase app.\n */\nexport function getAuth(): admin.auth.Auth {\n  return getApp().auth();\n}\n\n// Re-export admin for convenience\nexport { admin };\n\n/**\n * Lazy Firestore proxy — resolves on first property access, not at import time.\n * This prevents the \"Firebase not initialized\" error during module loading.\n */\nexport const db = new Proxy({} as admin.firestore.Firestore, {\n  get(_target, prop, receiver) {\n    const firestore = getFirestore();\n    const value = Reflect.get(firestore, prop, receiver);\n    return typeof value === 'function' ? value.bind(firestore) : value;\n  },\n});\n","/**\n * Memory Manager Singleton\n *\n * Provides Firestore-backed memory management for DeepAgent.\n *\n * @packageDocumentation\n */\n\nimport { MemoryManager } from '@almadar/agent';\nimport { db } from '../lib/db.js';\n\nlet memoryManager: MemoryManager | null = null;\n\n/**\n * Get or create the MemoryManager singleton\n */\nexport function getMemoryManager(): MemoryManager {\n  if (!memoryManager) {\n    memoryManager = new MemoryManager({\n      db,\n      usersCollection: 'agent_memory_users',\n      projectsCollection: 'agent_memory_projects',\n      generationsCollection: 'agent_memory_generations',\n      patternsCollection: 'agent_memory_patterns',\n      interruptsCollection: 'agent_memory_interrupts',\n      feedbackCollection: 'agent_memory_feedback',\n      checkpointsCollection: 'agent_memory_checkpoints',\n      toolPreferencesCollection: 'agent_memory_tool_preferences',\n    });\n  }\n  return memoryManager;\n}\n\n/**\n * Reset the MemoryManager (useful for testing)\n */\nexport function resetMemoryManager(): void {\n  memoryManager = null;\n}\n"]}
+{"version":3,"sources":["../../src/lib/db.ts","../../src/deepagent/memory.ts"],"names":[],"mappings":";;;;AAoFA,SAAS,MAAA,GAAwB;AAC/B,EAAA,IAAI,KAAA,CAAM,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG;AAC3B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACA,EAAA,OAAO,MAAM,GAAA,EAAI;AACnB;AAKO,SAAS,YAAA,GAA0C;AACxD,EAAA,OAAO,MAAA,GAAS,SAAA,EAAU;AAC5B;AAgBO,IAAM,EAAA,GAAK,IAAI,KAAA,CAAM,EAAC,EAAgC;AAAA,EAC3D,GAAA,CAAI,OAAA,EAAS,IAAA,EAAM,QAAA,EAAU;AAC3B,IAAA,MAAM,YAAY,YAAA,EAAa;AAC/B,IAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,GAAA,CAAI,SAAA,EAAW,MAAM,QAAQ,CAAA;AACnD,IAAA,OAAO,OAAO,KAAA,KAAU,UAAA,GAAa,KAAA,CAAM,IAAA,CAAK,SAAS,CAAA,GAAI,KAAA;AAAA,EAC/D;AACF,CAAC,CAAA;;;AC9GD,IAAI,aAAA,GAAsC,IAAA;AAKnC,SAAS,gBAAA,GAAkC;AAChD,EAAA,IAAI,CAAC,aAAA,EAAe;AAClB,IAAA,aAAA,GAAgB,IAAI,aAAA,CAAc;AAAA,MAChC,EAAA;AAAA,MACA,eAAA,EAAiB,oBAAA;AAAA,MACjB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,qBAAA,EAAuB,0BAAA;AAAA,MACvB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,oBAAA,EAAsB,yBAAA;AAAA,MACtB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,qBAAA,EAAuB,0BAAA;AAAA,MACvB,yBAAA,EAA2B;AAAA,KAC5B,CAAA;AAAA,EACH;AACA,EAAA,OAAO,aAAA;AACT;AAKO,SAAS,kBAAA,GAA2B;AACzC,EAAA,aAAA,GAAgB,IAAA;AAClB","file":"memory.js","sourcesContent":["/**\n * Database Accessors & Initialization\n *\n * This module provides:\n * - `initializeFirebase()` — convenience function to init Firebase from env vars\n * - `getFirestore()`, `getAuth()` — accessors for Firebase services\n * - `db` — lazy Firestore proxy (no eager initialization)\n *\n * The consuming application MUST call `initializeFirebase()` or\n * `admin.initializeApp()` before using any Firebase-dependent features.\n */\n\nimport admin from 'firebase-admin';\n\n/**\n * Initialize Firebase Admin SDK from environment variables.\n *\n * Reads: FIREBASE_PROJECT_ID, FIREBASE_CLIENT_EMAIL, FIREBASE_PRIVATE_KEY,\n *        FIREBASE_SERVICE_ACCOUNT_PATH, FIRESTORE_EMULATOR_HOST\n *\n * Safe to call multiple times — returns existing app if already initialized.\n */\nexport function initializeFirebase(): admin.app.App {\n  // Already initialized — return existing app\n  if (admin.apps.length > 0) {\n    return admin.app();\n  }\n\n  const projectId = process.env.FIREBASE_PROJECT_ID;\n  const emulatorHost = process.env.FIRESTORE_EMULATOR_HOST;\n\n  // Emulator mode — no credentials needed\n  if (emulatorHost) {\n    const app = admin.initializeApp({\n      projectId: projectId || 'demo-project',\n    });\n    console.log(`Firebase Admin initialized for emulator: ${emulatorHost}`);\n    return app;\n  }\n\n  // Service account file\n  const serviceAccountPath = process.env.FIREBASE_SERVICE_ACCOUNT_PATH;\n  if (serviceAccountPath) {\n    // Dynamic require for JSON service account file at runtime\n    const serviceAccount = require(serviceAccountPath) as Record<string, unknown>;\n    return admin.initializeApp({\n      credential: admin.credential.cert(serviceAccount),\n      projectId,\n    });\n  }\n\n  // Inline credentials\n  const clientEmail = process.env.FIREBASE_CLIENT_EMAIL;\n  const privateKey = process.env.FIREBASE_PRIVATE_KEY;\n  if (projectId && clientEmail && privateKey) {\n    return admin.initializeApp({\n      credential: admin.credential.cert({\n        projectId,\n        clientEmail,\n        privateKey: privateKey.replace(/\\\\n/g, '\\n'),\n      }),\n      projectId,\n    });\n  }\n\n  // Application default credentials (Cloud Run, etc.)\n  if (projectId) {\n    return admin.initializeApp({\n      credential: admin.credential.applicationDefault(),\n      projectId,\n    });\n  }\n\n  throw new Error(\n    '@almadar/server: Cannot initialize Firebase — no credentials found. ' +\n    'Set FIREBASE_PROJECT_ID + FIREBASE_CLIENT_EMAIL + FIREBASE_PRIVATE_KEY, ' +\n    'or FIREBASE_SERVICE_ACCOUNT_PATH, or FIRESTORE_EMULATOR_HOST.'\n  );\n}\n\n/**\n * Get the initialized Firebase app.\n * Throws if Firebase Admin SDK has not been initialized.\n */\nfunction getApp(): admin.app.App {\n  if (admin.apps.length === 0) {\n    throw new Error(\n      '@almadar/server: Firebase Admin SDK is not initialized. ' +\n      'Call initializeFirebase() or admin.initializeApp() before using @almadar/server.'\n    );\n  }\n  return admin.app();\n}\n\n/**\n * Get Firestore instance from the pre-initialized Firebase app.\n */\nexport function getFirestore(): admin.firestore.Firestore {\n  return getApp().firestore();\n}\n\n/**\n * Get Firebase Auth instance from the pre-initialized Firebase app.\n */\nexport function getAuth(): admin.auth.Auth {\n  return getApp().auth();\n}\n\n// Re-export admin for convenience\nexport { admin };\n\n/**\n * Lazy Firestore proxy — resolves on first property access, not at import time.\n * This prevents the \"Firebase not initialized\" error during module loading.\n */\nexport const db = new Proxy({} as admin.firestore.Firestore, {\n  get(_target, prop, receiver) {\n    const firestore = getFirestore();\n    const value = Reflect.get(firestore, prop, receiver);\n    return typeof value === 'function' ? value.bind(firestore) : value;\n  },\n});\n","/**\n * Memory Manager Singleton\n *\n * Provides Firestore-backed memory management for DeepAgent.\n *\n * @packageDocumentation\n */\n\nimport { MemoryManager } from '@almadar/agent';\nimport { db } from '../lib/db.js';\n\nlet memoryManager: MemoryManager | null = null;\n\n/**\n * Get or create the MemoryManager singleton\n */\nexport function getMemoryManager(): MemoryManager {\n  if (!memoryManager) {\n    memoryManager = new MemoryManager({\n      db,\n      usersCollection: 'agent_memory_users',\n      projectsCollection: 'agent_memory_projects',\n      generationsCollection: 'agent_memory_generations',\n      patternsCollection: 'agent_memory_patterns',\n      interruptsCollection: 'agent_memory_interrupts',\n      feedbackCollection: 'agent_memory_feedback',\n      checkpointsCollection: 'agent_memory_checkpoints',\n      toolPreferencesCollection: 'agent_memory_tool_preferences',\n    });\n  }\n  return memoryManager;\n}\n\n/**\n * Reset the MemoryManager (useful for testing)\n */\nexport function resetMemoryManager(): void {\n  memoryManager = null;\n}\n"]}

package/dist/deepagent/session.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/db.ts","../../src/deepagent/memory.ts","../../src/deepagent/session.ts"],"names":[],"mappings":";;;;AAoFA,SAAS,MAAA,GAAwB;AAC/B,EAAA,IAAI,KAAA,CAAM,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG;AAC3B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACA,EAAA,OAAO,MAAM,GAAA,EAAI;AACnB;AAKO,SAAS,YAAA,GAA0C;AACxD,EAAA,OAAO,MAAA,GAAS,SAAA,EAAU;AAC5B;AAgBO,IAAM,EAAA,GAAK,IAAI,KAAA,CAAM,EAAC,EAAgC;AAAA,EAC3D,GAAA,CAAI,OAAA,EAAS,IAAA,EAAM,QAAA,EAAU;AAC3B,IAAA,MAAM,YAAY,YAAA,EAAa;AAC/B,IAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,GAAA,CAAI,SAAA,EAAW,MAAM,QAAQ,CAAA;AACnD,IAAA,OAAO,OAAO,KAAA,KAAU,UAAA,GAAa,KAAA,CAAM,IAAA,CAAK,SAAS,CAAA,GAAI,KAAA;AAAA,EAC/D;AACF,CAAC,CAAA;AC9GD,IAAI,aAAA,GAAsC,IAAA;AAKnC,SAAS,gBAAA,GAAkC;AAChD,EAAA,IAAI,CAAC,aAAA,EAAe;AAClB,IAAA,aAAA,GAAgB,IAAI,aAAA,CAAc;AAAA,MAChC,EAAA;AAAA,MACA,eAAA,EAAiB,oBAAA;AAAA,MACjB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,qBAAA,EAAuB,0BAAA;AAAA,MACvB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,oBAAA,EAAsB,yBAAA;AAAA,MACtB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,qBAAA,EAAuB,0BAAA;AAAA,MACvB,yBAAA,EAA2B;AAAA,KAC5B,CAAA;AAAA,EACH;AACA,EAAA,OAAO,aAAA;AACT;;;AClBA,IAAI,cAAA,GAAwC,IAAA;AAK5C,SAAS,uBAAuB,SAAA,EAAmC;AACjE,EAAA,OAAO,SAAA;AACT;AAKO,SAAS,iBAAA,GAAoC;AAClD,EAAA,IAAI,CAAC,cAAA,EAAgB;AACnB,IAAA,cAAA,GAAiB,IAAI,cAAA,CAAe;AAAA,MAClC,IAAA,EAAM,WAAA;AAAA,MACN,WAAA,EAAa,uBAAuB,EAAE,CAAA;AAAA,MACtC,eAAe,gBAAA,EAAiB;AAAA;AAAA,MAChC,gBAAA,EAAkB;AAAA,QAChB,SAAA,EAAW,IAAA;AAAA,QACX,kBAAA,EAAoB,EAAA;AAAA,QACpB,QAAA,EAAU;AAAA;AACZ,KACD,CAAA;AAAA,EACH;AACA,EAAA,OAAO,cAAA;AACT;AAKO,SAAS,mBAAA,GAA4B;AAC1C,EAAA,cAAA,GAAiB,IAAA;AACnB","file":"session.js","sourcesContent":["/**\n * Database Accessors & Initialization\n *\n * This module provides:\n * - `initializeFirebase()` — convenience function to init Firebase from env vars\n * - `getFirestore()`, `getAuth()` — accessors for Firebase services\n * - `db` — lazy Firestore proxy (no eager initialization)\n *\n * The consuming application MUST call `initializeFirebase()` or\n * `admin.initializeApp()` before using any Firebase-dependent features.\n */\n\nimport admin from 'firebase-admin';\n\n/**\n * Initialize Firebase Admin SDK from environment variables.\n *\n * Reads: FIREBASE_PROJECT_ID, FIREBASE_CLIENT_EMAIL, FIREBASE_PRIVATE_KEY,\n *        FIREBASE_SERVICE_ACCOUNT_PATH, FIRESTORE_EMULATOR_HOST\n *\n * Safe to call multiple times — returns existing app if already initialized.\n */\nexport function initializeFirebase(): admin.app.App {\n  // Already initialized — return existing app\n  if (admin.apps.length > 0) {\n    return admin.app();\n  }\n\n  const projectId = process.env.FIREBASE_PROJECT_ID;\n  const emulatorHost = process.env.FIRESTORE_EMULATOR_HOST;\n\n  // Emulator mode — no credentials needed\n  if (emulatorHost) {\n    const app = admin.initializeApp({\n      projectId: projectId || 'demo-project',\n    });\n    console.log(`Firebase Admin initialized for emulator: ${emulatorHost}`);\n    return app;\n  }\n\n  // Service account file\n  const serviceAccountPath = process.env.FIREBASE_SERVICE_ACCOUNT_PATH;\n  if (serviceAccountPath) {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const serviceAccount = require(serviceAccountPath);\n    return admin.initializeApp({\n      credential: admin.credential.cert(serviceAccount),\n      projectId,\n    });\n  }\n\n  // Inline credentials\n  const clientEmail = process.env.FIREBASE_CLIENT_EMAIL;\n  const privateKey = process.env.FIREBASE_PRIVATE_KEY;\n  if (projectId && clientEmail && privateKey) {\n    return admin.initializeApp({\n      credential: admin.credential.cert({\n        projectId,\n        clientEmail,\n        privateKey: privateKey.replace(/\\\\n/g, '\\n'),\n      }),\n      projectId,\n    });\n  }\n\n  // Application default credentials (Cloud Run, etc.)\n  if (projectId) {\n    return admin.initializeApp({\n      credential: admin.credential.applicationDefault(),\n      projectId,\n    });\n  }\n\n  throw new Error(\n    '@almadar/server: Cannot initialize Firebase — no credentials found. ' +\n    'Set FIREBASE_PROJECT_ID + FIREBASE_CLIENT_EMAIL + FIREBASE_PRIVATE_KEY, ' +\n    'or FIREBASE_SERVICE_ACCOUNT_PATH, or FIRESTORE_EMULATOR_HOST.'\n  );\n}\n\n/**\n * Get the initialized Firebase app.\n * Throws if Firebase Admin SDK has not been initialized.\n */\nfunction getApp(): admin.app.App {\n  if (admin.apps.length === 0) {\n    throw new Error(\n      '@almadar/server: Firebase Admin SDK is not initialized. ' +\n      'Call initializeFirebase() or admin.initializeApp() before using @almadar/server.'\n    );\n  }\n  return admin.app();\n}\n\n/**\n * Get Firestore instance from the pre-initialized Firebase app.\n */\nexport function getFirestore(): admin.firestore.Firestore {\n  return getApp().firestore();\n}\n\n/**\n * Get Firebase Auth instance from the pre-initialized Firebase app.\n */\nexport function getAuth(): admin.auth.Auth {\n  return getApp().auth();\n}\n\n// Re-export admin for convenience\nexport { admin };\n\n/**\n * Lazy Firestore proxy — resolves on first property access, not at import time.\n * This prevents the \"Firebase not initialized\" error during module loading.\n */\nexport const db = new Proxy({} as admin.firestore.Firestore, {\n  get(_target, prop, receiver) {\n    const firestore = getFirestore();\n    const value = Reflect.get(firestore, prop, receiver);\n    return typeof value === 'function' ? value.bind(firestore) : value;\n  },\n});\n","/**\n * Memory Manager Singleton\n *\n * Provides Firestore-backed memory management for DeepAgent.\n *\n * @packageDocumentation\n */\n\nimport { MemoryManager } from '@almadar/agent';\nimport { db } from '../lib/db.js';\n\nlet memoryManager: MemoryManager | null = null;\n\n/**\n * Get or create the MemoryManager singleton\n */\nexport function getMemoryManager(): MemoryManager {\n  if (!memoryManager) {\n    memoryManager = new MemoryManager({\n      db,\n      usersCollection: 'agent_memory_users',\n      projectsCollection: 'agent_memory_projects',\n      generationsCollection: 'agent_memory_generations',\n      patternsCollection: 'agent_memory_patterns',\n      interruptsCollection: 'agent_memory_interrupts',\n      feedbackCollection: 'agent_memory_feedback',\n      checkpointsCollection: 'agent_memory_checkpoints',\n      toolPreferencesCollection: 'agent_memory_tool_preferences',\n    });\n  }\n  return memoryManager;\n}\n\n/**\n * Reset the MemoryManager (useful for testing)\n */\nexport function resetMemoryManager(): void {\n  memoryManager = null;\n}\n","/**\n * Session Manager Singleton\n *\n * Provides Firestore-backed session management with full GAP features.\n *\n * @packageDocumentation\n */\n\nimport { SessionManager } from '@almadar/agent';\nimport { db } from '../lib/db.js';\nimport { getMemoryManager } from './memory.js';\nimport type { FirestoreDb } from '@almadar/agent';\n\nlet sessionManager: SessionManager | null = null;\n\n/**\n * Adapter to make Firebase Firestore compatible with @almadar/agent FirestoreDb interface\n */\nfunction createFirestoreAdapter(firestore: typeof db): FirestoreDb {\n  return firestore as unknown as FirestoreDb;\n}\n\n/**\n * Get or create the SessionManager singleton\n */\nexport function getSessionManager(): SessionManager {\n  if (!sessionManager) {\n    sessionManager = new SessionManager({\n      mode: 'firestore',\n      firestoreDb: createFirestoreAdapter(db),\n      memoryManager: getMemoryManager(), // Enable GAP-002D\n      compactionConfig: {\n        maxTokens: 150000,\n        keepRecentMessages: 10,\n        strategy: 'last',\n      },\n    });\n  }\n  return sessionManager;\n}\n\n/**\n * Reset the SessionManager (useful for testing)\n */\nexport function resetSessionManager(): void {\n  sessionManager = null;\n}\n"]}
+{"version":3,"sources":["../../src/lib/db.ts","../../src/deepagent/memory.ts","../../src/deepagent/session.ts"],"names":[],"mappings":";;;;AAoFA,SAAS,MAAA,GAAwB;AAC/B,EAAA,IAAI,KAAA,CAAM,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG;AAC3B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACA,EAAA,OAAO,MAAM,GAAA,EAAI;AACnB;AAKO,SAAS,YAAA,GAA0C;AACxD,EAAA,OAAO,MAAA,GAAS,SAAA,EAAU;AAC5B;AAgBO,IAAM,EAAA,GAAK,IAAI,KAAA,CAAM,EAAC,EAAgC;AAAA,EAC3D,GAAA,CAAI,OAAA,EAAS,IAAA,EAAM,QAAA,EAAU;AAC3B,IAAA,MAAM,YAAY,YAAA,EAAa;AAC/B,IAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,GAAA,CAAI,SAAA,EAAW,MAAM,QAAQ,CAAA;AACnD,IAAA,OAAO,OAAO,KAAA,KAAU,UAAA,GAAa,KAAA,CAAM,IAAA,CAAK,SAAS,CAAA,GAAI,KAAA;AAAA,EAC/D;AACF,CAAC,CAAA;AC9GD,IAAI,aAAA,GAAsC,IAAA;AAKnC,SAAS,gBAAA,GAAkC;AAChD,EAAA,IAAI,CAAC,aAAA,EAAe;AAClB,IAAA,aAAA,GAAgB,IAAI,aAAA,CAAc;AAAA,MAChC,EAAA;AAAA,MACA,eAAA,EAAiB,oBAAA;AAAA,MACjB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,qBAAA,EAAuB,0BAAA;AAAA,MACvB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,oBAAA,EAAsB,yBAAA;AAAA,MACtB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,qBAAA,EAAuB,0BAAA;AAAA,MACvB,yBAAA,EAA2B;AAAA,KAC5B,CAAA;AAAA,EACH;AACA,EAAA,OAAO,aAAA;AACT;;;AClBA,IAAI,cAAA,GAAwC,IAAA;AAK5C,SAAS,uBAAuB,SAAA,EAAmC;AACjE,EAAA,OAAO,SAAA;AACT;AAKO,SAAS,iBAAA,GAAoC;AAClD,EAAA,IAAI,CAAC,cAAA,EAAgB;AACnB,IAAA,cAAA,GAAiB,IAAI,cAAA,CAAe;AAAA,MAClC,IAAA,EAAM,WAAA;AAAA,MACN,WAAA,EAAa,uBAAuB,EAAE,CAAA;AAAA,MACtC,eAAe,gBAAA,EAAiB;AAAA;AAAA,MAChC,gBAAA,EAAkB;AAAA,QAChB,SAAA,EAAW,IAAA;AAAA,QACX,kBAAA,EAAoB,EAAA;AAAA,QACpB,QAAA,EAAU;AAAA;AACZ,KACD,CAAA;AAAA,EACH;AACA,EAAA,OAAO,cAAA;AACT;AAKO,SAAS,mBAAA,GAA4B;AAC1C,EAAA,cAAA,GAAiB,IAAA;AACnB","file":"session.js","sourcesContent":["/**\n * Database Accessors & Initialization\n *\n * This module provides:\n * - `initializeFirebase()` — convenience function to init Firebase from env vars\n * - `getFirestore()`, `getAuth()` — accessors for Firebase services\n * - `db` — lazy Firestore proxy (no eager initialization)\n *\n * The consuming application MUST call `initializeFirebase()` or\n * `admin.initializeApp()` before using any Firebase-dependent features.\n */\n\nimport admin from 'firebase-admin';\n\n/**\n * Initialize Firebase Admin SDK from environment variables.\n *\n * Reads: FIREBASE_PROJECT_ID, FIREBASE_CLIENT_EMAIL, FIREBASE_PRIVATE_KEY,\n *        FIREBASE_SERVICE_ACCOUNT_PATH, FIRESTORE_EMULATOR_HOST\n *\n * Safe to call multiple times — returns existing app if already initialized.\n */\nexport function initializeFirebase(): admin.app.App {\n  // Already initialized — return existing app\n  if (admin.apps.length > 0) {\n    return admin.app();\n  }\n\n  const projectId = process.env.FIREBASE_PROJECT_ID;\n  const emulatorHost = process.env.FIRESTORE_EMULATOR_HOST;\n\n  // Emulator mode — no credentials needed\n  if (emulatorHost) {\n    const app = admin.initializeApp({\n      projectId: projectId || 'demo-project',\n    });\n    console.log(`Firebase Admin initialized for emulator: ${emulatorHost}`);\n    return app;\n  }\n\n  // Service account file\n  const serviceAccountPath = process.env.FIREBASE_SERVICE_ACCOUNT_PATH;\n  if (serviceAccountPath) {\n    // Dynamic require for JSON service account file at runtime\n    const serviceAccount = require(serviceAccountPath) as Record<string, unknown>;\n    return admin.initializeApp({\n      credential: admin.credential.cert(serviceAccount),\n      projectId,\n    });\n  }\n\n  // Inline credentials\n  const clientEmail = process.env.FIREBASE_CLIENT_EMAIL;\n  const privateKey = process.env.FIREBASE_PRIVATE_KEY;\n  if (projectId && clientEmail && privateKey) {\n    return admin.initializeApp({\n      credential: admin.credential.cert({\n        projectId,\n        clientEmail,\n        privateKey: privateKey.replace(/\\\\n/g, '\\n'),\n      }),\n      projectId,\n    });\n  }\n\n  // Application default credentials (Cloud Run, etc.)\n  if (projectId) {\n    return admin.initializeApp({\n      credential: admin.credential.applicationDefault(),\n      projectId,\n    });\n  }\n\n  throw new Error(\n    '@almadar/server: Cannot initialize Firebase — no credentials found. ' +\n    'Set FIREBASE_PROJECT_ID + FIREBASE_CLIENT_EMAIL + FIREBASE_PRIVATE_KEY, ' +\n    'or FIREBASE_SERVICE_ACCOUNT_PATH, or FIRESTORE_EMULATOR_HOST.'\n  );\n}\n\n/**\n * Get the initialized Firebase app.\n * Throws if Firebase Admin SDK has not been initialized.\n */\nfunction getApp(): admin.app.App {\n  if (admin.apps.length === 0) {\n    throw new Error(\n      '@almadar/server: Firebase Admin SDK is not initialized. ' +\n      'Call initializeFirebase() or admin.initializeApp() before using @almadar/server.'\n    );\n  }\n  return admin.app();\n}\n\n/**\n * Get Firestore instance from the pre-initialized Firebase app.\n */\nexport function getFirestore(): admin.firestore.Firestore {\n  return getApp().firestore();\n}\n\n/**\n * Get Firebase Auth instance from the pre-initialized Firebase app.\n */\nexport function getAuth(): admin.auth.Auth {\n  return getApp().auth();\n}\n\n// Re-export admin for convenience\nexport { admin };\n\n/**\n * Lazy Firestore proxy — resolves on first property access, not at import time.\n * This prevents the \"Firebase not initialized\" error during module loading.\n */\nexport const db = new Proxy({} as admin.firestore.Firestore, {\n  get(_target, prop, receiver) {\n    const firestore = getFirestore();\n    const value = Reflect.get(firestore, prop, receiver);\n    return typeof value === 'function' ? value.bind(firestore) : value;\n  },\n});\n","/**\n * Memory Manager Singleton\n *\n * Provides Firestore-backed memory management for DeepAgent.\n *\n * @packageDocumentation\n */\n\nimport { MemoryManager } from '@almadar/agent';\nimport { db } from '../lib/db.js';\n\nlet memoryManager: MemoryManager | null = null;\n\n/**\n * Get or create the MemoryManager singleton\n */\nexport function getMemoryManager(): MemoryManager {\n  if (!memoryManager) {\n    memoryManager = new MemoryManager({\n      db,\n      usersCollection: 'agent_memory_users',\n      projectsCollection: 'agent_memory_projects',\n      generationsCollection: 'agent_memory_generations',\n      patternsCollection: 'agent_memory_patterns',\n      interruptsCollection: 'agent_memory_interrupts',\n      feedbackCollection: 'agent_memory_feedback',\n      checkpointsCollection: 'agent_memory_checkpoints',\n      toolPreferencesCollection: 'agent_memory_tool_preferences',\n    });\n  }\n  return memoryManager;\n}\n\n/**\n * Reset the MemoryManager (useful for testing)\n */\nexport function resetMemoryManager(): void {\n  memoryManager = null;\n}\n","/**\n * Session Manager Singleton\n *\n * Provides Firestore-backed session management with full GAP features.\n *\n * @packageDocumentation\n */\n\nimport { SessionManager } from '@almadar/agent';\nimport { db } from '../lib/db.js';\nimport { getMemoryManager } from './memory.js';\nimport type { FirestoreDb } from '@almadar/agent';\n\nlet sessionManager: SessionManager | null = null;\n\n/**\n * Adapter to make Firebase Firestore compatible with @almadar/agent FirestoreDb interface\n */\nfunction createFirestoreAdapter(firestore: typeof db): FirestoreDb {\n  return firestore as unknown as FirestoreDb;\n}\n\n/**\n * Get or create the SessionManager singleton\n */\nexport function getSessionManager(): SessionManager {\n  if (!sessionManager) {\n    sessionManager = new SessionManager({\n      mode: 'firestore',\n      firestoreDb: createFirestoreAdapter(db),\n      memoryManager: getMemoryManager(), // Enable GAP-002D\n      compactionConfig: {\n        maxTokens: 150000,\n        keepRecentMessages: 10,\n        strategy: 'last',\n      },\n    });\n  }\n  return sessionManager;\n}\n\n/**\n * Reset the SessionManager (useful for testing)\n */\nexport function resetSessionManager(): void {\n  sessionManager = null;\n}\n"]}

package/dist/deepagent/skill-agent.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/db.ts","../../src/deepagent/memory.ts","../../src/deepagent/session.ts","../../src/deepagent/skill-agent.ts"],"names":["memoryManager"],"mappings":";;;;AAoFA,SAAS,MAAA,GAAwB;AAC/B,EAAA,IAAI,KAAA,CAAM,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG;AAC3B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACA,EAAA,OAAO,MAAM,GAAA,EAAI;AACnB;AAKO,SAAS,YAAA,GAA0C;AACxD,EAAA,OAAO,MAAA,GAAS,SAAA,EAAU;AAC5B;AAgBO,IAAM,EAAA,GAAK,IAAI,KAAA,CAAM,EAAC,EAAgC;AAAA,EAC3D,GAAA,CAAI,OAAA,EAAS,IAAA,EAAM,QAAA,EAAU;AAC3B,IAAA,MAAM,YAAY,YAAA,EAAa;AAC/B,IAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,GAAA,CAAI,SAAA,EAAW,MAAM,QAAQ,CAAA;AACnD,IAAA,OAAO,OAAO,KAAA,KAAU,UAAA,GAAa,KAAA,CAAM,IAAA,CAAK,SAAS,CAAA,GAAI,KAAA;AAAA,EAC/D;AACF,CAAC,CAAA;;;AC9GD,IAAI,aAAA,GAAsC,IAAA;AAKnC,SAAS,gBAAA,GAAkC;AAChD,EAAA,IAAI,CAAC,aAAA,EAAe;AAClB,IAAA,aAAA,GAAgB,IAAI,aAAA,CAAc;AAAA,MAChC,EAAA;AAAA,MACA,eAAA,EAAiB,oBAAA;AAAA,MACjB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,qBAAA,EAAuB,0BAAA;AAAA,MACvB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,oBAAA,EAAsB,yBAAA;AAAA,MACtB,kBAAA,EAAoB,uBAAA;AAAA,MACpB,qBAAA,EAAuB,0BAAA;AAAA,MACvB,yBAAA,EAA2B;AAAA,KAC5B,CAAA;AAAA,EACH;AACA,EAAA,OAAO,aAAA;AACT;AClBA,IAAI,cAAA,GAAwC,IAAA;AAK5C,SAAS,uBAAuB,SAAA,EAAmC;AACjE,EAAA,OAAO,SAAA;AACT;AAKO,SAAS,iBAAA,GAAoC;AAClD,EAAA,IAAI,CAAC,cAAA,EAAgB;AACnB,IAAA,cAAA,GAAiB,IAAI,cAAA,CAAe;AAAA,MAClC,IAAA,EAAM,WAAA;AAAA,MACN,WAAA,EAAa,uBAAuB,EAAE,CAAA;AAAA,MACtC,eAAe,gBAAA,EAAiB;AAAA;AAAA,MAChC,gBAAA,EAAkB;AAAA,QAChB,SAAA,EAAW,IAAA;AAAA,QACX,kBAAA,EAAoB,EAAA;AAAA,QACpB,QAAA,EAAU;AAAA;AACZ,KACD,CAAA;AAAA,EACH;AACA,EAAA,OAAO,cAAA;AACT;;;ACVA,eAAsB,uBACpB,OAAA,EAC2B;AAC3B,EAAA,MAAMA,iBAAgB,gBAAA,EAAiB;AACvC,EAAuB,iBAAA;AACvB,EAAA,MAAM,gBAAgB,yBAAA,EAA0B;AAChD,EAAA,MAAM,YAAY,mBAAA,EAAoB;AAGtC,EAAA,IAAI,QAAQ,QAAA,EAAU;AACpB,IAAA,MAAM,MAAA,GAAS,SAAA,CAAU,gBAAA,CAAiB,OAAA,CAAQ,QAAA,EAAU;AAAA,MAC1D,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,KAAA,EAAO,CAAC,MAAM;AAAA,KACf,CAAA;AACD,IAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,eAAA,EAAkB,MAAA,CAAO,MAAM,CAAA,CAAE,CAAA;AAAA,IACnD;AAAA,EACF;AAGA,EAAA,aAAA,CAAc,YAAA,CAAa,OAAA,CAAQ,QAAA,IAAY,KAAA,EAAO,QAAQ,MAAM,CAAA;AAGpE,EAAA,MAAM,sBAAsB,yBAAA,CAA0B;AAAA,IACpD,UAAA,EAAY,CAAA;AAAA,IACZ,eAAA,EAAiB,IAAA;AAAA,IACjB,SAAA,EAAW;AAAA;AAAA,GACZ,CAAA;AAED,EAAA,IAAI;AACF,IAAA,MAAM,MAAA,GAAS,MAAM,gBAAA,CAAiB;AAAA,MACpC,GAAG,OAAA;AAAA,MACH,aAAA,EAAAA,cAAAA;AAAA;AAAA,MACA,QAAQ,OAAA,CAAQ,MAAA;AAAA;AAAA,MAChB,OAAO,OAAA,CAAQ,KAAA;AAAA,MACf,aAAa,mBAAA,CAAoB;AAAA;AAAA,KAClC,CAAA;AAGD,IAAA,IAAI,OAAO,QAAA,EAAU;AACnB,MAAA,SAAA,CAAU,sBAAA,CAAuB,MAAA,CAAO,QAAA,EAAU,OAAA,CAAQ,MAAM,CAAA;AAAA,IAClE;AAGA,IAAA,aAAA,CAAc,WAAA,CAAY;AAAA,MACxB,IAAA,EAAM,eAAA;AAAA,MACN,WAAW,MAAA,CAAO,QAAA;AAAA,MAClB,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,OAAA,EAAS,EAAE,KAAA,EAAO,OAAA,CAAQ,KAAA;AAAM,KACjC,CAAA;AAED,IAAA,OAAO,MAAA;AAAA,EACT,SAAS,KAAA,EAAO;AACd,IAAA,aAAA,CAAc,WAAA,CAAY,OAAA,CAAQ,QAAA,IAAY,KAAA,EAAO,KAAc,CAAA;AACnE,IAAA,MAAM,KAAA;AAAA,EACR;AACF","file":"skill-agent.js","sourcesContent":["/**\n * Database Accessors & Initialization\n *\n * This module provides:\n * - `initializeFirebase()` — convenience function to init Firebase from env vars\n * - `getFirestore()`, `getAuth()` — accessors for Firebase services\n * - `db` — lazy Firestore proxy (no eager initialization)\n *\n * The consuming application MUST call `initializeFirebase()` or\n * `admin.initializeApp()` before using any Firebase-dependent features.\n */\n\nimport admin from 'firebase-admin';\n\n/**\n * Initialize Firebase Admin SDK from environment variables.\n *\n * Reads: FIREBASE_PROJECT_ID, FIREBASE_CLIENT_EMAIL, FIREBASE_PRIVATE_KEY,\n *        FIREBASE_SERVICE_ACCOUNT_PATH, FIRESTORE_EMULATOR_HOST\n *\n * Safe to call multiple times — returns existing app if already initialized.\n */\nexport function initializeFirebase(): admin.app.App {\n  // Already initialized — return existing app\n  if (admin.apps.length > 0) {\n    return admin.app();\n  }\n\n  const projectId = process.env.FIREBASE_PROJECT_ID;\n  const emulatorHost = process.env.FIRESTORE_EMULATOR_HOST;\n\n  // Emulator mode — no credentials needed\n  if (emulatorHost) {\n    const app = admin.initializeApp({\n      projectId: projectId || 'demo-project',\n    });\n    console.log(`Firebase Admin initialized for emulator: ${emulatorHost}`);\n    return app;\n  }\n\n  // Service account file\n  const serviceAccountPath = process.env.FIREBASE_SERVICE_ACCOUNT_PATH;\n  if (serviceAccountPath) {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const serviceAccount = require(serviceAccountPath);\n    return admin.initializeApp({\n      credential: admin.credential.cert(serviceAccount),\n      projectId,\n    });\n  }\n\n  // Inline credentials\n  const clientEmail = process.env.FIREBASE_CLIENT_EMAIL;\n  const privateKey = process.env.FIREBASE_PRIVATE_KEY;\n  if (projectId && clientEmail && privateKey) {\n    return admin.initializeApp({\n      credential: admin.credential.cert({\n        projectId,\n        clientEmail,\n        privateKey: privateKey.replace(/\\\\n/g, '\\n'),\n      }),\n      projectId,\n    });\n  }\n\n  // Application default credentials (Cloud Run, etc.)\n  if (projectId) {\n    return admin.initializeApp({\n      credential: admin.credential.applicationDefault(),\n      projectId,\n    });\n  }\n\n  throw new Error(\n    '@almadar/server: Cannot initialize Firebase — no credentials found. ' +\n    'Set FIREBASE_PROJECT_ID + FIREBASE_CLIENT_EMAIL + FIREBASE_PRIVATE_KEY, ' +\n    'or FIREBASE_SERVICE_ACCOUNT_PATH, or FIRESTORE_EMULATOR_HOST.'\n  );\n}\n\n/**\n * Get the initialized Firebase app.\n * Throws if Firebase Admin SDK has not been initialized.\n */\nfunction getApp(): admin.app.App {\n  if (admin.apps.length === 0) {\n    throw new Error(\n      '@almadar/server: Firebase Admin SDK is not initialized. ' +\n      'Call initializeFirebase() or admin.initializeApp() before using @almadar/server.'\n    );\n  }\n  return admin.app();\n}\n\n/**\n * Get Firestore instance from the pre-initialized Firebase app.\n */\nexport function getFirestore(): admin.firestore.Firestore {\n  return getApp().firestore();\n}\n\n/**\n * Get Firebase Auth instance from the pre-initialized Firebase app.\n */\nexport function getAuth(): admin.auth.Auth {\n  return getApp().auth();\n}\n\n// Re-export admin for convenience\nexport { admin };\n\n/**\n * Lazy Firestore proxy — resolves on first property access, not at import time.\n * This prevents the \"Firebase not initialized\" error during module loading.\n */\nexport const db = new Proxy({} as admin.firestore.Firestore, {\n  get(_target, prop, receiver) {\n    const firestore = getFirestore();\n    const value = Reflect.get(firestore, prop, receiver);\n    return typeof value === 'function' ? value.bind(firestore) : value;\n  },\n});\n","/**\n * Memory Manager Singleton\n *\n * Provides Firestore-backed memory management for DeepAgent.\n *\n * @packageDocumentation\n */\n\nimport { MemoryManager } from '@almadar/agent';\nimport { db } from '../lib/db.js';\n\nlet memoryManager: MemoryManager | null = null;\n\n/**\n * Get or create the MemoryManager singleton\n */\nexport function getMemoryManager(): MemoryManager {\n  if (!memoryManager) {\n    memoryManager = new MemoryManager({\n      db,\n      usersCollection: 'agent_memory_users',\n      projectsCollection: 'agent_memory_projects',\n      generationsCollection: 'agent_memory_generations',\n      patternsCollection: 'agent_memory_patterns',\n      interruptsCollection: 'agent_memory_interrupts',\n      feedbackCollection: 'agent_memory_feedback',\n      checkpointsCollection: 'agent_memory_checkpoints',\n      toolPreferencesCollection: 'agent_memory_tool_preferences',\n    });\n  }\n  return memoryManager;\n}\n\n/**\n * Reset the MemoryManager (useful for testing)\n */\nexport function resetMemoryManager(): void {\n  memoryManager = null;\n}\n","/**\n * Session Manager Singleton\n *\n * Provides Firestore-backed session management with full GAP features.\n *\n * @packageDocumentation\n */\n\nimport { SessionManager } from '@almadar/agent';\nimport { db } from '../lib/db.js';\nimport { getMemoryManager } from './memory.js';\nimport type { FirestoreDb } from '@almadar/agent';\n\nlet sessionManager: SessionManager | null = null;\n\n/**\n * Adapter to make Firebase Firestore compatible with @almadar/agent FirestoreDb interface\n */\nfunction createFirestoreAdapter(firestore: typeof db): FirestoreDb {\n  return firestore as unknown as FirestoreDb;\n}\n\n/**\n * Get or create the SessionManager singleton\n */\nexport function getSessionManager(): SessionManager {\n  if (!sessionManager) {\n    sessionManager = new SessionManager({\n      mode: 'firestore',\n      firestoreDb: createFirestoreAdapter(db),\n      memoryManager: getMemoryManager(), // Enable GAP-002D\n      compactionConfig: {\n        maxTokens: 150000,\n        keepRecentMessages: 10,\n        strategy: 'last',\n      },\n    });\n  }\n  return sessionManager;\n}\n\n/**\n * Reset the SessionManager (useful for testing)\n */\nexport function resetSessionManager(): void {\n  sessionManager = null;\n}\n","/**\n * Skill Agent Factory\n *\n * Creates DeepAgent instances with full GAP feature integration.\n *\n * @packageDocumentation\n */\n\nimport {\n  createSkillAgent,\n  getObservabilityCollector,\n  getMultiUserManager,\n  createWorkflowToolWrapper,\n  type SkillAgentOptions,\n  type SkillAgentResult,\n} from '@almadar/agent';\nimport { getMemoryManager } from './memory.js';\nimport { getSessionManager } from './session.js';\n\ninterface ServerSkillAgentOptions extends SkillAgentOptions {\n  /** User ID from Firebase Auth */\n  userId: string;\n  /** App/Project ID for context */\n  appId?: string;\n}\n\n/**\n * Create a skill agent with full server-side GAP integration\n */\nexport async function createServerSkillAgent(\n  options: ServerSkillAgentOptions,\n): Promise<SkillAgentResult> {\n  const memoryManager = getMemoryManager();\n  const sessionManager = getSessionManager();\n  const observability = getObservabilityCollector();\n  const multiUser = getMultiUserManager();\n\n  // Check access if resuming existing session\n  if (options.threadId) {\n    const access = multiUser.canAccessSession(options.threadId, {\n      userId: options.userId,\n      roles: ['user'],\n    });\n    if (!access.allowed) {\n      throw new Error(`Access denied: ${access.reason}`);\n    }\n  }\n\n  // Start observability\n  observability.startSession(options.threadId ?? 'new', options.userId);\n\n  // Create workflow tool wrapper for retry/telemetry (always enabled)\n  const workflowToolWrapper = createWorkflowToolWrapper({\n    maxRetries: 2,\n    enableTelemetry: true,\n    timeoutMs: 300000, // 5 minutes\n  });\n\n  try {\n    const result = await createSkillAgent({\n      ...options,\n      memoryManager, // GAP-001: Enable memory\n      userId: options.userId, // GAP-002D: Session → Memory sync\n      appId: options.appId,\n      toolWrapper: workflowToolWrapper.wrap, // Always use workflow wrapper for reliability\n    });\n\n    // Assign ownership for new sessions\n    if (result.threadId) {\n      multiUser.assignSessionOwnership(result.threadId, options.userId);\n    }\n\n    // Record successful creation\n    observability.recordEvent({\n      type: 'session_start',\n      sessionId: result.threadId,\n      userId: options.userId,\n      payload: { skill: options.skill },\n    });\n\n    return result;\n  } catch (error) {\n    observability.recordError(options.threadId ?? 'new', error as Error);\n    throw error;\n  }\n}\n\n// Re-export for convenience\nexport { getMemoryManager, getSessionManager };\n"]}
+{"version":3,"sources":["../../src/lib/db.ts","../../src/deepagent/memory.ts","../../src/deepagent/session.ts","../../src/deepagent/skill-agent.ts"],"names":["memoryManager"],"mappings":"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","file":"skill-agent.js","sourcesContent":["/**\n * Database Accessors & Initialization\n *\n * This module provides:\n * - `initializeFirebase()` — convenience function to init Firebase from env vars\n * - `getFirestore()`, `getAuth()` — accessors for Firebase services\n * - `db` — lazy Firestore proxy (no eager initialization)\n *\n * The consuming application MUST call `initializeFirebase()` or\n * `admin.initializeApp()` before using any Firebase-dependent features.\n */\n\nimport admin from 'firebase-admin';\n\n/**\n * Initialize Firebase Admin SDK from environment variables.\n *\n * Reads: FIREBASE_PROJECT_ID, FIREBASE_CLIENT_EMAIL, FIREBASE_PRIVATE_KEY,\n *        FIREBASE_SERVICE_ACCOUNT_PATH, FIRESTORE_EMULATOR_HOST\n *\n * Safe to call multiple times — returns existing app if already initialized.\n */\nexport function initializeFirebase(): admin.app.App {\n  // Already initialized — return existing app\n  if (admin.apps.length > 0) {\n    return admin.app();\n  }\n\n  const projectId = process.env.FIREBASE_PROJECT_ID;\n  const emulatorHost = process.env.FIRESTORE_EMULATOR_HOST;\n\n  // Emulator mode — no credentials needed\n  if (emulatorHost) {\n    const app = admin.initializeApp({\n      projectId: projectId || 'demo-project',\n    });\n    console.log(`Firebase Admin initialized for emulator: ${emulatorHost}`);\n    return app;\n  }\n\n  // Service account file\n  const serviceAccountPath = process.env.FIREBASE_SERVICE_ACCOUNT_PATH;\n  if (serviceAccountPath) {\n    // Dynamic require for JSON service account file at runtime\n    const serviceAccount = require(serviceAccountPath) as Record<string, unknown>;\n    return admin.initializeApp({\n      credential: admin.credential.cert(serviceAccount),\n      projectId,\n    });\n  }\n\n  // Inline credentials\n  const clientEmail = process.env.FIREBASE_CLIENT_EMAIL;\n  const privateKey = process.env.FIREBASE_PRIVATE_KEY;\n  if (projectId && clientEmail && privateKey) {\n    return admin.initializeApp({\n      credential: admin.credential.cert({\n        projectId,\n        clientEmail,\n        privateKey: privateKey.replace(/\\\\n/g, '\\n'),\n      }),\n      projectId,\n    });\n  }\n\n  // Application default credentials (Cloud Run, etc.)\n  if (projectId) {\n    return admin.initializeApp({\n      credential: admin.credential.applicationDefault(),\n      projectId,\n    });\n  }\n\n  throw new Error(\n    '@almadar/server: Cannot initialize Firebase — no credentials found. ' +\n    'Set FIREBASE_PROJECT_ID + FIREBASE_CLIENT_EMAIL + FIREBASE_PRIVATE_KEY, ' +\n    'or FIREBASE_SERVICE_ACCOUNT_PATH, or FIRESTORE_EMULATOR_HOST.'\n  );\n}\n\n/**\n * Get the initialized Firebase app.\n * Throws if Firebase Admin SDK has not been initialized.\n */\nfunction getApp(): admin.app.App {\n  if (admin.apps.length === 0) {\n    throw new Error(\n      '@almadar/server: Firebase Admin SDK is not initialized. ' +\n      'Call initializeFirebase() or admin.initializeApp() before using @almadar/server.'\n    );\n  }\n  return admin.app();\n}\n\n/**\n * Get Firestore instance from the pre-initialized Firebase app.\n */\nexport function getFirestore(): admin.firestore.Firestore {\n  return getApp().firestore();\n}\n\n/**\n * Get Firebase Auth instance from the pre-initialized Firebase app.\n */\nexport function getAuth(): admin.auth.Auth {\n  return getApp().auth();\n}\n\n// Re-export admin for convenience\nexport { admin };\n\n/**\n * Lazy Firestore proxy — resolves on first property access, not at import time.\n * This prevents the \"Firebase not initialized\" error during module loading.\n */\nexport const db = new Proxy({} as admin.firestore.Firestore, {\n  get(_target, prop, receiver) {\n    const firestore = getFirestore();\n    const value = Reflect.get(firestore, prop, receiver);\n    return typeof value === 'function' ? value.bind(firestore) : value;\n  },\n});\n","/**\n * Memory Manager Singleton\n *\n * Provides Firestore-backed memory management for DeepAgent.\n *\n * @packageDocumentation\n */\n\nimport { MemoryManager } from '@almadar/agent';\nimport { db } from '../lib/db.js';\n\nlet memoryManager: MemoryManager | null = null;\n\n/**\n * Get or create the MemoryManager singleton\n */\nexport function getMemoryManager(): MemoryManager {\n  if (!memoryManager) {\n    memoryManager = new MemoryManager({\n      db,\n      usersCollection: 'agent_memory_users',\n      projectsCollection: 'agent_memory_projects',\n      generationsCollection: 'agent_memory_generations',\n      patternsCollection: 'agent_memory_patterns',\n      interruptsCollection: 'agent_memory_interrupts',\n      feedbackCollection: 'agent_memory_feedback',\n      checkpointsCollection: 'agent_memory_checkpoints',\n      toolPreferencesCollection: 'agent_memory_tool_preferences',\n    });\n  }\n  return memoryManager;\n}\n\n/**\n * Reset the MemoryManager (useful for testing)\n */\nexport function resetMemoryManager(): void {\n  memoryManager = null;\n}\n","/**\n * Session Manager Singleton\n *\n * Provides Firestore-backed session management with full GAP features.\n *\n * @packageDocumentation\n */\n\nimport { SessionManager } from '@almadar/agent';\nimport { db } from '../lib/db.js';\nimport { getMemoryManager } from './memory.js';\nimport type { FirestoreDb } from '@almadar/agent';\n\nlet sessionManager: SessionManager | null = null;\n\n/**\n * Adapter to make Firebase Firestore compatible with @almadar/agent FirestoreDb interface\n */\nfunction createFirestoreAdapter(firestore: typeof db): FirestoreDb {\n  return firestore as unknown as FirestoreDb;\n}\n\n/**\n * Get or create the SessionManager singleton\n */\nexport function getSessionManager(): SessionManager {\n  if (!sessionManager) {\n    sessionManager = new SessionManager({\n      mode: 'firestore',\n      firestoreDb: createFirestoreAdapter(db),\n      memoryManager: getMemoryManager(), // Enable GAP-002D\n      compactionConfig: {\n        maxTokens: 150000,\n        keepRecentMessages: 10,\n        strategy: 'last',\n      },\n    });\n  }\n  return sessionManager;\n}\n\n/**\n * Reset the SessionManager (useful for testing)\n */\nexport function resetSessionManager(): void {\n  sessionManager = null;\n}\n","/**\n * Skill Agent Factory\n *\n * Creates DeepAgent instances with full GAP feature integration.\n *\n * @packageDocumentation\n */\n\nimport {\n  createSkillAgent,\n  getObservabilityCollector,\n  getMultiUserManager,\n  createWorkflowToolWrapper,\n  type SkillAgentOptions,\n  type SkillAgentResult,\n} from '@almadar/agent';\nimport { getMemoryManager } from './memory.js';\nimport { getSessionManager } from './session.js';\n\ninterface ServerSkillAgentOptions extends SkillAgentOptions {\n  /** User ID from Firebase Auth */\n  userId: string;\n  /** App/Project ID for context */\n  appId?: string;\n}\n\n/**\n * Create a skill agent with full server-side GAP integration\n */\nexport async function createServerSkillAgent(\n  options: ServerSkillAgentOptions,\n): Promise<SkillAgentResult> {\n  const memoryManager = getMemoryManager();\n  const sessionManager = getSessionManager();\n  const observability = getObservabilityCollector();\n  const multiUser = getMultiUserManager();\n\n  // Check access if resuming existing session\n  if (options.threadId) {\n    const access = multiUser.canAccessSession(options.threadId, {\n      userId: options.userId,\n      roles: ['user'],\n    });\n    if (!access.allowed) {\n      throw new Error(`Access denied: ${access.reason}`);\n    }\n  }\n\n  // Start observability\n  observability.startSession(options.threadId ?? 'new', options.userId);\n\n  // Create workflow tool wrapper for retry/telemetry (always enabled)\n  const workflowToolWrapper = createWorkflowToolWrapper({\n    maxRetries: 2,\n    enableTelemetry: true,\n    timeoutMs: 300000, // 5 minutes\n  });\n\n  try {\n    const result = await createSkillAgent({\n      ...options,\n      memoryManager, // GAP-001: Enable memory\n      userId: options.userId, // GAP-002D: Session → Memory sync\n      appId: options.appId,\n      toolWrapper: workflowToolWrapper.wrap, // Always use workflow wrapper for reliability\n    });\n\n    // Assign ownership for new sessions\n    if (result.threadId) {\n      multiUser.assignSessionOwnership(result.threadId, options.userId);\n    }\n\n    // Record successful creation\n    observability.recordEvent({\n      type: 'session_start',\n      sessionId: result.threadId,\n      userId: options.userId,\n      payload: { skill: options.skill },\n    });\n\n    return result;\n  } catch (error) {\n    observability.recordError(options.threadId ?? 'new', error as Error);\n    throw error;\n  }\n}\n\n// Re-export for convenience\nexport { getMemoryManager, getSessionManager };\n"]}

package/dist/index.d.ts

@@ -23,6 +23,12 @@ export { validateBody, validateQuery, validateParams } from './middleware/valida
 export { authenticateFirebase } from './middleware/authenticateFirebase.js';
 export { MockDataService, getMockDataService, resetMockDataService, type FieldSchema, type EntitySchema, } from './services/MockDataService.js';
 export { getDataService, resetDataService, seedMockData, type DataService, type EntitySeedConfig, type PaginationOptions, type PaginatedResult, } from './services/DataService.js';
+/** @deprecated Use getDataService() instead */
+export declare const dataService: import("./index.js").DataService;
+/** @deprecated Use getMockDataService() instead */
+export declare const mockDataService: import("./index.js").MockDataService;
+/** @deprecated Use getServerEventBus() instead */
+export declare const serverEventBus: import("./index.js").EventBus;
 export { toFirestoreFormat, fromFirestoreFormat, SchemaStore, SnapshotStore, ChangeSetStore, ValidationStore, SchemaProtectionService, } from './stores/index.js';
 export { parseQueryFilters, applyFiltersToQuery, extractPaginationParams, type ParsedFilter, type FirestoreWhereFilterOp, type PaginationParams, } from './utils/queryFilters.js';
 export { getMemoryManager, resetMemoryManager, } from './deepagent/memory.js';
@@ -31,5 +37,6 @@ export { createServerSkillAgent, getMemoryManager as getAgentMemoryManager, getS
 export { multiUserMiddleware, verifyFirebaseAuth, } from './middleware/multi-user.js';
 export { setupStateSyncWebSocket } from './websocket/state-sync.js';
 export { ServiceDiscovery, InMemoryServiceRegistry, type ServiceRegistration, type ServiceRegistryOptions, type IServiceRegistry, } from './lib/serviceDiscovery.js';
+export type { DataServiceActions, DataServiceContract, EventBusActions, EventBusServiceContract, ServiceDiscoveryActions, ServiceDiscoveryContract, ServerServiceContracts, } from './contracts.js';
 export { default as observabilityRouter } from './routes/observability.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;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1H,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,WAAW,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAG5E,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EACf,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EACtB,gBAAgB,IAAI,qBAAqB,EACzC,iBAAiB,IAAI,sBAAsB,GAC5C,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1257,6 +1257,38 @@ var MockDataServiceAdapter = class {
   async delete(collection, id) {
     return getMockDataService().delete(collection, id);
   }
+  async query(collection, filters) {
+    let items = getMockDataService().list(collection);
+    for (const filter of filters) {
+      items = items.filter((item) => {
+        const value = item[filter.field];
+        return applyFilterCondition(value, filter.op, filter.value);
+      });
+    }
+    return items;
+  }
+  getStore(collection) {
+    const adapter = this;
+    return {
+      async getById(id) {
+        return adapter.getById(collection, id);
+      },
+      async create(data) {
+        return adapter.create(collection, data);
+      },
+      async update(id, data) {
+        const result = await adapter.update(collection, id, data);
+        if (!result) throw new Error(`Entity ${id} not found in ${collection}`);
+        return result;
+      },
+      async delete(id) {
+        adapter.delete(collection, id);
+      },
+      async query(filters) {
+        return adapter.query(collection, filters);
+      }
+    };
+  }
 };
 var FirebaseDataService = class {
   async list(collection) {
@@ -1365,6 +1397,51 @@ var FirebaseDataService = class {
     await docRef.delete();
     return true;
   }
+  async query(collection, filters) {
+    let query = db.collection(collection);
+    const memoryFilters = [];
+    for (const filter of filters) {
+      if (["==", "!=", "<", "<=", ">", ">=", "in", "not-in"].includes(filter.op)) {
+        query = query.where(filter.field, filter.op, filter.value);
+      } else {
+        memoryFilters.push(filter);
+      }
+    }
+    const snapshot = await query.get();
+    let items = snapshot.docs.map((doc) => ({
+      id: doc.id,
+      ...doc.data()
+    }));
+    for (const filter of memoryFilters) {
+      items = items.filter((item) => {
+        const value = item[filter.field];
+        return applyFilterCondition(value, filter.op, filter.value);
+      });
+    }
+    return items;
+  }
+  getStore(collection) {
+    const svc = this;
+    return {
+      async getById(id) {
+        return svc.getById(collection, id);
+      },
+      async create(data) {
+        return svc.create(collection, data);
+      },
+      async update(id, data) {
+        const result = await svc.update(collection, id, data);
+        if (!result) throw new Error(`Entity ${id} not found in ${collection}`);
+        return result;
+      },
+      async delete(id) {
+        await svc.delete(collection, id);
+      },
+      async query(filters) {
+        return svc.query(collection, filters);
+      }
+    };
+  }
 };
 function createDataService() {
   if (env.USE_MOCK_DATA) {
@@ -2294,6 +2371,23 @@ router.get("/active-sessions", async (req, res) => {
 });
 var observability_default = router;
 
-export { AppError, ChangeSetStore, ConflictError, DistributedEventBus, EventBus, EventPersistence, ForbiddenError, InMemoryEventStore, InMemoryServiceRegistry, InMemoryTransport, MockDataService, NotFoundError, RedisTransport, SchemaProtectionService, SchemaStore, ServiceDiscovery, SnapshotStore, UnauthorizedError, ValidationError, ValidationStore, applyFiltersToQuery, asyncHandler, authenticateFirebase, closeWebSocketServer, createServerSkillAgent, db, debugEventsRouter, emitEntityEvent, env, errorHandler, extractPaginationParams, fromFirestoreFormat, getMemoryManager as getAgentMemoryManager, getSessionManager as getAgentSessionManager, getAuth, getConnectedClientCount, getDataService, getFirestore, getMemoryManager, getMockDataService, getServerEventBus, getSessionManager, getWebSocketServer, initializeFirebase, logger, multiUserMiddleware, notFoundHandler, observability_default as observabilityRouter, parseQueryFilters, resetDataService, resetMemoryManager, resetMockDataService, resetServerEventBus, resetSessionManager, seedMockData, setupEventBroadcast, setupStateSyncWebSocket, toFirestoreFormat, validateBody, validateParams, validateQuery, verifyFirebaseAuth };
+// src/index.ts
+var dataService = new Proxy({}, {
+  get(_target, prop, receiver) {
+    return Reflect.get(getDataService(), prop, receiver);
+  }
+});
+var mockDataService = new Proxy({}, {
+  get(_target, prop, receiver) {
+    return Reflect.get(getMockDataService(), prop, receiver);
+  }
+});
+var serverEventBus = new Proxy({}, {
+  get(_target, prop, receiver) {
+    return Reflect.get(getServerEventBus(), prop, receiver);
+  }
+});
+
+export { AppError, ChangeSetStore, ConflictError, DistributedEventBus, EventBus, EventPersistence, ForbiddenError, InMemoryEventStore, InMemoryServiceRegistry, InMemoryTransport, MockDataService, NotFoundError, RedisTransport, SchemaProtectionService, SchemaStore, ServiceDiscovery, SnapshotStore, UnauthorizedError, ValidationError, ValidationStore, applyFiltersToQuery, asyncHandler, authenticateFirebase, closeWebSocketServer, createServerSkillAgent, dataService, db, debugEventsRouter, emitEntityEvent, env, errorHandler, extractPaginationParams, fromFirestoreFormat, getMemoryManager as getAgentMemoryManager, getSessionManager as getAgentSessionManager, getAuth, getConnectedClientCount, getDataService, getFirestore, getMemoryManager, getMockDataService, getServerEventBus, getSessionManager, getWebSocketServer, initializeFirebase, logger, mockDataService, multiUserMiddleware, notFoundHandler, observability_default as observabilityRouter, parseQueryFilters, resetDataService, resetMemoryManager, resetMockDataService, resetServerEventBus, resetSessionManager, seedMockData, serverEventBus, setupEventBroadcast, setupStateSyncWebSocket, toFirestoreFormat, validateBody, validateParams, validateQuery, verifyFirebaseAuth };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map