@hotmeshio/hotmesh 0.3.31 → 0.4.0

package/build/index.d.ts

@@ -1,14 +1,14 @@
 import { HotMesh } from './services/hotmesh';
 import { HotMeshConfig } from './types/hotmesh';
 import { MeshCall } from './services/meshcall';
-import { MeshFlow } from './services/meshflow';
-import { ClientService as Client } from './services/meshflow/client';
-import { ConnectionService as Connection } from './services/meshflow/connection';
-import { Search } from './services/meshflow/search';
-import { WorkerService as Worker } from './services/meshflow/worker';
-import { WorkflowService as workflow } from './services/meshflow/workflow';
-import { WorkflowHandleService as WorkflowHandle } from './services/meshflow/handle';
-import { proxyActivities } from './services/meshflow/workflow/proxyActivities';
+import { MemFlow } from './services/memflow';
+import { ClientService as Client } from './services/memflow/client';
+import { ConnectionService as Connection } from './services/memflow/connection';
+import { Search } from './services/memflow/search';
+import { WorkerService as Worker } from './services/memflow/worker';
+import { WorkflowService as workflow } from './services/memflow/workflow';
+import { WorkflowHandleService as WorkflowHandle } from './services/memflow/handle';
+import { proxyActivities } from './services/memflow/workflow/proxyActivities';
 import { MeshData } from './services/meshdata';
 import { MeshOS } from './services/meshos';
 import * as Errors from './modules/errors';
@@ -21,5 +21,5 @@ import { RedisConnection as ConnectorIORedis } from './services/connector/provid
 import { RedisConnection as ConnectorRedis } from './services/connector/providers/redis';
 import { NatsConnection as ConnectorNATS } from './services/connector/providers/nats';
 export { Connector, //factory
-ConnectorIORedis, ConnectorNATS, ConnectorPostgres, ConnectorRedis, HotMesh, HotMeshConfig, MeshCall, MeshData, MeshFlow, MeshOS, Client, Connection, proxyActivities, Search, Worker, workflow, WorkflowHandle, Enums, Errors, Utils, KeyStore, };
+ConnectorIORedis, ConnectorNATS, ConnectorPostgres, ConnectorRedis, HotMesh, HotMeshConfig, MeshCall, MeshData, MemFlow, MeshOS, Client, Connection, proxyActivities, Search, Worker, workflow, WorkflowHandle, Enums, Errors, Utils, KeyStore, };
 export * as Types from './types';

package/build/index.js

@@ -23,26 +23,26 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Types = exports.KeyStore = exports.Utils = exports.Errors = exports.Enums = exports.WorkflowHandle = exports.workflow = exports.Worker = exports.Search = exports.proxyActivities = exports.Connection = exports.Client = exports.MeshOS = exports.MeshFlow = exports.MeshData = exports.MeshCall = exports.HotMesh = exports.ConnectorRedis = exports.ConnectorPostgres = exports.ConnectorNATS = exports.ConnectorIORedis = exports.Connector = void 0;
+exports.Types = exports.KeyStore = exports.Utils = exports.Errors = exports.Enums = exports.WorkflowHandle = exports.workflow = exports.Worker = exports.Search = exports.proxyActivities = exports.Connection = exports.Client = exports.MeshOS = exports.MemFlow = exports.MeshData = exports.MeshCall = exports.HotMesh = exports.ConnectorRedis = exports.ConnectorPostgres = exports.ConnectorNATS = exports.ConnectorIORedis = exports.Connector = void 0;
 const hotmesh_1 = require("./services/hotmesh");
 Object.defineProperty(exports, "HotMesh", { enumerable: true, get: function () { return hotmesh_1.HotMesh; } });
 const meshcall_1 = require("./services/meshcall");
 Object.defineProperty(exports, "MeshCall", { enumerable: true, get: function () { return meshcall_1.MeshCall; } });
-const meshflow_1 = require("./services/meshflow");
-Object.defineProperty(exports, "MeshFlow", { enumerable: true, get: function () { return meshflow_1.MeshFlow; } });
-const client_1 = require("./services/meshflow/client");
+const memflow_1 = require("./services/memflow");
+Object.defineProperty(exports, "MemFlow", { enumerable: true, get: function () { return memflow_1.MemFlow; } });
+const client_1 = require("./services/memflow/client");
 Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return client_1.ClientService; } });
-const connection_1 = require("./services/meshflow/connection");
+const connection_1 = require("./services/memflow/connection");
 Object.defineProperty(exports, "Connection", { enumerable: true, get: function () { return connection_1.ConnectionService; } });
