@almadar/server 2.1.0 → 2.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/server",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Shared server infrastructure for Almadar applications",
   "type": "module",
   "main": "./dist/index.js",

package/dist/contracts.d.ts

@@ -1,174 +0,0 @@
-/**
- * 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

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

package/dist/deepagent/__tests__/memory.test.d.ts

@@ -1,6 +0,0 @@
-/**
- * @fileoverview Unit tests for MemoryManager integration
- * @module @almadar/server/deepagent/memory.test
- */
-export {};
-//# sourceMappingURL=memory.test.d.ts.map

package/dist/deepagent/__tests__/memory.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory.test.d.ts","sourceRoot":"","sources":["../../../src/deepagent/__tests__/memory.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/deepagent/__tests__/session.test.d.ts

@@ -1,6 +0,0 @@
-/**
- * @fileoverview Unit tests for SessionManager integration
- * @module @almadar/server/deepagent/session.test
- */
-export {};
-//# sourceMappingURL=session.test.d.ts.map

package/dist/deepagent/__tests__/session.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session.test.d.ts","sourceRoot":"","sources":["../../../src/deepagent/__tests__/session.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/deepagent/__tests__/skill-agent.test.d.ts

@@ -1,6 +0,0 @@
-/**
- * @fileoverview Unit tests for skill agent factory
- * @module @almadar/server/deepagent/skill-agent.test
- */
-export {};
-//# sourceMappingURL=skill-agent.test.d.ts.map

