@hotmeshio/hotmesh 0.4.2 → 0.4.3

package/README.md

@@ -4,12 +4,12 @@
 
 ![beta release](https://img.shields.io/badge/release-beta-blue.svg)  ![made with typescript](https://img.shields.io/badge/built%20with-typescript-lightblue.svg)
 
-**HotMesh** is a Temporal-style workflow engine that runs natively on PostgreSQL — with a powerful twist: every workflow maintains a permanent, JSON-backed context that persists independently of the workflow itself.
+**HotMesh** is a Temporal-style workflow engine that runs natively on PostgreSQL — with a powerful twist: every workflow maintains permanent, state that persists independently of the workflow itself.
 
 This means:
 
 * Any number of lightweight, thread-safe **hook workers** can attach to the same workflow record at any time.
-* These hooks can safely **read and incrementally write** to shared state.
+* These hooks can safely **read and write** to shared state.
 * The result is a **durable execution model** with **evolving memory**, ideal for **human-in-the-loop processes** and **AI agents that learn over time**.
 
 ---
@@ -18,7 +18,7 @@ This means:
 
 1. 🚀 Quick Start
 2. 🧠 How Permanent Memory Works
-3. 🔌 Hooks & Context API
+3. 🔌 Hooks & Entity API
 4. 🤖 Building Durable AI Agents
 5. 🔬 Advanced Patterns & Recipes
 6. 📚 Documentation & Links
@@ -51,9 +51,11 @@ async function main() {
 
   // Kick off a workflow
   const handle = await mf.workflow.start({
-    workflowName: 'example',
+    entity: 'user',
+    workflowName: 'userExample',
+    workflowId: 'jane@hotmesh.com',
     args: ['Jane'],
-    taskQueue: 'contextual'
+    taskQueue: 'entityqueue'
   });
 
   console.log('Result:', await handle.result());
@@ -66,17 +68,16 @@ main().catch(console.error);
 
 ## 🧠 How Permanent Memory Works
 
-* **Context = persistent JSON record** – each workflow's memory is stored as a JSONB row in your Postgres database
+* **Entity = persistent JSON record** – each workflow's memory is stored as a JSONB row in your Postgres database
 * **Atomic operations** (`set`, `merge`, `append`, `increment`, `toggle`, `delete`, …)
 * **Transactional** – every update participates in the workflow/DB transaction
 * **Time-travel-safe** – full replay compatibility; side-effect detector guarantees determinism
 * **Hook-friendly** – any worker with the record ID can attach and mutate its slice of the JSON
-
-* Context data is stored as JSONB; add partial indexes for improved query analysis.
+* **Index-friendly** - entity data is stored as JSONB; add partial indexes for improved query analysis.
 
 **Example: Adding a Partial Index for Specific Entity Types**
 ```sql
--- Create a partial index for 'user' entities with specific context values
+-- Create a partial index for 'user' entities with specific entity values
 CREATE INDEX idx_user_premium ON your_app.jobs (id)
 WHERE entity = 'user' AND (context->>'isPremium')::boolean = true;
 ```
@@ -84,42 +85,44 @@ This index will only be used for queries that match both conditions, making look
 
 ---
 
-## 🔌 Hooks & Context API – Full Example
+## 🔌 Hooks & Entity API – Full Example
+
+HotMesh hooks are powerful because they can be called both internally (from within a workflow) and externally (from outside, even after the workflow completes). This means you can:
+
+* Start a workflow that sets up initial state
+* Have the workflow call some hooks internally
+* Let the workflow complete
+* Continue to update the workflow's entity state from the outside via hooks
+* Build long-running processes that evolve over time
+
+Here's a complete example showing both internal and external hook usage:
 
 ```typescript
 import { MemFlow } from '@hotmeshio/hotmesh';
 
 /* ------------ Main workflow ------------ */
-export async function example(name: string): Promise<any> {
-  //the context method provides transactional, replayable access to shared job state 
-  const ctx = await MemFlow.workflow.context();
+export async function userExample(name: string): Promise<any> {
+  //the entity method provides transactional, replayable access to shared job state 
+  const entity = await MemFlow.workflow.entity();
 
-  //create the initial context (even arrays are supported)
-  await ctx.set({
+  //create the initial entity (even arrays are supported)
+  await entity.set({
     user: { name },
     hooks: {},
     metrics: { count: 0 }
   });
 
-  // Call two hooks in parallel to updaet the same shared context
-  const [r1, r2] = await Promise.all([
-    MemFlow.workflow.execHook({
-      taskQueue: 'contextual',
-      workflowName: 'hook1',
-      args: [name, 'hook1'],
-      signalId: 'hook1-complete',
-    }),
-    MemFlow.workflow.execHook({
-      taskQueue: 'contextual',
-      workflowName: 'hook2',
-      args: [name, 'hook2'],
-      signalId: 'hook2-complete',
-    })
-  ]);
-
-  // merge here (or have the hooks merge in...everyone can access context)
-  await ctx.merge({ hooks: { r1, r2 } });
-  await ctx.increment('metrics.count', 2);
+  // Call one hook internally
+  const result1 = await MemFlow.workflow.execHook({
+    taskQueue: 'entityqueue',
+    workflowName: 'hook1',
+    args: [name, 'hook1'],
+    signalId: 'hook1-complete'
+  });
+
+  // merge the result
+  await entity.merge({ hooks: { r1: result1 } });
+  await entity.increment('metrics.count', 1);
 
   return "The main has completed; the db record persists and can be hydrated; hook in from the outside!";
 }
@@ -131,10 +134,10 @@ export async function hook1(name: string, kind: string): Promise<any> {
   await MemFlow.workflow.signal('hook1-complete', res);
 }
 
-/* ------------ Hook 2 (hooks can access shared job context) ------------ */
+/* ------------ Hook 2 (hooks can access shared job entity) ------------ */
 export async function hook2(name: string, kind: string): Promise<void> {
-  const ctx = await MemFlow.workflow.context();
-  await ctx.merge({ user: { lastSeen: new Date().toISOString() } });
+  const entity = await MemFlow.workflow.entity();
+  await entity.merge({ user: { lastSeen: new Date().toISOString() } });
   await MemFlow.workflow.signal('hook2-complete', { ok: true });
 }
 
@@ -151,17 +154,17 @@ async function startWorker() {
   });
 
   const worker = await mf.worker.create({
-    taskQueue: 'contextual',
+    taskQueue: 'entityqueue',
     workflow: example
   });
 
   await mf.worker.create({
-    taskQueue: 'contextual',
+    taskQueue: 'entityqueue',
     workflow: hook1
   });
 
   await mf.worker.create({
-    taskQueue: 'contextual',
+    taskQueue: 'entityqueue',
     workflow: hook2
   });
 
@@ -169,16 +172,51 @@ async function startWorker() {
 }
 ```
 
+### The Power of External Hooks
+
+One of HotMesh's most powerful features is that workflow entities remain accessible even after the main workflow completes. By providing the original workflow ID, any authorized client can:
+
+* Hook into existing workflow entities
+* Update state and trigger new processing
+* Build evolving, long-running processes
+* Enable human-in-the-loop workflows
+* Create AI agents that learn over time
+
+Here's how to hook into an existing workflow from the outside:
+
+```typescript
+/* ------------ External Hook Example ------------ */
+async function externalHookExample() {
+  const client = new MemFlow.Client({
+    appId: 'my-app',
+    engine: {
+      connection: {
+        class: Postgres,
+        options: { connectionString: process.env.DATABASE_URL }
+      }
+    }
+  });
+
+  // Start hook2 externally by providing the original workflow ID
+  await client.workflow.hook({
+    workflowId: 'jane@hotmesh.com', //id of the target workflow
+    taskQueue: 'entityqueue',
+    workflowName: 'hook2',
+    args: [name, 'external-hook']
+  });
+}
+```
+
 ---
 
 ## 🤖 Building Durable AI Agents
 
 Permanent memory unlocks a straightforward pattern for agentic systems:
 
-1. **Planner workflow** – sketches a task list, seeds context.
-2. **Tool hooks** – execute individual tasks, feeding intermediate results back into context.
-3. **Reflector hook** – periodically summarises context into long-term memory embeddings.
-4. **Supervisor workflow** – monitors metrics stored in context and decides when to finish.
+1. **Planner workflow** – sketches a task list, seeds entity state.
+2. **Tool hooks** – execute individual tasks, feeding intermediate results back into state.
+3. **Reflector hook** – periodically summarizes state into long-term memory embeddings.
+4. **Supervisor workflow** – monitors metrics stored in state and decides when to finish.
 
 Because every step is durable *and* shares the same knowledge object, agents can pause,
 restart, scale horizontally, and keep evolving their world-model indefinitely.

package/build/index.d.ts

@@ -5,6 +5,7 @@ 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 { Entity } from './services/memflow/entity';
 import { WorkerService as Worker } from './services/memflow/worker';
 import { WorkflowService as workflow } from './services/memflow/workflow';
 import { WorkflowHandleService as WorkflowHandle } from './services/memflow/handle';
@@ -21,5 +22,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, MemFlow, 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, Entity, Worker, workflow, WorkflowHandle, Enums, Errors, Utils, KeyStore, };
 export * as Types from './types';

package/build/index.js

@@ -23,7 +23,7 @@ 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.MemFlow = 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.Entity = 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");
@@ -36,6 +36,8 @@ const connection_1 = require("./services/memflow/connection");
 Object.defineProperty(exports, "Connection", { enumerable: true, get: function () { return connection_1.ConnectionService; } });
 const search_1 = require("./services/memflow/search");
 Object.defineProperty(exports, "Search", { enumerable: true, get: function () { return search_1.Search; } });
+const entity_1 = require("./services/memflow/entity");
+Object.defineProperty(exports, "Entity", { enumerable: true, get: function () { return entity_1.Entity; } });
 const worker_1 = require("./services/memflow/worker");
 Object.defineProperty(exports, "Worker", { enumerable: true, get: function () { return worker_1.WorkerService; } });
 const workflow_1 = require("./services/memflow/workflow");

package/build/package.json

@@ -33,7 +33,8 @@
         "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:entity": "NODE_ENV=test HMSH_LOGLEVEL=debug jest ./tests/memflow/entity/postgres.test.ts --detectOpenHandles --forceExit --verbose",
+        "test:memflow:agent": "NODE_ENV=test HMSH_LOGLEVEL=debug jest ./tests/memflow/agent/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",

package/build/services/activities/trigger.d.ts

@@ -31,7 +31,7 @@ declare class Trigger extends Activity {
     getJobStatus(): number;
     resolveJobId(context: Partial<JobState>): string;
     resolveJobKey(context: Partial<JobState>): string;
-    setStateNX(status?: number): Promise<void>;
+    setStateNX(status?: number, entity?: string): Promise<void>;
     setStats(transaction?: ProviderTransaction): Promise<void>;
 }
 export { Trigger };

package/build/services/activities/trigger.js

@@ -27,7 +27,7 @@ class Trigger extends activity_1.Activity {
             this.mapJobData();
             this.adjacencyList = await this.filterAdjacent();
             const initialStatus = this.initStatus(options, this.adjacencyList.length);
-            await this.setStateNX(initialStatus);
+            await this.setStateNX(initialStatus, options?.entity);
             await this.setStatus(initialStatus);
             this.bindSearchData(options);
             this.bindMarkerData(options);
@@ -228,9 +228,9 @@ class Trigger extends activity_1.Activity {
         const jobKey = this.config.stats?.key;
         return jobKey ? pipe_1.Pipe.resolve(jobKey, context) : '';
     }
-    async setStateNX(status) {
+    async setStateNX(status, entity) {
         const jobId = this.context.metadata.jid;
-        if (!await this.store.setStateNX(jobId, this.engine.appId, status)) {
+        if (!await this.store.setStateNX(jobId, this.engine.appId, status, entity)) {
             throw new errors_1.DuplicateJobError(jobId);
         }
     }

package/build/services/memflow/client.js

@@ -125,7 +125,7 @@ class ClientService {
              */
             start: async (options) => {
                 const taskQueueName = options.taskQueue ?? options.entity;
-                const workflowName = options.entity ?? options.workflowName;
+                const workflowName = options.taskQueue ? options.workflowName : (options.entity ?? options.workflowName);
                 const trc = options.workflowTrace;
                 const spn = options.workflowSpan;
                 //hotmesh `topic` is equivalent to `queue+workflowname` pattern in other systems
@@ -151,6 +151,7 @@ class ClientService {
                     search: options?.search?.data,
                     marker: options?.marker,
                     pending: options?.pending,
+                    entity: options?.entity,
                 });
                 return new handle_1.WorkflowHandleService(hotMeshClient, workflowTopic, jobId);
             },

package/build/services/memflow/{context.d.ts → entity.d.ts}

@@ -1,26 +1,26 @@
 import { HotMesh } from '../hotmesh';
 import { SearchService } from '../search';
 /**
- * The Context module provides methods for reading and writing
- * JSONB data to a workflow's context. The instance methods
+ * The Entity module provides methods for reading and writing
+ * JSONB data to a workflow's entity. The instance methods
  * exposed by this class are available for use from within
  * a running workflow.
  *
  * @example
  * ```typescript
- * //contextWorkflow.ts
+ * //entityWorkflow.ts
  * import { workflow } from '@hotmeshio/hotmesh';
  *
- * export async function contextExample(): Promise<void> {
- *   const context = await workflow.context();
- *   await context.set({ user: { id: 123 } });
- *   await context.merge({ user: { name: "John" } });
- *   const user = await context.get("user");
+ * export async function entityExample(): Promise<void> {
+ *   const entity = await workflow.entity();
+ *   await entity.set({ user: { id: 123 } });
+ *   await entity.merge({ user: { name: "John" } });
+ *   const user = await entity.get("user");
  *   // user = { id: 123, name: "John" }
  * }
  * ```
  */
-export declare class Context {
+export declare class Entity {
     /**
      * @private
      */
@@ -56,84 +56,84 @@ export declare class Context {
      */
     getSearchSessionGuid(): string;
     /**
-     * Sets the entire context object. This replaces any existing context.
+     * Sets the entire entity object. This replaces any existing entity.
      *
      * @example
-     * const context = await workflow.context();
-     * await context.set({ user: { id: 123, name: "John" } });
+     * const entity = await workflow.entity();
+     * await entity.set({ user: { id: 123, name: "John" } });
      */
     set(value: any): Promise<any>;
     /**
-     * Deep merges the provided object with the existing context
+     * Deep merges the provided object with the existing entity
      *
      * @example
-     * const context = await workflow.context();
-     * await context.merge({ user: { email: "john@example.com" } });
+     * const entity = await workflow.entity();
+     * await entity.merge({ user: { email: "john@example.com" } });
      */
     merge<T>(value: T): Promise<T>;
     /**
-     * Gets a value from the context by path
+     * Gets a value from the entity by path
      *
      * @example
-     * const context = await workflow.context();
-     * const user = await context.get("user");
-     * const email = await context.get("user.email");
+     * const entity = await workflow.entity();
+     * const user = await entity.get("user");
+     * const email = await entity.get("user.email");
      */
     get(path?: string): Promise<any>;
     /**
-     * Deletes a value from the context by path
+     * Deletes a value from the entity by path
      *
      * @example
-     * const context = await workflow.context();
-     * await context.delete("user.email");
+     * const entity = await workflow.entity();
+     * await entity.delete("user.email");
      */
     delete(path: string): Promise<any>;
     /**
      * Appends a value to an array at the specified path
      *
      * @example
-     * const context = await workflow.context();
-     * await context.append("items", { id: 1, name: "New Item" });
+     * const entity = await workflow.entity();
+     * await entity.append("items", { id: 1, name: "New Item" });
      */
     append(path: string, value: any): Promise<any[]>;
     /**
      * Prepends a value to an array at the specified path
      *
      * @example
-     * const context = await workflow.context();
-     * await context.prepend("items", { id: 0, name: "First Item" });
+     * const entity = await workflow.entity();
+     * await entity.prepend("items", { id: 0, name: "First Item" });
      */
     prepend(path: string, value: any): Promise<any[]>;
     /**
      * Removes an item from an array at the specified path and index
      *
      * @example
-     * const context = await workflow.context();
-     * await context.remove("items", 0); // Remove first item
+     * const entity = await workflow.entity();
+     * await entity.remove("items", 0); // Remove first item
      */
     remove(path: string, index: number): Promise<any[]>;
     /**
      * Increments a numeric value at the specified path
      *
      * @example
-     * const context = await workflow.context();
-     * await context.increment("counter", 5);
+     * const entity = await workflow.entity();
+     * await entity.increment("counter", 5);
      */
     increment(path: string, value?: number): Promise<number>;
     /**
      * Toggles a boolean value at the specified path
      *
      * @example
-     * const context = await workflow.context();
-     * await context.toggle("settings.enabled");
+     * const entity = await workflow.entity();
+     * await entity.toggle("settings.enabled");
      */
     toggle(path: string): Promise<boolean>;
     /**
      * Sets a value at the specified path only if it doesn't already exist
      *
      * @example
-     * const context = await workflow.context();
-     * await context.setIfNotExists("user.id", 123);
+     * const entity = await workflow.entity();
+     * await entity.setIfNotExists("user.id", 123);
      */
     setIfNotExists(path: string, value: any): Promise<any>;
     /**

package/build/services/memflow/{context.js → entity.js}

@@ -1,29 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Context = void 0;
+exports.Entity = void 0;
 const key_1 = require("../../modules/key");
 const storage_1 = require("../../modules/storage");
 /**
- * The Context module provides methods for reading and writing
- * JSONB data to a workflow's context. The instance methods
+ * The Entity module provides methods for reading and writing
+ * JSONB data to a workflow's entity. The instance methods
  * exposed by this class are available for use from within
  * a running workflow.
  *
  * @example
  * ```typescript
- * //contextWorkflow.ts
+ * //entityWorkflow.ts
  * import { workflow } from '@hotmeshio/hotmesh';
  *
- * export async function contextExample(): Promise<void> {
- *   const context = await workflow.context();
- *   await context.set({ user: { id: 123 } });
- *   await context.merge({ user: { name: "John" } });
- *   const user = await context.get("user");
+ * export async function entityExample(): Promise<void> {
+ *   const entity = await workflow.entity();
+ *   await entity.set({ user: { id: 123 } });
+ *   await entity.merge({ user: { name: "John" } });
+ *   const user = await entity.get("user");
  *   // user = { id: 123, name: "John" }
  * }
  * ```
  */
-class Context {
+class Entity {
     /**
      * @private
      */
@@ -53,11 +53,11 @@ class Context {
         return `${this.searchSessionId}-${this.searchSessionIndex++}-`;
     }
     /**
-     * Sets the entire context object. This replaces any existing context.
+     * Sets the entire entity object. This replaces any existing entity.
      *
      * @example
-     * const context = await workflow.context();
-     * await context.set({ user: { id: 123, name: "John" } });
+     * const entity = await workflow.entity();
+     * await entity.set({ user: { id: 123, name: "John" } });
      */
     async set(value) {
         const ssGuid = this.getSearchSessionGuid();
@@ -66,7 +66,7 @@ class Context {
         if (ssGuid in replay) {
             return JSON.parse(replay[ssGuid]);
         }
-        // Use single transactional call to update context and store replay value
+        // Use single transactional call to update entity and store replay value
         const result = await this.search.updateContext(this.jobId, {
             '@context': JSON.stringify(value),
             [ssGuid]: '', // Pass replay ID to hash module for transactional replay storage
@@ -74,11 +74,11 @@ class Context {
         return result || value;
     }
     /**
-     * Deep merges the provided object with the existing context
+     * Deep merges the provided object with the existing entity
      *
      * @example
-     * const context = await workflow.context();
-     * await context.merge({ user: { email: "john@example.com" } });
+     * const entity = await workflow.entity();
+     * await entity.merge({ user: { email: "john@example.com" } });
      */
     async merge(value) {
         const ssGuid = this.getSearchSessionGuid();
@@ -95,29 +95,29 @@ class Context {
         return newContext;
     }
     /**
-     * Gets a value from the context by path
+     * Gets a value from the entity by path
      *
      * @example
-     * const context = await workflow.context();
-     * const user = await context.get("user");
-     * const email = await context.get("user.email");
+     * const entity = await workflow.entity();
+     * const user = await entity.get("user");
+     * const email = await entity.get("user.email");
      */
     async get(path) {
         const ssGuid = this.getSearchSessionGuid();
         const store = storage_1.asyncLocalStorage.getStore();
         const replay = store?.get('replay') ?? {};
         if (ssGuid in replay) {
-            // Replay cache stores the already-extracted value, not full context
+            // Replay cache stores the already-extracted value, not full entity
             return JSON.parse(replay[ssGuid]);
         }
         let value;
         if (!path) {
-            // No path - fetch entire context with replay storage
+            // No path - fetch entire entity with replay storage
             const result = await this.search.updateContext(this.jobId, {
                 '@context:get': '',
                 [ssGuid]: '', // Pass replay ID to hash module
             });
-            // setFields returns the actual context value for @context:get operations
+            // setFields returns the actual entity value for @context:get operations
             value = result || {};
         }
         else {
@@ -132,11 +132,11 @@ class Context {
         return value;
     }
     /**
-     * Deletes a value from the context by path
+     * Deletes a value from the entity by path
      *
      * @example
-     * const context = await workflow.context();
-     * await context.delete("user.email");
+     * const entity = await workflow.entity();
+     * await entity.delete("user.email");
      */
     async delete(path) {
         const ssGuid = this.getSearchSessionGuid();
@@ -156,8 +156,8 @@ class Context {
      * Appends a value to an array at the specified path
      *
      * @example
-     * const context = await workflow.context();
-     * await context.append("items", { id: 1, name: "New Item" });
+     * const entity = await workflow.entity();
+     * await entity.append("items", { id: 1, name: "New Item" });
      */
     async append(path, value) {
         const ssGuid = this.getSearchSessionGuid();
@@ -177,8 +177,8 @@ class Context {
      * Prepends a value to an array at the specified path
      *
      * @example
-     * const context = await workflow.context();
-     * await context.prepend("items", { id: 0, name: "First Item" });
+     * const entity = await workflow.entity();
+     * await entity.prepend("items", { id: 0, name: "First Item" });
      */
     async prepend(path, value) {
         const ssGuid = this.getSearchSessionGuid();
@@ -198,8 +198,8 @@ class Context {
      * Removes an item from an array at the specified path and index
      *
      * @example
-     * const context = await workflow.context();
-     * await context.remove("items", 0); // Remove first item
+     * const entity = await workflow.entity();
+     * await entity.remove("items", 0); // Remove first item
      */
     async remove(path, index) {
         const ssGuid = this.getSearchSessionGuid();
@@ -219,8 +219,8 @@ class Context {
      * Increments a numeric value at the specified path
      *
      * @example
-     * const context = await workflow.context();
-     * await context.increment("counter", 5);
+     * const entity = await workflow.entity();
+     * await entity.increment("counter", 5);
      */
     async increment(path, value = 1) {
         const ssGuid = this.getSearchSessionGuid();
@@ -240,8 +240,8 @@ class Context {
      * Toggles a boolean value at the specified path
      *
      * @example
-     * const context = await workflow.context();
-     * await context.toggle("settings.enabled");
+     * const entity = await workflow.entity();
+     * await entity.toggle("settings.enabled");
      */
     async toggle(path) {
         const ssGuid = this.getSearchSessionGuid();
@@ -261,8 +261,8 @@ class Context {
      * Sets a value at the specified path only if it doesn't already exist
      *
      * @example
-     * const context = await workflow.context();
-     * await context.setIfNotExists("user.id", 123);
+     * const entity = await workflow.entity();
+     * await entity.setIfNotExists("user.id", 123);
      */
     async setIfNotExists(path, value) {
         const ssGuid = this.getSearchSessionGuid();
@@ -296,4 +296,4 @@ class Context {
         return output;
     }
 }
-exports.Context = Context;
+exports.Entity = Entity;

package/build/services/memflow/index.d.ts

@@ -2,7 +2,7 @@ import { ContextType } from '../../types/memflow';
 import { ClientService } from './client';
 import { ConnectionService } from './connection';
 import { Search } from './search';
-import { Context } from './context';
+import { Entity } from './entity';
 import { WorkerService } from './worker';
 import { WorkflowService } from './workflow';
 import { WorkflowHandleService } from './handle';
@@ -86,7 +86,7 @@ declare class MemFlowClass {
     /**
      * @private
      */
-    static Context: typeof Context;
+    static Entity: typeof Entity;
     /**
      * The Handle provides methods to interact with a running
      * workflow. This includes exporting the workflow, sending signals, and

package/build/services/memflow/index.js

@@ -5,7 +5,7 @@ const hotmesh_1 = require("../hotmesh");
 const client_1 = require("./client");
 const connection_1 = require("./connection");
 const search_1 = require("./search");
-const context_1 = require("./context");
+const entity_1 = require("./entity");
 const worker_1 = require("./worker");
 const workflow_1 = require("./workflow");
 const handle_1 = require("./handle");
@@ -100,7 +100,7 @@ MemFlowClass.Search = search_1.Search;
 /**
  * @private
  */
-MemFlowClass.Context = context_1.Context;
+MemFlowClass.Entity = entity_1.Entity;
 /**
  * The Handle provides methods to interact with a running
  * workflow. This includes exporting the workflow, sending signals, and

package/build/services/memflow/workflow/common.d.ts

@@ -15,6 +15,6 @@ import { QuorumMessage } from '../../../types';
 import { UserMessage } from '../../../types/quorum';
 import { Search } from '../search';
 import { WorkerService } from '../worker';
-import { Context } from '../context';
+import { Entity } from '../entity';
 import { ExecHookOptions } from './execHook';
-export { MemFlowChildError, MemFlowFatalError, MemFlowMaxedError, MemFlowProxyError, MemFlowRetryError, MemFlowSleepError, MemFlowTimeoutError, MemFlowWaitForError, KeyService, KeyType, asyncLocalStorage, deterministicRandom, guid, s, sleepImmediate, HotMesh, SerializerService, ActivityConfig, ChildResponseType, HookOptions, ExecHookOptions, ProxyResponseType, ProxyType, WorkflowContext, WorkflowOptions, JobInterruptOptions, StreamCode, StreamStatus, StringAnyType, StringScalarType, StringStringType, HMSH_CODE_MEMFLOW_CHILD, HMSH_CODE_MEMFLOW_FATAL, HMSH_CODE_MEMFLOW_MAXED, HMSH_CODE_MEMFLOW_PROXY, HMSH_CODE_MEMFLOW_SLEEP, HMSH_CODE_MEMFLOW_TIMEOUT, HMSH_CODE_MEMFLOW_WAIT, HMSH_MEMFLOW_EXP_BACKOFF, HMSH_MEMFLOW_MAX_ATTEMPTS, HMSH_MEMFLOW_MAX_INTERVAL, MemFlowChildErrorType, MemFlowProxyErrorType, TelemetryService, QuorumMessage, UserMessage, Search, WorkerService, Context, };
+export { MemFlowChildError, MemFlowFatalError, MemFlowMaxedError, MemFlowProxyError, MemFlowRetryError, MemFlowSleepError, MemFlowTimeoutError, MemFlowWaitForError, KeyService, KeyType, asyncLocalStorage, deterministicRandom, guid, s, sleepImmediate, HotMesh, SerializerService, ActivityConfig, ChildResponseType, HookOptions, ExecHookOptions, ProxyResponseType, ProxyType, WorkflowContext, WorkflowOptions, JobInterruptOptions, StreamCode, StreamStatus, StringAnyType, StringScalarType, StringStringType, HMSH_CODE_MEMFLOW_CHILD, HMSH_CODE_MEMFLOW_FATAL, HMSH_CODE_MEMFLOW_MAXED, HMSH_CODE_MEMFLOW_PROXY, HMSH_CODE_MEMFLOW_SLEEP, HMSH_CODE_MEMFLOW_TIMEOUT, HMSH_CODE_MEMFLOW_WAIT, HMSH_MEMFLOW_EXP_BACKOFF, HMSH_MEMFLOW_MAX_ATTEMPTS, HMSH_MEMFLOW_MAX_INTERVAL, MemFlowChildErrorType, MemFlowProxyErrorType, TelemetryService, QuorumMessage, UserMessage, Search, WorkerService, Entity, };

package/build/services/memflow/workflow/common.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Context = exports.WorkerService = exports.Search = exports.TelemetryService = exports.HMSH_MEMFLOW_MAX_INTERVAL = exports.HMSH_MEMFLOW_MAX_ATTEMPTS = exports.HMSH_MEMFLOW_EXP_BACKOFF = exports.HMSH_CODE_MEMFLOW_WAIT = exports.HMSH_CODE_MEMFLOW_TIMEOUT = exports.HMSH_CODE_MEMFLOW_SLEEP = exports.HMSH_CODE_MEMFLOW_PROXY = exports.HMSH_CODE_MEMFLOW_MAXED = exports.HMSH_CODE_MEMFLOW_FATAL = exports.HMSH_CODE_MEMFLOW_CHILD = exports.StreamStatus = exports.SerializerService = exports.HotMesh = exports.sleepImmediate = exports.s = exports.guid = exports.deterministicRandom = exports.asyncLocalStorage = exports.KeyType = exports.KeyService = exports.MemFlowWaitForError = exports.MemFlowTimeoutError = exports.MemFlowSleepError = exports.MemFlowRetryError = exports.MemFlowProxyError = exports.MemFlowMaxedError = exports.MemFlowFatalError = exports.MemFlowChildError = void 0;
+exports.Entity = exports.WorkerService = exports.Search = exports.TelemetryService = exports.HMSH_MEMFLOW_MAX_INTERVAL = exports.HMSH_MEMFLOW_MAX_ATTEMPTS = exports.HMSH_MEMFLOW_EXP_BACKOFF = exports.HMSH_CODE_MEMFLOW_WAIT = exports.HMSH_CODE_MEMFLOW_TIMEOUT = exports.HMSH_CODE_MEMFLOW_SLEEP = exports.HMSH_CODE_MEMFLOW_PROXY = exports.HMSH_CODE_MEMFLOW_MAXED = exports.HMSH_CODE_MEMFLOW_FATAL = exports.HMSH_CODE_MEMFLOW_CHILD = exports.StreamStatus = exports.SerializerService = exports.HotMesh = exports.sleepImmediate = exports.s = exports.guid = exports.deterministicRandom = exports.asyncLocalStorage = exports.KeyType = exports.KeyService = exports.MemFlowWaitForError = exports.MemFlowTimeoutError = exports.MemFlowSleepError = exports.MemFlowRetryError = exports.MemFlowProxyError = exports.MemFlowMaxedError = exports.MemFlowFatalError = exports.MemFlowChildError = void 0;
 const errors_1 = require("../../../modules/errors");
 Object.defineProperty(exports, "MemFlowChildError", { enumerable: true, get: function () { return errors_1.MemFlowChildError; } });
 Object.defineProperty(exports, "MemFlowFatalError", { enumerable: true, get: function () { return errors_1.MemFlowFatalError; } });
@@ -43,5 +43,5 @@ const search_1 = require("../search");
 Object.defineProperty(exports, "Search", { enumerable: true, get: function () { return search_1.Search; } });
 const worker_1 = require("../worker");
 Object.defineProperty(exports, "WorkerService", { enumerable: true, get: function () { return worker_1.WorkerService; } });
-const context_1 = require("../context");
-Object.defineProperty(exports, "Context", { enumerable: true, get: function () { return context_1.Context; } });
+const entity_1 = require("../entity");
+Object.defineProperty(exports, "Entity", { enumerable: true, get: function () { return entity_1.Entity; } });

package/build/services/memflow/workflow/entityMethods.d.ts

@@ -0,0 +1,14 @@
+import { Entity } from './common';
+/**
+ * Returns an entity session handle for interacting with the workflow's JSONB entity storage.
+ * @returns {Promise<Entity>} An entity session for workflow data.
+ *
+ * @example
+ * ```typescript
+ * const entity = await workflow.entity();
+ * await entity.set({ user: { id: 123 } });
+ * await entity.merge({ user: { name: "John" } });
+ * const user = await entity.get("user");
+ * ```
+ */
+export declare function entity(): Promise<Entity>;

package/build/services/memflow/workflow/{contextMethods.js → entityMethods.js}

@@ -1,20 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.context = void 0;
+exports.entity = void 0;
 const common_1 = require("./common");
 /**
- * Returns a context session handle for interacting with the workflow's JSONB context storage.
- * @returns {Promise<Context>} A context session for workflow data.
+ * Returns an entity session handle for interacting with the workflow's JSONB entity storage.
+ * @returns {Promise<Entity>} An entity session for workflow data.
  *
  * @example
  * ```typescript
- * const context = await workflow.context();
- * await context.set({ user: { id: 123 } });
- * await context.merge({ user: { name: "John" } });
- * const user = await context.get("user");
+ * const entity = await workflow.entity();
+ * await entity.set({ user: { id: 123 } });
+ * await entity.merge({ user: { name: "John" } });
+ * const user = await entity.get("user");
  * ```
  */
-async function context() {
+async function entity() {
     const store = common_1.asyncLocalStorage.getStore();
     const workflowId = store.get('workflowId');
     const workflowDimension = store.get('workflowDimension') ?? '';
@@ -27,7 +27,7 @@ async function context() {
         connection,
         namespace,
     });
-    const contextSessionId = `-context${workflowDimension}-${execIndex}`;
-    return new common_1.Context(workflowId, hotMeshClient, contextSessionId);
+    const entitySessionId = `-entity${workflowDimension}-${execIndex}`;
+    return new common_1.Entity(workflowId, hotMeshClient, entitySessionId);
 }
-exports.context = context;
+exports.entity = entity;

package/build/services/memflow/workflow/index.d.ts

@@ -16,7 +16,7 @@ import { all } from './all';
 import { sleepFor } from './sleepFor';
 import { waitFor } from './waitFor';
 import { HotMesh } from './common';
-import { context } from './contextMethods';
+import { entity } from './entityMethods';
 /**
  * The WorkflowService class provides a set of static methods to be used within a workflow function.
  * These methods ensure deterministic replay, persistence of state, and error handling across
@@ -58,7 +58,7 @@ export declare class WorkflowService {
     static execHook: typeof execHook;
     static proxyActivities: typeof proxyActivities;
     static search: typeof search;
-    static context: typeof context;
+    static entity: typeof entity;
     static random: typeof random;
     static signal: typeof signal;
     static hook: typeof hook;

package/build/services/memflow/workflow/index.js

@@ -19,7 +19,7 @@ const all_1 = require("./all");
 const sleepFor_1 = require("./sleepFor");
 const waitFor_1 = require("./waitFor");
 const common_1 = require("./common");
-const contextMethods_1 = require("./contextMethods");
+const entityMethods_1 = require("./entityMethods");
 /**
  * The WorkflowService class provides a set of static methods to be used within a workflow function.
  * These methods ensure deterministic replay, persistence of state, and error handling across
@@ -76,7 +76,7 @@ WorkflowService.startChild = execChild_1.startChild;
 WorkflowService.execHook = execHook_1.execHook;
 WorkflowService.proxyActivities = proxyActivities_1.proxyActivities;
 WorkflowService.search = searchMethods_1.search;
-WorkflowService.context = contextMethods_1.context;
+WorkflowService.entity = entityMethods_1.entity;
 WorkflowService.random = random_1.random;
 WorkflowService.signal = signal_1.signal;
 WorkflowService.hook = hook_1.hook;

package/build/services/store/index.d.ts

@@ -40,7 +40,7 @@ declare abstract class StoreService<Provider extends ProviderClient, Transaction
     abstract getJobIds(indexKeys: string[], idRange: [number, number]): Promise<IdsData>;
     abstract setStatus(collationKeyStatus: number, jobId: string, appId: string, transaction?: TransactionProvider): Promise<any>;
     abstract getStatus(jobId: string, appId: string): Promise<number>;
-    abstract setStateNX(jobId: string, appId: string, status?: number): Promise<boolean>;
+    abstract setStateNX(jobId: string, appId: string, status?: number, entity?: string): Promise<boolean>;
     abstract setState(state: StringAnyType, status: number | null, jobId: string, symbolNames: string[], dIds: StringStringType, transaction?: TransactionProvider): Promise<string>;
     abstract getQueryState(jobId: string, fields: string[]): Promise<StringAnyType>;
     abstract getState(jobId: string, consumes: Consumes, dIds: StringStringType): Promise<[StringAnyType, number] | undefined>;

package/build/services/store/providers/postgres/kvsql.d.ts

@@ -52,7 +52,7 @@ export declare class KVSQL {
         sql: string;
         params: any[];
     };
-    hsetnx: (key: string, field: string, value: string, multi?: ProviderTransaction) => Promise<number>;
+    hsetnx: (key: string, field: string, value: string, multi?: ProviderTransaction, entity?: string) => Promise<number>;
     hget: (key: string, field: string, multi?: ProviderTransaction) => Promise<string>;
     _hget: (key: string, field: string) => {
         sql: string;

package/build/services/store/providers/postgres/kvtypes/hash.d.ts

@@ -2,7 +2,7 @@ import { PostgresJobEnumType } from '../../../../../types/postgres';
 import { HScanResult, HSetOptions, ProviderTransaction } from '../../../../../types/provider';
 import type { KVSQL } from '../kvsql';
 export declare const hashModule: (context: KVSQL) => {
-    hsetnx(key: string, field: string, value: string, multi?: ProviderTransaction): Promise<number>;
+    hsetnx(key: string, field: string, value: string, multi?: ProviderTransaction, entity?: string): Promise<number>;
     hset(key: string, fields: Record<string, string>, options?: HSetOptions, multi?: ProviderTransaction): Promise<number | any>;
     /**
      * Derives the enumerated `type` value based on the field name when

package/build/services/store/providers/postgres/kvtypes/hash.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hashModule = void 0;
 const hashModule = (context) => ({
-    async hsetnx(key, field, value, multi) {
-        const { sql, params } = this._hset(key, { [field]: value }, { nx: true });
+    async hsetnx(key, field, value, multi, entity) {
+        const { sql, params } = this._hset(key, { [field]: value }, { nx: true, entity });
         if (multi) {
             multi.addCommand(sql, params, 'number');
             return Promise.resolve(0);
@@ -97,25 +97,25 @@ const hashModule = (context) => ({
             if (options?.nx) {
                 // Use WHERE NOT EXISTS to enforce nx
                 sql = `
-          INSERT INTO ${targetTable} (id, key, status)
-          SELECT gen_random_uuid(), $1, $2
+          INSERT INTO ${targetTable} (id, key, status, entity)
+          SELECT gen_random_uuid(), $1, $2, $3
           WHERE NOT EXISTS (
             SELECT 1 FROM ${targetTable}
             WHERE key = $1 AND is_live
           )
           RETURNING 1 as count
         `;
-                params.push(key, fields[':']);
+                params.push(key, fields[':'], options?.entity ?? null);
             }
             else {
                 // Update existing job or insert new one
                 sql = `
-          INSERT INTO ${targetTable} (id, key, status)
-          VALUES (gen_random_uuid(), $1, $2)
+          INSERT INTO ${targetTable} (id, key, status, entity)
+          VALUES (gen_random_uuid(), $1, $2, $3)
           ON CONFLICT (key) WHERE is_live DO UPDATE SET status = EXCLUDED.status
           RETURNING 1 as count
         `;
-                params.push(key, fields[':']);
+                params.push(key, fields[':'], options?.entity ?? null);
             }
         }
         else if (isJobsTable && '@context' in fields) {

package/build/services/store/providers/postgres/postgres.d.ts

@@ -83,7 +83,7 @@ declare class PostgresStoreService extends StoreService<ProviderClient, Provider
      * `purposeful re-entry`.
      */
     collateSynthetic(jobId: string, guid: string, amount: number, transaction?: ProviderTransaction): Promise<number>;
-    setStateNX(jobId: string, appId: string, status?: number): Promise<boolean>;
+    setStateNX(jobId: string, appId: string, status?: number, entity?: string): Promise<boolean>;
     getSchema(activityId: string, appVersion: AppVID): Promise<ActivityType>;
     getSchemas(appVersion: AppVID): Promise<Record<string, ActivityType>>;
     setSchemas(schemas: Record<string, ActivityType>, appVersion: AppVID): Promise<any>;

package/build/services/store/providers/postgres/postgres.js

@@ -567,9 +567,10 @@ class PostgresStoreService extends __1.StoreService {
         });
         return await this.kvsql(transaction).hincrbyfloat(jobKey, guid, amount);
     }
-    async setStateNX(jobId, appId, status) {
+    async setStateNX(jobId, appId, status, entity) {
         const hashKey = this.mintKey(key_1.KeyType.JOB_STATE, { appId, jobId });
-        const result = await this.kvsql().hsetnx(hashKey, ':', status?.toString() ?? '1');
+        const result = await this.kvsql().hsetnx(hashKey, ':', status?.toString() ?? '1', undefined, //multi
+        entity);
         return this.isSuccessful(result);
     }
     async getSchema(activityId, appVersion) {

package/build/services/store/providers/redis/_base.d.ts

@@ -75,7 +75,7 @@ declare abstract class RedisStoreBase<ClientProvider extends ProviderClient, Tra
      * `purposeful re-entry`.
      */
     collateSynthetic(jobId: string, guid: string, amount: number, transaction?: TransactionProvider): Promise<number>;
-    setStateNX(jobId: string, appId: string, status?: number): Promise<boolean>;
+    setStateNX(jobId: string, appId: string, status?: number, entity?: string): Promise<boolean>;
     getSchema(activityId: string, appVersion: AppVID): Promise<ActivityType>;
     getSchemas(appVersion: AppVID): Promise<Record<string, ActivityType>>;
     setSchemas(schemas: Record<string, ActivityType>, appVersion: AppVID): Promise<any>;

package/build/services/store/providers/redis/_base.js

@@ -539,7 +539,7 @@ class RedisStoreBase extends __1.StoreService {
         });
         return await (transaction || this.storeClient)[this.commands.hincrbyfloat](jobKey, guid, amount.toString());
     }
-    async setStateNX(jobId, appId, status) {
+    async setStateNX(jobId, appId, status, entity) {
         const hashKey = this.mintKey(key_1.KeyType.JOB_STATE, { appId, jobId });
         const result = await this.storeClient[this.commands.hsetnx](hashKey, ':', status?.toString() ?? '1');
         return this.isSuccessful(result);

package/build/types/job.d.ts

@@ -95,6 +95,13 @@ type ExtensionType = {
      * will be added after the job is resumed if relevant.
      */
     pending?: number;
+    /**
+     * Entity to organize the job in the database by type.
+     * This is useful for querying and filtering jobs by type
+     * as the <your-app-id>.jobs table is organized by entity.
+     * Add partial indexes to the entity column to speed up queries.
+     */
+    entity?: string;
 };
 /**
  * job_status semaphore

package/build/types/provider.d.ts

@@ -84,6 +84,7 @@ export interface SetOptions {
 export interface HSetOptions {
     nx?: boolean;
     ex?: number;
+    entity?: string;
 }
 export interface ZAddOptions {
     nx?: boolean;

package/index.ts

@@ -5,6 +5,7 @@ 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 { Entity } from './services/memflow/entity';
 import { WorkerService as Worker } from './services/memflow/worker';
 import { WorkflowService as workflow } from './services/memflow/workflow';
 import { WorkflowHandleService as WorkflowHandle } from './services/memflow/handle';
@@ -21,8 +22,6 @@ 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 } = MemFlow;
-
 export {
   //Provider Connectors
   Connector, //factory
@@ -44,6 +43,7 @@ export {
   Connection,
   proxyActivities,
   Search,
+  Entity,
   Worker,
   workflow,
   WorkflowHandle,

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@hotmeshio/hotmesh",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Permanent-Memory Workflows & AI Agents",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
-  "homepage": "https://hotmesh.io/",
+  "homepage": "https://github.com/hotmeshio/sdk-typescript/",
   "publishConfig": {
     "access": "public"
   },
@@ -33,7 +33,8 @@
     "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:entity": "NODE_ENV=test HMSH_LOGLEVEL=debug jest ./tests/memflow/entity/postgres.test.ts --detectOpenHandles --forceExit --verbose",
+    "test:memflow:agent": "NODE_ENV=test HMSH_LOGLEVEL=debug jest ./tests/memflow/agent/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",

package/build/services/memflow/workflow/contextMethods.d.ts

@@ -1,14 +0,0 @@
-import { Context } from './common';
-/**
- * Returns a context session handle for interacting with the workflow's JSONB context storage.
- * @returns {Promise<Context>} A context session for workflow data.
- *
- * @example
- * ```typescript
- * const context = await workflow.context();
- * await context.set({ user: { id: 123 } });
- * await context.merge({ user: { name: "John" } });
- * const user = await context.get("user");
- * ```
- */
-export declare function context(): Promise<Context>;