-const search_1 = require("./services/meshflow/search");
+const search_1 = require("./services/memflow/search");
 Object.defineProperty(exports, "Search", { enumerable: true, get: function () { return search_1.Search; } });
-const worker_1 = require("./services/meshflow/worker");
+const worker_1 = require("./services/memflow/worker");
 Object.defineProperty(exports, "Worker", { enumerable: true, get: function () { return worker_1.WorkerService; } });
-const workflow_1 = require("./services/meshflow/workflow");
+const workflow_1 = require("./services/memflow/workflow");
 Object.defineProperty(exports, "workflow", { enumerable: true, get: function () { return workflow_1.WorkflowService; } });
-const handle_1 = require("./services/meshflow/handle");
+const handle_1 = require("./services/memflow/handle");
 Object.defineProperty(exports, "WorkflowHandle", { enumerable: true, get: function () { return handle_1.WorkflowHandleService; } });
-const proxyActivities_1 = require("./services/meshflow/workflow/proxyActivities");
+const proxyActivities_1 = require("./services/memflow/workflow/proxyActivities");
 Object.defineProperty(exports, "proxyActivities", { enumerable: true, get: function () { return proxyActivities_1.proxyActivities; } });
 const meshdata_1 = require("./services/meshdata");
 Object.defineProperty(exports, "MeshData", { enumerable: true, get: function () { return meshdata_1.MeshData; } });

package/build/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@hotmeshio/hotmesh",
-    "version": "0.3.31",
-    "description": "Serverless Workflow",
+    "version": "0.4.0",
+    "description": "Permanent-Memory Workflows & AI Agents",
     "main": "./build/index.js",
     "types": "./build/index.d.ts",
     "homepage": "https://hotmesh.io/",
@@ -14,6 +14,8 @@
         "obfuscate": "ts-node scripts/obfuscate.ts",
         "clean-build": "npm run clean && npm run build",
         "clean-build-obfuscate": "npm run clean-build && npm run obfuscate",
+        "docs": "typedoc",
+        "docs:clean": "rimraf ./docs/hotmesh && typedoc",
         "lint": "eslint . --ext .ts",
         "lint:fix": "eslint . --fix --ext .ts",
         "start": "ts-node src/index.ts",
@@ -26,20 +28,21 @@
         "test:connect:redis": "NODE_ENV=test jest ./tests/unit/services/connector/providers/redis.test.ts --detectOpenHandles --forceExit --verbose",
         "test:connect:nats": "NODE_ENV=test jest ./tests/unit/services/connector/providers/nats.test.ts --detectOpenHandles --forceExit --verbose",
         "test:cycle": "NODE_ENV=test jest ./tests/functional/cycle/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshflow": "NODE_ENV=test jest ./tests/meshflow/*/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshflow:basic": "HMSH_LOGLEVEL=info NODE_ENV=test jest ./tests/meshflow/basic/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshflow:collision": "NODE_ENV=test jest ./tests/meshflow/collision/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshflow:fatal": "NODE_ENV=test jest ./tests/meshflow/fatal/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshflow:goodbye": "NODE_ENV=test jest ./tests/meshflow/goodbye/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshflow:hello": "HMSH_TELEMETRY=debug HMSH_LOGLEVEL=debug HMSH_IS_CLUSTER=true NODE_ENV=test jest ./tests/meshflow/helloworld/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshflow:hook": "NODE_ENV=test jest ./tests/meshflow/hook/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshflow:interrupt": "NODE_ENV=test jest ./tests/meshflow/interrupt/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshflow:loopactivity": "NODE_ENV=test jest ./tests/meshflow/loopactivity/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshflow:nested": "NODE_ENV=test jest ./tests/meshflow/nested/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshflow:retry": "NODE_ENV=test jest ./tests/meshflow/retry/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshflow:sleep": "NODE_ENV=test jest ./tests/meshflow/sleep/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshflow:signal": "NODE_ENV=test jest ./tests/meshflow/signal/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshflow:unknown": "NODE_ENV=test jest ./tests/meshflow/unknown/*.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow": "NODE_ENV=test jest ./tests/memflow/*/*.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:basic": "HMSH_LOGLEVEL=info NODE_ENV=test jest ./tests/memflow/basic/postgres.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:collision": "NODE_ENV=test jest ./tests/memflow/collision/*.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:fatal": "NODE_ENV=test jest ./tests/memflow/fatal/*.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:goodbye": "NODE_ENV=test jest ./tests/memflow/goodbye/*.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:context": "NODE_ENV=test jest ./tests/memflow/context/postgres.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:hello": "HMSH_TELEMETRY=debug HMSH_LOGLEVEL=debug HMSH_IS_CLUSTER=true NODE_ENV=test jest ./tests/memflow/helloworld/*.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:hook": "NODE_ENV=test jest ./tests/memflow/hook/*.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:interrupt": "NODE_ENV=test jest ./tests/memflow/interrupt/*.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:loopactivity": "NODE_ENV=test jest ./tests/memflow/loopactivity/*.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:nested": "NODE_ENV=test jest ./tests/memflow/nested/*.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:retry": "NODE_ENV=test jest ./tests/memflow/retry/*.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:sleep": "NODE_ENV=test jest ./tests/memflow/sleep/*.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:signal": "NODE_ENV=test jest ./tests/memflow/signal/*.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:unknown": "NODE_ENV=test jest ./tests/memflow/unknown/*.test.ts --detectOpenHandles --forceExit --verbose",
         "test:emit": "NODE_ENV=test jest ./tests/functional/emit/*.test.ts --detectOpenHandles --forceExit --verbose",
         "test:pending": "NODE_ENV=test jest ./tests/functional/pending/index.test.ts --detectOpenHandles --forceExit --verbose",
         "test:functional": "NODE_ENV=test jest ./tests/functional/* --detectOpenHandles --forceExit --verbose",