package/dist/deepagent/__tests__/skill-agent.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"skill-agent.test.d.ts","sourceRoot":"","sources":["../../../src/deepagent/__tests__/skill-agent.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/deepagent/memory.d.ts

@@ -1,17 +0,0 @@
-/**
- * Memory Manager Singleton
- *
- * Provides Firestore-backed memory management for DeepAgent.
- *
- * @packageDocumentation
- */
-import { MemoryManager } from '@almadar-io/agent';
-/**
- * Get or create the MemoryManager singleton
- */
-export declare function getMemoryManager(): MemoryManager;
-/**
- * Reset the MemoryManager (useful for testing)
- */
-export declare function resetMemoryManager(): void;
-//# sourceMappingURL=memory.d.ts.map

package/dist/deepagent/memory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/deepagent/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKlD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAehD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/deepagent/memory.js

@@ -1,48 +0,0 @@
-import { MemoryManager } from '@almadar-io/agent';
-import admin from 'firebase-admin';
-
-// src/deepagent/memory.ts
-function getApp() {
-  if (admin.apps.length === 0) {
-    throw new Error(
-      "@almadar/server: Firebase Admin SDK is not initialized. Call initializeFirebase() or admin.initializeApp() before using @almadar/server."
-    );
-  }
-  return admin.app();
-}
-function getFirestore() {
-  return getApp().firestore();
-}
-var db = new Proxy({}, {
-  get(_target, prop, receiver) {
-    const firestore = getFirestore();
-    const value = Reflect.get(firestore, prop, receiver);
-    return typeof value === "function" ? value.bind(firestore) : value;
-  }
-});
-
-// src/deepagent/memory.ts
-var memoryManager = null;
-function getMemoryManager() {
-  if (!memoryManager) {
-    memoryManager = new MemoryManager({
-      db,
-      usersCollection: "agent_memory_users",
-      projectsCollection: "agent_memory_projects",
-      generationsCollection: "agent_memory_generations",
-      patternsCollection: "agent_memory_patterns",
-      interruptsCollection: "agent_memory_interrupts",
-      feedbackCollection: "agent_memory_feedback",
-      checkpointsCollection: "agent_memory_checkpoints",
-      toolPreferencesCollection: "agent_memory_tool_preferences"
-    });
-  }
-  return memoryManager;
-}
-function resetMemoryManager() {
-  memoryManager = null;
-}
-
-export { getMemoryManager, resetMemoryManager };
-//# sourceMappingURL=memory.js.map
-//# sourceMappingURL=memory.js.map

package/dist/deepagent/memory.js.map

@@ -1 +0,0 @@
-{"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-io/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.d.ts

@@ -1,17 +0,0 @@
-/**
- * Session Manager Singleton
- *
- * Provides Firestore-backed session management with full GAP features.
- *
- * @packageDocumentation
- */
-import { SessionManager } from '@almadar-io/agent';
-/**
- * Get or create the SessionManager singleton
- */
-export declare function getSessionManager(): SessionManager;
-/**
- * Reset the SessionManager (useful for testing)
- */
-export declare function resetSessionManager(): void;
-//# sourceMappingURL=session.d.ts.map

package/dist/deepagent/session.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/deepagent/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAcnD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAclD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/deepagent/session.js

@@ -1,68 +0,0 @@
-import { SessionManager, MemoryManager } from '@almadar-io/agent';
-import admin from 'firebase-admin';
-
-// src/deepagent/session.ts
-function getApp() {
-  if (admin.apps.length === 0) {
-    throw new Error(
-      "@almadar/server: Firebase Admin SDK is not initialized. Call initializeFirebase() or admin.initializeApp() before using @almadar/server."
-    );
-  }
-  return admin.app();
-}
-function getFirestore() {
-  return getApp().firestore();
-}
-var db = new Proxy({}, {
-  get(_target, prop, receiver) {
-    const firestore = getFirestore();
-    const value = Reflect.get(firestore, prop, receiver);
-    return typeof value === "function" ? value.bind(firestore) : value;
-  }
-});
-var memoryManager = null;
-function getMemoryManager() {
-  if (!memoryManager) {
-    memoryManager = new MemoryManager({
-      db,
-      usersCollection: "agent_memory_users",
-      projectsCollection: "agent_memory_projects",
-      generationsCollection: "agent_memory_generations",
-      patternsCollection: "agent_memory_patterns",
-      interruptsCollection: "agent_memory_interrupts",
-      feedbackCollection: "agent_memory_feedback",
-      checkpointsCollection: "agent_memory_checkpoints",
-      toolPreferencesCollection: "agent_memory_tool_preferences"
-    });
-  }
-  return memoryManager;
-}
-
-// src/deepagent/session.ts
-var sessionManager = null;
-function createFirestoreAdapter(firestore) {
-  return firestore;
-}
-function getSessionManager() {
-  if (!sessionManager) {
-    sessionManager = new SessionManager({
-      mode: "firestore",
-      firestoreDb: createFirestoreAdapter(db),
-      memoryManager: getMemoryManager(),
-      // Enable GAP-002D
-      compactionConfig: {
-        maxTokens: 15e4,
-        keepRecentMessages: 10,
-        strategy: "last"
-      }
-    });
-  }
-  return sessionManager;
-}
-function resetSessionManager() {
-  sessionManager = null;
-}
-
-export { getSessionManager, resetSessionManager };
-//# sourceMappingURL=session.js.map
-//# sourceMappingURL=session.js.map

package/dist/deepagent/session.js.map

@@ -1 +0,0 @@
-{"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-io/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-io/agent';\nimport { db } from '../lib/db.js';\nimport { getMemoryManager } from './memory.js';\nimport type { FirestoreDb } from '@almadar-io/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.d.ts

@@ -1,22 +0,0 @@
-/**
- * Skill Agent Factory
- *
- * Creates DeepAgent instances with full GAP feature integration.
- *
- * @packageDocumentation
- */
-import { type SkillAgentOptions, type SkillAgentResult } from '@almadar-io/agent';
-import { getMemoryManager } from './memory.js';
-import { getSessionManager } from './session.js';
-interface ServerSkillAgentOptions extends SkillAgentOptions {
-    /** User ID from Firebase Auth */
-    userId: string;
-    /** App/Project ID for context */
-    appId?: string;
-}
-/**
- * Create a skill agent with full server-side GAP integration
- */
-export declare function createServerSkillAgent(options: ServerSkillAgentOptions): Promise<SkillAgentResult>;
-export { getMemoryManager, getSessionManager };
-//# sourceMappingURL=skill-agent.d.ts.map

package/dist/deepagent/skill-agent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"skill-agent.d.ts","sourceRoot":"","sources":["../../src/deepagent/skill-agent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,UAAU,uBAAwB,SAAQ,iBAAiB;IACzD,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAsD3B;AAGD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/deepagent/skill-agent.js

@@ -1,114 +0,0 @@
-import { MemoryManager, SessionManager, getObservabilityCollector, getMultiUserManager, createWorkflowToolWrapper, createSkillAgent } from '@almadar-io/agent';
-import admin from 'firebase-admin';
-
-// src/deepagent/skill-agent.ts
-function getApp() {
-  if (admin.apps.length === 0) {
-    throw new Error(
-      "@almadar/server: Firebase Admin SDK is not initialized. Call initializeFirebase() or admin.initializeApp() before using @almadar/server."
-    );
-  }
-  return admin.app();
-}
-function getFirestore() {
-  return getApp().firestore();
-}
-var db = new Proxy({}, {
-  get(_target, prop, receiver) {
-    const firestore = getFirestore();
-    const value = Reflect.get(firestore, prop, receiver);
-    return typeof value === "function" ? value.bind(firestore) : value;
-  }
-});
-
-// src/deepagent/memory.ts
-var memoryManager = null;
-function getMemoryManager() {
-  if (!memoryManager) {
-    memoryManager = new MemoryManager({
-      db,
-      usersCollection: "agent_memory_users",
-      projectsCollection: "agent_memory_projects",
-      generationsCollection: "agent_memory_generations",
-      patternsCollection: "agent_memory_patterns",
-      interruptsCollection: "agent_memory_interrupts",
-      feedbackCollection: "agent_memory_feedback",
-      checkpointsCollection: "agent_memory_checkpoints",
-      toolPreferencesCollection: "agent_memory_tool_preferences"
-    });
-  }
-  return memoryManager;
-}
-var sessionManager = null;
-function createFirestoreAdapter(firestore) {
-  return firestore;
-}
-function getSessionManager() {
-  if (!sessionManager) {
-    sessionManager = new SessionManager({
-      mode: "firestore",
-      firestoreDb: createFirestoreAdapter(db),
-      memoryManager: getMemoryManager(),
-      // Enable GAP-002D
-      compactionConfig: {
-        maxTokens: 15e4,
-        keepRecentMessages: 10,
-        strategy: "last"
-      }
-    });
-  }
-  return sessionManager;
-}
-
-// src/deepagent/skill-agent.ts
-async function createServerSkillAgent(options) {
-  const memoryManager2 = getMemoryManager();
-  getSessionManager();
-  const observability = getObservabilityCollector();
-  const multiUser = getMultiUserManager();
-  if (options.threadId) {
-    const access = multiUser.canAccessSession(options.threadId, {
-      userId: options.userId,
-      roles: ["user"]
-    });
-    if (!access.allowed) {
-      throw new Error(`Access denied: ${access.reason}`);
-    }
-  }
-  observability.startSession(options.threadId ?? "new", options.userId);
-  const workflowToolWrapper = createWorkflowToolWrapper({
-    maxRetries: 2,
-    enableTelemetry: true,
-    timeoutMs: 3e5
-    // 5 minutes
-  });
-  try {
-    const result = await createSkillAgent({
-      ...options,
-      memoryManager: memoryManager2,
-      // GAP-001: Enable memory
-      userId: options.userId,
-      // GAP-002D: Session → Memory sync
-      appId: options.appId,
-      toolWrapper: workflowToolWrapper.wrap
-      // Always use workflow wrapper for reliability
-    });
-    if (result.threadId) {
-      multiUser.assignSessionOwnership(result.threadId, options.userId);
-    }
-    observability.recordEvent({
-      type: "session_start",
-      sessionId: result.threadId,
-      userId: options.userId,
-      payload: { skill: options.skill }
-    });
-    return result;
-  } catch (error) {
-    observability.recordError(options.threadId ?? "new", error);
-    throw error;
-  }
-}
-
-export { createServerSkillAgent, getMemoryManager, getSessionManager };
-//# sourceMappingURL=skill-agent.js.map
-//# sourceMappingURL=skill-agent.js.map

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

@@ -1 +0,0 @@
-{"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-io/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-io/agent';\nimport { db } from '../lib/db.js';\nimport { getMemoryManager } from './memory.js';\nimport type { FirestoreDb } from '@almadar-io/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-io/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"]}