@almadar/server 2.1.1 → 2.1.2

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/__tests__/memory.test.d.ts

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

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

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

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * Memory Manager Singleton
+ *
+ * Provides Firestore-backed memory management for DeepAgent.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Get or create the MemoryManager singleton
+ */
+export declare function getMemoryManager(): Promise<unknown>;
+/**
+ * Reset the MemoryManager (useful for testing)
+ */
+export declare function resetMemoryManager(): void;
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/deepagent/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,wBAAsB,gBAAgB,qBAgBrC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/deepagent/session.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Session Manager Singleton
+ *
+ * Provides Firestore-backed session management with full GAP features.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Get or create the SessionManager singleton
+ */
+export declare function getSessionManager(): Promise<unknown>;
+/**
+ * Reset the SessionManager (useful for testing)
+ */
+export declare function resetSessionManager(): void;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/deepagent/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;GAEG;AACH,wBAAsB,iBAAiB,qBAiBtC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

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

@@ -0,0 +1,22 @@
+/**
+ * Skill Agent Factory
+ *
+ * Creates DeepAgent instances with full GAP feature integration.
+ *
+ * @packageDocumentation
+ */
+import { getMemoryManager } from './memory.js';
+import { getSessionManager } from './session.js';
+interface ServerSkillAgentOptions {
+    userId: string;
+    appId?: string;
+    threadId?: string;
+    skill?: string;
+    [key: string]: unknown;
+}
+/**
+ * Create a skill agent with full server-side GAP integration
+ */
+export declare function createServerSkillAgent(options: ServerSkillAgentOptions): Promise<Record<string, unknown>>;
+export { getMemoryManager, getSessionManager };
+//# sourceMappingURL=skill-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-agent.d.ts","sourceRoot":"","sources":["../../src/deepagent/skill-agent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAMjD,UAAU,uBAAuB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,uBAAuB,oCAyDjC;AAGD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAC"}