@@ -70,21 +73,19 @@
         "test:sub:postgres": "NODE_ENV=test jest ./tests/functional/sub/providers/postgres/postgres.test.ts --detectOpenHandles --forceExit --verbose",
         "test:sub:nats": "NODE_ENV=test jest ./tests/functional/sub/providers/nats/nats.test.ts --detectOpenHandles --forceExit --verbose",
         "test:trigger": "NODE_ENV=test jest ./tests/unit/services/activities/trigger.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshdata": "NODE_ENV=test jest ./tests/meshdata/*.test.ts --forceExit --verbose --detectOpenHandles",
+        "test:meshdata": "NODE_ENV=test jest ./tests/meshdata/postgres.test.ts --forceExit --verbose --detectOpenHandles",
         "test:meshos": "HMSH_LOGLEVEL=info NODE_ENV=test HMSH_IS_CLUSTER=true jest ./tests/meshos/*.test.ts --forceExit --verbose --detectOpenHandles",
         "test:meshcall": "NODE_ENV=test jest ./tests/meshcall/*.test.ts --forceExit --verbose --detectOpenHandles",
         "test:unit": "NODE_ENV=test jest ./tests/unit/*/*/index.test.ts --detectOpenHandles --forceExit --verbose"
     },
     "keywords": [
-        "Serverless Orchestration",
-        "Serverless Workflow",
+        "Headless Orchestration",
+        "Persistent Workflow",
         "Durable Workflow",
         "Operational Data",
-        "Saasless Apps",
         "Service Mesh",
         "HotMesh",
         "Postgres",
-        "Redis",
         "OLAP",
         "OLTP",
         "HTAP"

package/build/types/error.d.ts

@@ -1,4 +1,4 @@
-export type MeshFlowChildErrorType = {
+export type MemFlowChildErrorType = {
     arguments: string[];
     await?: boolean;
     backoffCoefficient?: number;
@@ -14,7 +14,7 @@ export type MeshFlowChildErrorType = {
     workflowId: string;
     workflowTopic: string;
 };
-export type MeshFlowWaitForAllErrorType = {
+export type MemFlowWaitForAllErrorType = {
     items: string[];
     workflowId: string;
     workflowTopic: string;
@@ -24,7 +24,7 @@ export type MeshFlowWaitForAllErrorType = {
     index: number;
     workflowDimension: string;
 };
-export type MeshFlowProxyErrorType = {
+export type MemFlowProxyErrorType = {
     arguments: string[];
     activityName: string;
     backoffCoefficient?: number;
@@ -38,13 +38,13 @@ export type MeshFlowProxyErrorType = {
     workflowId: string;
     workflowTopic: string;
 };
-export type MeshFlowWaitForErrorType = {
+export type MemFlowWaitForErrorType = {
     signalId: string;
     index: number;
     workflowDimension: string;
     workflowId: string;
 };
-export type MeshFlowSleepErrorType = {
+export type MemFlowSleepErrorType = {
     duration: number;
     index: number;
     workflowDimension: string;

package/build/types/exporter.d.ts

@@ -67,7 +67,7 @@ export interface TransitionType {
     created: string;
     updated: string;
 }
-export interface MeshFlowJobExport {
+export interface MemFlowJobExport {
     data?: StringAnyType;
     state?: StringAnyType;
     status?: number;

package/build/types/index.d.ts

@@ -3,9 +3,9 @@ export { App, AppVID, AppTransitions, AppSubscriptions } from './app';
 export { AsyncSignal } from './async';
 export { CacheMode } from './cache';
 export { CollationFaultType, CollationStage } from './collator';
-export { ActivityConfig, ActivityWorkflowDataType, ChildResponseType, ClientConfig, ClientWorkflow, ContextType, Connection, ProxyResponseType, ProxyType, Registry, SignalOptions, FindJobsOptions, FindOptions, FindWhereOptions, FindWhereQuery, HookOptions, SearchResults, WorkflowConfig, WorkerConfig, WorkerOptions, WorkflowContext, WorkflowSearchOptions, WorkflowSearchSchema, WorkflowDataType, WorkflowOptions, } from './meshflow';
-export { MeshFlowChildErrorType, MeshFlowProxyErrorType, MeshFlowSleepErrorType, MeshFlowWaitForAllErrorType, MeshFlowWaitForErrorType, } from './error';
-export { ActivityAction, DependencyExport, MeshFlowJobExport, ExportCycles, ExportItem, ExportOptions, ExportTransitions, JobAction, JobExport, JobActionExport, JobTimeline, } from './exporter';
+export { ActivityConfig, ActivityWorkflowDataType, ChildResponseType, ClientConfig, ClientWorkflow, ContextType, Connection, ProxyResponseType, ProxyType, Registry, SignalOptions, FindJobsOptions, FindOptions, FindWhereOptions, FindWhereQuery, HookOptions, SearchResults, WorkflowConfig, WorkerConfig, WorkerOptions, WorkflowContext, WorkflowSearchOptions, WorkflowSearchSchema, WorkflowDataType, WorkflowOptions, } from './memflow';
+export { MemFlowChildErrorType, MemFlowProxyErrorType, MemFlowSleepErrorType, MemFlowWaitForAllErrorType, MemFlowWaitForErrorType, } from './error';
+export { ActivityAction, DependencyExport, MemFlowJobExport, ExportCycles, ExportItem, ExportOptions, ExportTransitions, JobAction, JobExport, JobActionExport, JobTimeline, } from './exporter';
 export { HookCondition, HookConditions, HookGate, HookInterface, HookRule, HookRules, HookSignal, } from './hook';
 export { HotMesh, HotMeshEngine, HotMeshWorker, HotMeshSettings, HotMeshApp, HotMeshApps, HotMeshConfig, HotMeshManifest, HotMeshGraph, KeyType, KeyStoreParams, } from './hotmesh';
 export { ILogger, LogLevel } from './logger';

package/build/types/manifest.d.ts

@@ -1,5 +1,5 @@
 import { MeshOS } from '../services/meshos';
-import { WorkflowSearchSchema } from './meshflow';
+import { WorkflowSearchSchema } from './memflow';
 import { ProviderConfig, ProvidersConfig } from './provider';
 export type DB = {
     name: string;
@@ -30,7 +30,7 @@ export type Namespace = {
      */
     type: string;
     label: string;
-    module: 'hotmesh' | 'meshcall' | 'meshflow' | 'meshdata' | 'meshos';
+    module: 'hotmesh' | 'meshcall' | 'memflow' | 'meshdata' | 'meshos';
     entities: Entity[];
 };
 export type Namespaces = {

package/build/types/{meshflow.d.ts → memflow.d.ts}

@@ -1,4 +1,4 @@
-import { WorkflowHandleService } from '../services/meshflow/handle';
+import { WorkflowHandleService } from '../services/memflow/handle';
 import { LogLevel } from './logger';
 import { ProviderConfig, ProvidersConfig } from './provider';
 import { StringAnyType, StringStringType } from './serializer';
@@ -9,17 +9,17 @@ import { StreamData, StreamError } from './stream';
 type WorkflowConfig = {
     /**
      * Backoff coefficient for retry mechanism.
-     * @default 10 (HMSH_MESHFLOW_EXP_BACKOFF)
+     * @default 10 (HMSH_MEMFLOW_EXP_BACKOFF)
      */
     backoffCoefficient?: number;
     /**
      * Maximum number of attempts for retries.
-     * @default 5 (HMSH_MESHFLOW_MAX_ATTEMPTS)
+     * @default 5 (HMSH_MEMFLOW_MAX_ATTEMPTS)
      */
     maximumAttempts?: number;
     /**
      * Maximum interval between retries.
-     * @default 120s (HMSH_MESHFLOW_MAX_INTERVAL)
+     * @default 120s (HMSH_MEMFLOW_MAX_INTERVAL)
      */
     maximumInterval?: string;
     /**
@@ -55,7 +55,7 @@ type WorkflowContext = {
     replay: StringStringType;
     /**
      * the HotMesh App namespace
-     * @default meshflow
+     * @default memflow
      */
     namespace: string;
     /**
@@ -212,7 +212,7 @@ type SearchResults = {
 type WorkflowOptions = {
     /**
      * the namespace for the workflow
-     * @default meshflow
+     * @default memflow
      */
     namespace?: string;
     /**
@@ -299,7 +299,7 @@ type WorkflowOptions = {
 };
 /**
  * Options for setting up a hook.
- * 'meshflow' is the default namespace if not provided;
+ * 'memflow' is the default namespace if not provided;
  * similar to setting `appid` in the YAML
  */
 type HookOptions = {
@@ -372,7 +372,7 @@ type WorkerConfig = {
     connection: Connection;
     /**
      * Namespace used in the app configuration, denoted as `appid` in the YAML
-     * @default meshflow
+     * @default memflow
      */
     namespace?: string;
     /** Task queue name, denoted as `subscribes` in the YAML (e.g., 'hello-world') */
@@ -418,7 +418,7 @@ type FindJobsOptions = {
     match?: string;
     /**
      * application namespace
-     * @default meshflow
+     * @default memflow
      */
     namespace?: string;
     /** The suggested response limit. Reduce batch size to reduce the likelihood of large overages. */
@@ -431,11 +431,11 @@ type FindJobsOptions = {
 type WorkerOptions = {
     /** Log level: debug, info, warn, error */
     logLevel?: LogLevel;
-    /** Maximum number of attempts, default 5 (HMSH_MESHFLOW_MAX_ATTEMPTS) */
+    /** Maximum number of attempts, default 5 (HMSH_MEMFLOW_MAX_ATTEMPTS) */
     maximumAttempts?: number;
-    /** Backoff coefficient for retry logic, default 10 (HMSH_MESHFLOW_EXP_BACKOFF) */
+    /** Backoff coefficient for retry logic, default 10 (HMSH_MEMFLOW_EXP_BACKOFF) */
     backoffCoefficient?: number;
-    /** Maximum interval between retries, default 120s (HMSH_MESHFLOW_MAX_INTERVAL) */
+    /** Maximum interval between retries, default 120s (HMSH_MEMFLOW_MAX_INTERVAL) */
     maximumInterval?: string;
 };
 type ContextType = {
@@ -458,11 +458,11 @@ type ActivityConfig = {
     activities?: any;
     /** Retry policy configuration for activities */
     retryPolicy?: {
-        /** Maximum number of retry attempts, default is 5 (HMSH_MESHFLOW_MAX_ATTEMPTS) */
+        /** Maximum number of retry attempts, default is 5 (HMSH_MEMFLOW_MAX_ATTEMPTS) */
         maximumAttempts?: number;
-        /** Factor by which the retry timeout increases, default is 10 (HMSH_MESHFLOW_MAX_INTERVAL) */
+        /** Factor by which the retry timeout increases, default is 10 (HMSH_MEMFLOW_MAX_INTERVAL) */
         backoffCoefficient?: number;
-        /** Maximum interval between retries, default is '120s' (HMSH_MESHFLOW_EXP_BACKOFF) */
+        /** Maximum interval between retries, default is '120s' (HMSH_MEMFLOW_EXP_BACKOFF) */
         maximumInterval?: string;
         /** Whether to throw an error on failure, default is true */
         throwOnError?: boolean;

package/build/types/meshdata.d.ts

@@ -1,4 +1,4 @@
-import { HookOptions, WorkflowConfig, WorkflowSearchOptions } from './meshflow';
+import { HookOptions, WorkflowConfig, WorkflowSearchOptions } from './memflow';
 import { StringStringType } from './serializer';
 export type CallOptions = {
     /**
@@ -36,7 +36,7 @@ export type CallOptions = {
     fields?: string[];
     /**
      * namespace for the the execution client
-     * @default 'meshflow'
+     * @default 'memflow'
      */
     namespace?: string;
     /**
@@ -68,7 +68,7 @@ export type ConnectOptions = {
     prefix?: string;
     /**
      * optional namespace for the the worker
-     * @default 'meshflow'
+     * @default 'memflow'
      */
     namespace?: string;
     /**

package/build/types/postgres.d.ts

@@ -16,10 +16,17 @@ export type PostgresPoolType = {
     connect: (options: PostgresClientOptions) => Promise<PostgresClientType>;
     query: (text: string, values?: any[]) => Promise<PostgresQueryResultType>;
 };
+export interface PostgresNotification {
+    channel: string;
+    payload: string;
+}
 export interface PostgresClientType {
     connect: () => Promise<PostgresClientType>;
     query: (text: string, values?: any[]) => Promise<PostgresQueryResultType>;
     end: () => Promise<void>;
+    on?: (event: 'notification', listener: (notification: PostgresNotification) => void) => void;
+    off?: (event: 'notification', listener: (notification: PostgresNotification) => void) => void;
+    removeAllListeners?: (event?: string) => void;
 }
 export interface PostgresPoolClientType {
     connect: () => Promise<PostgresClientType>;

package/build/types/stream.d.ts

@@ -152,6 +152,9 @@ export interface StreamConfig {
         vacuumInterval?: number;
         partitionInterval?: 'daily' | 'weekly' | 'monthly';
         cleanupInterval?: number;
+        enableNotifications?: boolean;
+        notificationFallbackInterval?: number;
+        notificationTimeout?: number;
     };
     nats?: {
         jetstream?: boolean;

package/index.ts

@@ -1,14 +1,14 @@
 import { HotMesh } from './services/hotmesh';
 import { HotMeshConfig } from './types/hotmesh';
 import { MeshCall } from './services/meshcall';
-import { MeshFlow } from './services/meshflow';
-import { ClientService as Client } from './services/meshflow/client';
-import { ConnectionService as Connection } from './services/meshflow/connection';
-import { Search } from './services/meshflow/search';
-import { WorkerService as Worker } from './services/meshflow/worker';
-import { WorkflowService as workflow } from './services/meshflow/workflow';
-import { WorkflowHandleService as WorkflowHandle } from './services/meshflow/handle';
-import { proxyActivities } from './services/meshflow/workflow/proxyActivities';
+import { MemFlow } from './services/memflow';
+import { ClientService as Client } from './services/memflow/client';
+import { ConnectionService as Connection } from './services/memflow/connection';
+import { Search } from './services/memflow/search';
+import { WorkerService as Worker } from './services/memflow/worker';
+import { WorkflowService as workflow } from './services/memflow/workflow';
+import { WorkflowHandleService as WorkflowHandle } from './services/memflow/handle';
+import { proxyActivities } from './services/memflow/workflow/proxyActivities';
 import { MeshData } from './services/meshdata';
 import { MeshOS } from './services/meshos';
 import * as Errors from './modules/errors';
@@ -21,7 +21,7 @@ import { RedisConnection as ConnectorIORedis } from './services/connector/provid
 import { RedisConnection as ConnectorRedis } from './services/connector/providers/redis';
 import { NatsConnection as ConnectorNATS } from './services/connector/providers/nats';
 
-//const { Client, Connection, Search, Worker, workflow } = MeshFlow;
+//const { Client, Connection, Search, Worker, workflow } = MemFlow;
 
 export {
   //Provider Connectors
@@ -36,10 +36,10 @@ export {
   HotMeshConfig,
   MeshCall,
   MeshData,
-  MeshFlow,
+  MemFlow,
   MeshOS,
 
-  //MeshFlow Submodules
+  //MemFlow Submodules
   Client,
   Connection,
   proxyActivities,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hotmeshio/hotmesh",
-  "version": "0.3.31",
-  "description": "Serverless Workflow",
+  "version": "0.4.0",
+  "description": "Permanent-Memory Workflows & AI Agents",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
   "homepage": "https://hotmesh.io/",
@@ -14,6 +14,8 @@
     "obfuscate": "ts-node scripts/obfuscate.ts",
     "clean-build": "npm run clean && npm run build",
     "clean-build-obfuscate": "npm run clean-build && npm run obfuscate",
+    "docs": "typedoc",
+    "docs:clean": "rimraf ./docs/hotmesh && typedoc",
     "lint": "eslint . --ext .ts",
     "lint:fix": "eslint . --fix --ext .ts",
     "start": "ts-node src/index.ts",
@@ -26,20 +28,21 @@
     "test:connect:redis": "NODE_ENV=test jest ./tests/unit/services/connector/providers/redis.test.ts --detectOpenHandles --forceExit --verbose",
     "test:connect:nats": "NODE_ENV=test jest ./tests/unit/services/connector/providers/nats.test.ts --detectOpenHandles --forceExit --verbose",
     "test:cycle": "NODE_ENV=test jest ./tests/functional/cycle/*.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshflow": "NODE_ENV=test jest ./tests/meshflow/*/*.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshflow:basic": "HMSH_LOGLEVEL=info NODE_ENV=test jest ./tests/meshflow/basic/*.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshflow:collision": "NODE_ENV=test jest ./tests/meshflow/collision/*.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshflow:fatal": "NODE_ENV=test jest ./tests/meshflow/fatal/*.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshflow:goodbye": "NODE_ENV=test jest ./tests/meshflow/goodbye/*.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshflow:hello": "HMSH_TELEMETRY=debug HMSH_LOGLEVEL=debug HMSH_IS_CLUSTER=true NODE_ENV=test jest ./tests/meshflow/helloworld/*.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshflow:hook": "NODE_ENV=test jest ./tests/meshflow/hook/*.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshflow:interrupt": "NODE_ENV=test jest ./tests/meshflow/interrupt/*.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshflow:loopactivity": "NODE_ENV=test jest ./tests/meshflow/loopactivity/*.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshflow:nested": "NODE_ENV=test jest ./tests/meshflow/nested/*.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshflow:retry": "NODE_ENV=test jest ./tests/meshflow/retry/*.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshflow:sleep": "NODE_ENV=test jest ./tests/meshflow/sleep/*.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshflow:signal": "NODE_ENV=test jest ./tests/meshflow/signal/*.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshflow:unknown": "NODE_ENV=test jest ./tests/meshflow/unknown/*.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow": "NODE_ENV=test jest ./tests/memflow/*/*.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:basic": "HMSH_LOGLEVEL=info NODE_ENV=test jest ./tests/memflow/basic/postgres.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:collision": "NODE_ENV=test jest ./tests/memflow/collision/*.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:fatal": "NODE_ENV=test jest ./tests/memflow/fatal/*.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:goodbye": "NODE_ENV=test jest ./tests/memflow/goodbye/*.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:context": "NODE_ENV=test jest ./tests/memflow/context/postgres.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:hello": "HMSH_TELEMETRY=debug HMSH_LOGLEVEL=debug HMSH_IS_CLUSTER=true NODE_ENV=test jest ./tests/memflow/helloworld/*.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:hook": "NODE_ENV=test jest ./tests/memflow/hook/*.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:interrupt": "NODE_ENV=test jest ./tests/memflow/interrupt/*.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:loopactivity": "NODE_ENV=test jest ./tests/memflow/loopactivity/*.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:nested": "NODE_ENV=test jest ./tests/memflow/nested/*.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:retry": "NODE_ENV=test jest ./tests/memflow/retry/*.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:sleep": "NODE_ENV=test jest ./tests/memflow/sleep/*.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:signal": "NODE_ENV=test jest ./tests/memflow/signal/*.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:unknown": "NODE_ENV=test jest ./tests/memflow/unknown/*.test.ts --detectOpenHandles --forceExit --verbose",
     "test:emit": "NODE_ENV=test jest ./tests/functional/emit/*.test.ts --detectOpenHandles --forceExit --verbose",
     "test:pending": "NODE_ENV=test jest ./tests/functional/pending/index.test.ts --detectOpenHandles --forceExit --verbose",
     "test:functional": "NODE_ENV=test jest ./tests/functional/* --detectOpenHandles --forceExit --verbose",
@@ -70,21 +73,19 @@
     "test:sub:postgres": "NODE_ENV=test jest ./tests/functional/sub/providers/postgres/postgres.test.ts --detectOpenHandles --forceExit --verbose",
     "test:sub:nats": "NODE_ENV=test jest ./tests/functional/sub/providers/nats/nats.test.ts --detectOpenHandles --forceExit --verbose",
     "test:trigger": "NODE_ENV=test jest ./tests/unit/services/activities/trigger.test.ts --detectOpenHandles --forceExit --verbose",
-    "test:meshdata": "NODE_ENV=test jest ./tests/meshdata/*.test.ts --forceExit --verbose --detectOpenHandles",
+    "test:meshdata": "NODE_ENV=test jest ./tests/meshdata/postgres.test.ts --forceExit --verbose --detectOpenHandles",
     "test:meshos": "HMSH_LOGLEVEL=info NODE_ENV=test HMSH_IS_CLUSTER=true jest ./tests/meshos/*.test.ts --forceExit --verbose --detectOpenHandles",
     "test:meshcall": "NODE_ENV=test jest ./tests/meshcall/*.test.ts --forceExit --verbose --detectOpenHandles",
     "test:unit": "NODE_ENV=test jest ./tests/unit/*/*/index.test.ts --detectOpenHandles --forceExit --verbose"
   },
   "keywords": [
-    "Serverless Orchestration",
-    "Serverless Workflow",
+    "Headless Orchestration",
+    "Persistent Workflow",
     "Durable Workflow",
     "Operational Data",
-    "Saasless Apps",
     "Service Mesh",
     "HotMesh",
     "Postgres",
-    "Redis",
     "OLAP",
     "OLTP",
     "HTAP"

package/typedoc.json

@@ -9,13 +9,14 @@
     "services/hotmesh/index.ts",
     "services/meshcall/index.ts",
     "services/meshdata/index.ts",
-    "services/meshflow/index.ts",
-    "services/meshflow/client.ts",
-    "services/meshflow/handle.ts",
-    "services/meshflow/search.ts",
-    "services/meshflow/worker.ts",
-    "services/meshflow/workflow.ts",
-    "services/meshflow/connection.ts",
+    "services/memflow/index.ts",
+    "services/memflow/client.ts",
+    "services/memflow/handle.ts",
+    "services/memflow/search.ts",
+    "services/memflow/context.ts",
+    "services/memflow/worker.ts",
+    "services/memflow/workflow.ts",
+    "services/memflow/connection.ts",
     "services/meshos/index.ts",
     "services/search/index.ts",
     "services/store/index.ts",

package/types/error.ts

@@ -1,4 +1,4 @@
-export type MeshFlowChildErrorType = {
+export type MemFlowChildErrorType = {
   arguments: string[];
   await?: boolean;
   backoffCoefficient?: number;
@@ -15,7 +15,7 @@ export type MeshFlowChildErrorType = {
   workflowTopic: string;
 };
 
-export type MeshFlowWaitForAllErrorType = {
+export type MemFlowWaitForAllErrorType = {
   items: string[];
   workflowId: string;
   workflowTopic: string;
@@ -26,7 +26,7 @@ export type MeshFlowWaitForAllErrorType = {
   workflowDimension: string;
 };
 
-export type MeshFlowProxyErrorType = {
+export type MemFlowProxyErrorType = {
   arguments: string[];
   activityName: string;
   backoffCoefficient?: number;
@@ -41,14 +41,14 @@ export type MeshFlowProxyErrorType = {
   workflowTopic: string;
 };
 
-export type MeshFlowWaitForErrorType = {
+export type MemFlowWaitForErrorType = {
   signalId: string;
   index: number;
   workflowDimension: string;
   workflowId: string;
 };
 
-export type MeshFlowSleepErrorType = {
+export type MemFlowSleepErrorType = {
   duration: number;
   index: number;
   workflowDimension: string;

package/types/exporter.ts

@@ -87,7 +87,7 @@ export interface TransitionType {
   updated: string;
 }
 
-export interface MeshFlowJobExport {
+export interface MemFlowJobExport {
   data?: StringAnyType;
   state?: StringAnyType;
   status?: number;

package/types/index.ts

@@ -47,18 +47,18 @@ export {
   WorkflowSearchSchema,
   WorkflowDataType,
   WorkflowOptions,
-} from './meshflow';
+} from './memflow';
 export {
-  MeshFlowChildErrorType,
-  MeshFlowProxyErrorType,
-  MeshFlowSleepErrorType,
-  MeshFlowWaitForAllErrorType,
-  MeshFlowWaitForErrorType,
+  MemFlowChildErrorType,
+  MemFlowProxyErrorType,
+  MemFlowSleepErrorType,
+  MemFlowWaitForAllErrorType,
+  MemFlowWaitForErrorType,
 } from './error';
 export {
   ActivityAction,
   DependencyExport,
-  MeshFlowJobExport,
+  MemFlowJobExport,
   ExportCycles,
   ExportItem,
   ExportOptions,