@hotmeshio/hotmesh 0.11.0 → 0.12.0

package/build/modules/enums.d.ts

@@ -78,6 +78,7 @@ export declare const INITIAL_STREAM_BACKOFF: number;
 export declare const MAX_STREAM_RETRIES: number;
 export declare const MAX_DELAY = 2147483647;
 export declare const HMSH_MAX_RETRIES: number;
+export declare const HMSH_POISON_MESSAGE_THRESHOLD: number;
 export declare const HMSH_MAX_TIMEOUT_MS: number;
 export declare const HMSH_GRADUATED_INTERVAL_MS: number;
 /**

package/build/modules/enums.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HMSH_ROUTER_POLL_FALLBACK_INTERVAL = exports.HMSH_NOTIFY_PAYLOAD_LIMIT = exports.DEFAULT_TASK_QUEUE = exports.HMSH_GUID_SIZE = exports.HMSH_ROUTER_SCOUT_INTERVAL_MS = exports.HMSH_ROUTER_SCOUT_INTERVAL_SECONDS = exports.HMSH_SCOUT_INTERVAL_SECONDS = exports.HMSH_FIDELITY_SECONDS = exports.HMSH_EXPIRE_DURATION = exports.HMSH_XPENDING_COUNT = exports.HMSH_XCLAIM_COUNT = exports.HMSH_XCLAIM_DELAY_MS = exports.HMSH_BLOCK_TIME_MS = exports.HMSH_DURABLE_EXP_BACKOFF = exports.HMSH_DURABLE_MAX_INTERVAL = exports.HMSH_DURABLE_MAX_ATTEMPTS = exports.HMSH_GRADUATED_INTERVAL_MS = exports.HMSH_MAX_TIMEOUT_MS = exports.HMSH_MAX_RETRIES = exports.MAX_DELAY = exports.MAX_STREAM_RETRIES = exports.INITIAL_STREAM_BACKOFF = exports.MAX_STREAM_BACKOFF = exports.HMSH_EXPIRE_JOB_SECONDS = exports.HMSH_OTT_WAIT_TIME = exports.HMSH_DEPLOYMENT_PAUSE = exports.HMSH_DEPLOYMENT_DELAY = exports.HMSH_ACTIVATION_MAX_RETRY = exports.HMSH_QUORUM_DELAY_MS = exports.HMSH_QUORUM_ROLLCALL_CYCLES = exports.HMSH_STATUS_UNKNOWN = exports.HMSH_CODE_DURABLE_RETRYABLE = exports.HMSH_CODE_DURABLE_FATAL = exports.HMSH_CODE_DURABLE_MAXED = exports.HMSH_CODE_DURABLE_TIMEOUT = exports.HMSH_CODE_DURABLE_WAIT = exports.HMSH_CODE_DURABLE_PROXY = exports.HMSH_CODE_DURABLE_CHILD = exports.HMSH_CODE_DURABLE_ALL = exports.HMSH_CODE_DURABLE_SLEEP = exports.HMSH_CODE_UNACKED = exports.HMSH_CODE_TIMEOUT = exports.HMSH_CODE_UNKNOWN = exports.HMSH_CODE_INTERRUPT = exports.HMSH_CODE_NOTFOUND = exports.HMSH_CODE_PENDING = exports.HMSH_CODE_SUCCESS = exports.HMSH_SIGNAL_EXPIRE = exports.HMSH_TELEMETRY = exports.HMSH_LOGLEVEL = void 0;
+exports.HMSH_NOTIFY_PAYLOAD_LIMIT = exports.DEFAULT_TASK_QUEUE = exports.HMSH_GUID_SIZE = exports.HMSH_ROUTER_SCOUT_INTERVAL_MS = exports.HMSH_ROUTER_SCOUT_INTERVAL_SECONDS = exports.HMSH_SCOUT_INTERVAL_SECONDS = exports.HMSH_FIDELITY_SECONDS = exports.HMSH_EXPIRE_DURATION = exports.HMSH_XPENDING_COUNT = exports.HMSH_XCLAIM_COUNT = exports.HMSH_XCLAIM_DELAY_MS = exports.HMSH_BLOCK_TIME_MS = exports.HMSH_DURABLE_EXP_BACKOFF = exports.HMSH_DURABLE_MAX_INTERVAL = exports.HMSH_DURABLE_MAX_ATTEMPTS = exports.HMSH_GRADUATED_INTERVAL_MS = exports.HMSH_MAX_TIMEOUT_MS = exports.HMSH_POISON_MESSAGE_THRESHOLD = exports.HMSH_MAX_RETRIES = exports.MAX_DELAY = exports.MAX_STREAM_RETRIES = exports.INITIAL_STREAM_BACKOFF = exports.MAX_STREAM_BACKOFF = exports.HMSH_EXPIRE_JOB_SECONDS = exports.HMSH_OTT_WAIT_TIME = exports.HMSH_DEPLOYMENT_PAUSE = exports.HMSH_DEPLOYMENT_DELAY = exports.HMSH_ACTIVATION_MAX_RETRY = exports.HMSH_QUORUM_DELAY_MS = exports.HMSH_QUORUM_ROLLCALL_CYCLES = exports.HMSH_STATUS_UNKNOWN = exports.HMSH_CODE_DURABLE_RETRYABLE = exports.HMSH_CODE_DURABLE_FATAL = exports.HMSH_CODE_DURABLE_MAXED = exports.HMSH_CODE_DURABLE_TIMEOUT = exports.HMSH_CODE_DURABLE_WAIT = exports.HMSH_CODE_DURABLE_PROXY = exports.HMSH_CODE_DURABLE_CHILD = exports.HMSH_CODE_DURABLE_ALL = exports.HMSH_CODE_DURABLE_SLEEP = exports.HMSH_CODE_UNACKED = exports.HMSH_CODE_TIMEOUT = exports.HMSH_CODE_UNKNOWN = exports.HMSH_CODE_INTERRUPT = exports.HMSH_CODE_NOTFOUND = exports.HMSH_CODE_PENDING = exports.HMSH_CODE_SUCCESS = exports.HMSH_SIGNAL_EXPIRE = exports.HMSH_TELEMETRY = exports.HMSH_LOGLEVEL = void 0;
+exports.HMSH_ROUTER_POLL_FALLBACK_INTERVAL = void 0;
 /**
  * Determines the log level for the application. The default is 'info'.
  */
@@ -87,6 +88,7 @@ exports.INITIAL_STREAM_BACKOFF = parseInt(process.env.INITIAL_STREAM_BACKOFF, 10
 exports.MAX_STREAM_RETRIES = parseInt(process.env.MAX_STREAM_RETRIES, 10) || 2;
 exports.MAX_DELAY = 2147483647; // Maximum allowed delay in milliseconds for setTimeout
 exports.HMSH_MAX_RETRIES = parseInt(process.env.HMSH_MAX_RETRIES, 10) || 3;
+exports.HMSH_POISON_MESSAGE_THRESHOLD = parseInt(process.env.HMSH_POISON_MESSAGE_THRESHOLD, 10) || 5;
 exports.HMSH_MAX_TIMEOUT_MS = parseInt(process.env.HMSH_MAX_TIMEOUT_MS, 10) || 60000;
 exports.HMSH_GRADUATED_INTERVAL_MS = parseInt(process.env.HMSH_GRADUATED_INTERVAL_MS, 10) || 5000;
 // DURABLE

package/build/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hotmeshio/hotmesh",
-    "version": "0.11.0",
+    "version": "0.12.0",
     "description": "Permanent-Memory Workflows & AI Agents",
     "main": "./build/index.js",
     "types": "./build/index.d.ts",

package/build/services/durable/exporter.js

@@ -510,6 +510,47 @@ class ExporterService {
                 }
             }
         }
+        // ── 3. Stream-based fallback for unenriched activity events ──
+        // When job attributes have been pruned, recover inputs from worker_streams
+        if (this.store.getStreamHistory) {
+            const unenrichedEvents = execution.events.filter((e) => (e.event_type === 'activity_task_scheduled' ||
+                e.event_type === 'activity_task_completed' ||
+                e.event_type === 'activity_task_failed') &&
+                e.attributes.input === undefined);
+            if (unenrichedEvents.length > 0) {
+                const streamHistory = await this.store.getStreamHistory(workflowId, {
+                    types: ['worker'],
+                });
+                // Build a map of aid -> stream message data (the worker invocation inputs)
+                const streamInputsByAid = new Map();
+                for (const entry of streamHistory) {
+                    if (entry.msg_type === 'worker' && entry.data) {
+                        const key = `${entry.aid}:${entry.dad || ''}`;
+                        if (!streamInputsByAid.has(key)) {
+                            streamInputsByAid.set(key, entry.data);
+                        }
+                    }
+                }
+                for (const evt of unenrichedEvents) {
+                    const attrs = evt.attributes;
+                    // Try matching by activity_type + dimensional address
+                    const key = `${attrs.activity_type}:${attrs.timeline_key || ''}`;
+                    let input = streamInputsByAid.get(key);
+                    if (input === undefined) {
+                        // Fallback: match by activity name alone (first occurrence)
+                        for (const [k, v] of streamInputsByAid) {
+                            if (k.startsWith(`${attrs.activity_type}:`)) {
+                                input = v;
+                                break;
+                            }
+                        }
+                    }
+                    if (input !== undefined) {
+                        attrs.input = input;
+                    }
+                }
+            }
+        }
     }
     /**
      * Resolve a symbol field from stable JSON path using the symbol registry.

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

@@ -16,7 +16,7 @@ import { TaskService } from '../task';
 import { AppVID } from '../../types/app';
 import { ActivityType } from '../../types/activity';
 import { CacheMode } from '../../types/cache';
-import { JobExport } from '../../types/exporter';
+import { ExportOptions, JobExport } from '../../types/exporter';
 import { JobState, JobData, JobMetadata, JobOutput, JobStatus, JobInterruptOptions, JobCompletionOptions, ExtensionType } from '../../types/job';
 import { HotMeshApps, HotMeshConfig, HotMeshManifest, HotMeshSettings } from '../../types/hotmesh';
 import { ProviderClient, ProviderTransaction } from '../../types/provider';
@@ -254,7 +254,7 @@ declare class EngineService {
     /**
      * @private
      */
-    export(jobId: string): Promise<JobExport>;
+    export(jobId: string, options?: ExportOptions): Promise<JobExport>;
     /**
      * @private
      */

package/build/services/engine/index.js

@@ -210,6 +210,9 @@ class EngineService {
      */
     async initActivity(topic, data = {}, context) {
         const [activityId, schema] = await this.getSchema(topic);
+        if (!schema) {
+            throw new Error(`Activity schema not found for "${activityId}" (topic: ${topic}) in app ${this.appId}`);
+        }
         const ActivityHandler = activities_1.default[schema.type];
         if (ActivityHandler) {
             const utc = (0, utils_1.formatISODate)(new Date());
@@ -746,8 +749,8 @@ class EngineService {
     /**
      * @private
      */
-    async export(jobId) {
-        return await this.exporter.export(jobId);
+    async export(jobId, options = {}) {
+        return await this.exporter.export(jobId, options);
     }
     /**
      * @private

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

@@ -1,8 +1,8 @@
 import { ILogger } from '../logger';
 import { StoreService } from '../store';
-import { DependencyExport, ExportOptions, JobActionExport, JobExport } from '../../types/exporter';
+import { ActivityDetail, DependencyExport, ExportOptions, JobActionExport, JobExport, StreamHistoryEntry } from '../../types/exporter';
 import { ProviderClient, ProviderTransaction } from '../../types/provider';
-import { StringStringType, Symbols } from '../../types/serializer';
+import { StringAnyType, StringStringType, Symbols } from '../../types/serializer';
 /**
  * Downloads job data and expands process data and
  * includes dependency list
@@ -34,6 +34,20 @@ declare class ExporterService {
      * @returns - the inflated job data
      */
     inflate(jobHash: StringStringType, dependencyList: string[]): JobExport;
+    /**
+     * Build structured activity details by correlating stream messages
+     * (inputs, timing, retries) with the process hierarchy (outputs).
+     *
+     * Stream messages carry the raw data that flowed through each activity:
+     * - `data` contains the activity input arguments
+     * - `dad` (dimensional address) reveals cycle iterations (e.g., ,0,1,0 = 2nd cycle)
+     * - `created_at` / `expired_at` give precise timing
+     * - `retry_attempt` tracks retries
+     *
+     * The process hierarchy carries activity outputs organized by dimension.
+     * This method merges both into a flat, dashboard-friendly list.
+     */
+    buildActivities(process: StringAnyType, streamHistory: StreamHistoryEntry[]): ActivityDetail[];
     /**
      * Inflates the dependency data into a JobExport object by
      * organizing the dimensional isolate in such a way as to interleave

package/build/services/exporter/index.js

@@ -28,6 +28,10 @@ class ExporterService {
         const depData = []; // await this.store.getDependencies(jobId);
         const jobData = await this.store.getRaw(jobId);
         const jobExport = this.inflate(jobData, depData);
+        if (options.enrich_inputs && this.store.getStreamHistory) {
+            const streamHistory = await this.store.getStreamHistory(jobId);
+            jobExport.activities = this.buildActivities(jobExport.process, streamHistory);
+        }
         return jobExport;
     }
     /**
@@ -77,6 +81,78 @@ class ExporterService {
             status: jobHash[':'],
         };
     }
+    /**
+     * Build structured activity details by correlating stream messages
+     * (inputs, timing, retries) with the process hierarchy (outputs).
+     *
+     * Stream messages carry the raw data that flowed through each activity:
+     * - `data` contains the activity input arguments
+     * - `dad` (dimensional address) reveals cycle iterations (e.g., ,0,1,0 = 2nd cycle)
+     * - `created_at` / `expired_at` give precise timing
+     * - `retry_attempt` tracks retries
+     *
+     * The process hierarchy carries activity outputs organized by dimension.
+     * This method merges both into a flat, dashboard-friendly list.
+     */
+    buildActivities(process, streamHistory) {
+        const activities = [];
+        for (const entry of streamHistory) {
+            // Parse dimensional address: ",0,1,0,0" → ["0","1","0","0"]
+            const dimParts = (entry.dad || '').split(',').filter(Boolean);
+            const dimension = dimParts.join('/');
+            // Detect cycle iteration from dimensional address
+            // In a cycling workflow, the 2nd dimension component increments per cycle
+            const cycleIteration = dimParts.length > 1 ? parseInt(dimParts[1]) || 0 : 0;
+            // Look up the corresponding output from the process hierarchy
+            // Process keys are like: process[dimension][activityName].output.data
+            let output;
+            let activityName = entry.aid;
+            // Walk the process hierarchy using the dimension path
+            let node = process;
+            for (const part of dimParts) {
+                if (node && typeof node === 'object' && node[part]) {
+                    node = node[part];
+                }
+                else {
+                    node = undefined;
+                    break;
+                }
+            }
+            if (node && typeof node === 'object') {
+                // node is now at the dimensional level, look for the activity
+                if (node[activityName]?.output?.data) {
+                    output = node[activityName].output.data;
+                }
+            }
+            // Compute timing
+            const startedAt = entry.created_at;
+            const completedAt = entry.expired_at;
+            let durationMs;
+            if (startedAt && completedAt) {
+                durationMs = new Date(completedAt).getTime() - new Date(startedAt).getTime();
+            }
+            activities.push({
+                name: activityName,
+                type: entry.aid,
+                dimension,
+                input: entry.data,
+                output,
+                started_at: startedAt,
+                completed_at: completedAt,
+                duration_ms: durationMs,
+                retry_attempt: entry.code === undefined ? 0 : undefined,
+                cycle_iteration: cycleIteration > 0 ? cycleIteration : undefined,
+                error: null,
+            });
+        }
+        // Sort by time, then by dimension for cycle ordering
+        activities.sort((a, b) => {
+            const timeA = a.started_at || '';
+            const timeB = b.started_at || '';
+            return timeA.localeCompare(timeB);
+        });
+        return activities;
+    }
     /**
      * Inflates the dependency data into a JobExport object by
      * organizing the dimensional isolate in such a way as to interleave

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

@@ -4,7 +4,7 @@ import { QuorumService } from '../quorum';
 import { WorkerService } from '../worker';
 import { JobState, JobData, JobOutput, JobStatus, JobInterruptOptions, ExtensionType } from '../../types/job';
 import { HotMeshConfig, HotMeshManifest } from '../../types/hotmesh';
-import { JobExport } from '../../types/exporter';
+import { ExportOptions, JobExport } from '../../types/exporter';
 import { JobMessageCallback, QuorumMessage, QuorumMessageCallback, QuorumProfile, ThrottleOptions } from '../../types/quorum';
 import { StringAnyType, StringStringType } from '../../types/serializer';
 import { JobStatsInput, GetStatsOptions, IdsResponse, StatsResponse } from '../../types/stats';
@@ -632,7 +632,7 @@ declare class HotMesh {
      * activity data, transitions, and dependency chains. Useful for
      * debugging, auditing, and visualizing workflow execution.
      */
-    export(jobId: string): Promise<JobExport>;
+    export(jobId: string, options?: ExportOptions): Promise<JobExport>;
     /**
      * Returns all raw key-value pairs for a job's HASH record. This is
      * the lowest-level read — it returns internal engine fields alongside

package/build/services/hotmesh/index.js

@@ -769,8 +769,8 @@ class HotMesh {
      * activity data, transitions, and dependency chains. Useful for
      * debugging, auditing, and visualizing workflow execution.
      */
-    async export(jobId) {
-        return await this.engine?.export(jobId);
+    async export(jobId, options = {}) {
+        return await this.engine?.export(jobId, options);
     }
     /**
      * Returns all raw key-value pairs for a job's HASH record. This is

package/build/services/router/config/index.d.ts

@@ -1,4 +1,4 @@
-import { HMSH_BLOCK_TIME_MS, HMSH_MAX_RETRIES, HMSH_MAX_TIMEOUT_MS, HMSH_GRADUATED_INTERVAL_MS, HMSH_CODE_UNACKED, HMSH_CODE_UNKNOWN, HMSH_STATUS_UNKNOWN, HMSH_XCLAIM_COUNT, HMSH_XCLAIM_DELAY_MS, HMSH_XPENDING_COUNT, MAX_DELAY, MAX_STREAM_BACKOFF, INITIAL_STREAM_BACKOFF, MAX_STREAM_RETRIES } from '../../../modules/enums';
+import { HMSH_BLOCK_TIME_MS, HMSH_MAX_RETRIES, HMSH_MAX_TIMEOUT_MS, HMSH_GRADUATED_INTERVAL_MS, HMSH_CODE_UNACKED, HMSH_CODE_UNKNOWN, HMSH_STATUS_UNKNOWN, HMSH_XCLAIM_COUNT, HMSH_XCLAIM_DELAY_MS, HMSH_XPENDING_COUNT, MAX_DELAY, MAX_STREAM_BACKOFF, INITIAL_STREAM_BACKOFF, MAX_STREAM_RETRIES, HMSH_POISON_MESSAGE_THRESHOLD } from '../../../modules/enums';
 import { RouterConfig } from '../../../types/stream';
 export declare class RouterConfigManager {
     static validateThrottle(delayInMillis: number): void;
@@ -8,4 +8,4 @@ export declare class RouterConfigManager {
         readonly: boolean;
     };
 }
-export { HMSH_BLOCK_TIME_MS, HMSH_MAX_RETRIES, HMSH_MAX_TIMEOUT_MS, HMSH_GRADUATED_INTERVAL_MS, HMSH_CODE_UNACKED, HMSH_CODE_UNKNOWN, HMSH_STATUS_UNKNOWN, HMSH_XCLAIM_COUNT, HMSH_XCLAIM_DELAY_MS, HMSH_XPENDING_COUNT, MAX_DELAY, MAX_STREAM_BACKOFF, INITIAL_STREAM_BACKOFF, MAX_STREAM_RETRIES, };
+export { HMSH_BLOCK_TIME_MS, HMSH_MAX_RETRIES, HMSH_MAX_TIMEOUT_MS, HMSH_GRADUATED_INTERVAL_MS, HMSH_CODE_UNACKED, HMSH_CODE_UNKNOWN, HMSH_STATUS_UNKNOWN, HMSH_XCLAIM_COUNT, HMSH_XCLAIM_DELAY_MS, HMSH_XPENDING_COUNT, MAX_DELAY, MAX_STREAM_BACKOFF, INITIAL_STREAM_BACKOFF, MAX_STREAM_RETRIES, HMSH_POISON_MESSAGE_THRESHOLD, };

package/build/services/router/config/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_STREAM_RETRIES = exports.INITIAL_STREAM_BACKOFF = exports.MAX_STREAM_BACKOFF = exports.MAX_DELAY = exports.HMSH_XPENDING_COUNT = exports.HMSH_XCLAIM_DELAY_MS = exports.HMSH_XCLAIM_COUNT = exports.HMSH_STATUS_UNKNOWN = exports.HMSH_CODE_UNKNOWN = exports.HMSH_CODE_UNACKED = exports.HMSH_GRADUATED_INTERVAL_MS = exports.HMSH_MAX_TIMEOUT_MS = exports.HMSH_MAX_RETRIES = exports.HMSH_BLOCK_TIME_MS = exports.RouterConfigManager = void 0;
+exports.HMSH_POISON_MESSAGE_THRESHOLD = exports.MAX_STREAM_RETRIES = exports.INITIAL_STREAM_BACKOFF = exports.MAX_STREAM_BACKOFF = exports.MAX_DELAY = exports.HMSH_XPENDING_COUNT = exports.HMSH_XCLAIM_DELAY_MS = exports.HMSH_XCLAIM_COUNT = exports.HMSH_STATUS_UNKNOWN = exports.HMSH_CODE_UNKNOWN = exports.HMSH_CODE_UNACKED = exports.HMSH_GRADUATED_INTERVAL_MS = exports.HMSH_MAX_TIMEOUT_MS = exports.HMSH_MAX_RETRIES = exports.HMSH_BLOCK_TIME_MS = exports.RouterConfigManager = void 0;
 const enums_1 = require("../../../modules/enums");
 Object.defineProperty(exports, "HMSH_BLOCK_TIME_MS", { enumerable: true, get: function () { return enums_1.HMSH_BLOCK_TIME_MS; } });
 Object.defineProperty(exports, "HMSH_MAX_RETRIES", { enumerable: true, get: function () { return enums_1.HMSH_MAX_RETRIES; } });
@@ -16,6 +16,7 @@ Object.defineProperty(exports, "MAX_DELAY", { enumerable: true, get: function ()
 Object.defineProperty(exports, "MAX_STREAM_BACKOFF", { enumerable: true, get: function () { return enums_1.MAX_STREAM_BACKOFF; } });
 Object.defineProperty(exports, "INITIAL_STREAM_BACKOFF", { enumerable: true, get: function () { return enums_1.INITIAL_STREAM_BACKOFF; } });
 Object.defineProperty(exports, "MAX_STREAM_RETRIES", { enumerable: true, get: function () { return enums_1.MAX_STREAM_RETRIES; } });
+Object.defineProperty(exports, "HMSH_POISON_MESSAGE_THRESHOLD", { enumerable: true, get: function () { return enums_1.HMSH_POISON_MESSAGE_THRESHOLD; } });
 class RouterConfigManager {
     static validateThrottle(delayInMillis) {
         if (!Number.isInteger(delayInMillis) ||

package/build/services/router/consumption/index.js

@@ -356,6 +356,68 @@ class ConsumptionManager {
     }
     async consumeOne(stream, group, id, input, callback) {
         this.logger.debug(`stream-read-one`, { group, stream, id });
+        // Poison message circuit breaker. This is a SAFETY NET that sits above
+        // the normal retry mechanism (ErrorHandler.handleRetry / shouldRetry).
+        //
+        // Normal retry flow: handleRetry() checks metadata.try against the
+        // configured retryPolicy.maximumAttempts (or _streamRetryConfig) and
+        // applies exponential backoff + visibility delays. That mechanism is
+        // the primary retry budget and is what developers configure via
+        // HotMesh.init({ workers: [{ retryPolicy: { maximumAttempts, ... } }] }).
+        //
+        // This check catches messages that have somehow exceeded the normal
+        // budget — e.g., when no retryPolicy is configured, when the retry
+        // logic is bypassed by an infrastructure error, or when a message
+        // re-enters the stream through a path that doesn't increment
+        // metadata.try. The threshold is the HIGHER of the configured retry
+        // budget and the system-wide HMSH_POISON_MESSAGE_THRESHOLD, so it
+        // never interferes with legitimate developer-configured retries.
+        const retryAttempt = input._retryAttempt || 0;
+        const configuredMax = input._streamRetryConfig?.max_retry_attempts
+            ?? this.retryPolicy?.maximumAttempts
+            ?? 0;
+        const poisonThreshold = Math.max(configuredMax, config_1.HMSH_POISON_MESSAGE_THRESHOLD);
+        if (retryAttempt >= poisonThreshold) {
+            this.logger.error(`stream-poison-message-detected`, {
+                group,
+                stream,
+                id,
+                retryAttempt,
+                poisonThreshold,
+                configuredMaxAttempts: configuredMax,
+                systemThreshold: config_1.HMSH_POISON_MESSAGE_THRESHOLD,
+                topic: input.metadata?.topic,
+                activityId: input.metadata?.aid,
+                jobId: input.metadata?.jid,
+                metadata: input.metadata,
+            });
+            const errorOutput = this.errorHandler.structureUnhandledError(input, new Error(`Poison message detected: retry attempt ${retryAttempt} reached ` +
+                `threshold ${poisonThreshold} (configured: ${configuredMax}, ` +
+                `system: ${config_1.HMSH_POISON_MESSAGE_THRESHOLD}). Discarding message ` +
+                `for activity "${input.metadata?.aid || 'unknown'}" ` +
+                `(topic: ${input.metadata?.topic || 'unknown'}, ` +
+                `job: ${input.metadata?.jid || 'unknown'}).`));
+            try {
+                await this.publishMessage(null, errorOutput);
+            }
+            catch (publishErr) {
+                this.logger.error(`stream-poison-message-publish-error`, {
+                    error: publishErr,
+                    stream,
+                    id,
+                    retryAttempt,
+                    poisonThreshold,
+                });
+            }
+            // Mark as dead-lettered if the provider supports it; otherwise just ack
+            if (this.stream.deadLetterMessages) {
+                await this.stream.deadLetterMessages(stream, group, [id]);
+            }
+            else {
+                await this.ackAndDelete(stream, group, id);
+            }
+            return;
+        }
         let output;
         const telemetry = new telemetry_1.RouterTelemetry(this.appId);
         try {
@@ -367,12 +429,25 @@ class ConsumptionManager {
         catch (err) {
             this.logger.error(`stream-read-one-error`, { group, stream, id, err });
             telemetry.setStreamErrorFromException(err);
+            output = this.errorHandler.structureUnhandledError(input, err instanceof Error ? err : new Error(String(err)));
+        }
+        try {
+            const messageId = await this.publishResponse(input, output);
+            telemetry.setStreamAttributes({ 'app.worker.mid': messageId });
+        }
+        catch (publishErr) {
+            // If publishResponse fails, still ack the message to prevent
+            // infinite reprocessing. Log the error for debugging.
+            this.logger.error(`stream-publish-response-error`, {
+                group, stream, id, error: publishErr,
+            });
+            this.errorCount++;
+        }
+        finally {
+            await this.ackAndDelete(stream, group, id);
+            telemetry.endStreamSpan();
+            this.logger.debug(`stream-read-one-end`, { group, stream, id });
         }
-        const messageId = await this.publishResponse(input, output);
-        telemetry.setStreamAttributes({ 'app.worker.mid': messageId });
-        await this.ackAndDelete(stream, group, id);
-        telemetry.endStreamSpan();
-        this.logger.debug(`stream-read-one-end`, { group, stream, id });
     }
     async execStreamLeg(input, stream, id, callback) {
         let output;

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

@@ -112,6 +112,18 @@ declare abstract class StoreService<Provider extends ProviderClient, Transaction
      * @returns Map of child_workflow_id -> parsed input arguments
      */
     getChildWorkflowInputs?(childJobKeys: string[], symbolField: string): Promise<Map<string, any>>;
+    /**
+     * Fetch stream message history for a job from worker_streams.
+     * Returns raw activity input/output data from soft-deleted messages.
+     *
+     * @param jobId - The job ID (metadata.jid in stream messages)
+     * @param options - Optional filters for activity or message types
+     * @returns Array of stream history entries ordered by creation time
+     */
+    getStreamHistory?(jobId: string, options?: {
+        activity?: string;
+        types?: string[];
+    }): Promise<import('../../types/exporter').StreamHistoryEntry[]>;
     /**
      * Fetch job record and attributes by key. Used by the exporter to
      * reconstruct execution history for expired jobs.

package/build/services/store/providers/postgres/exporter-sql.d.ts

@@ -15,6 +15,23 @@ export declare const GET_JOB_ATTRIBUTES = "\n  SELECT field, value\n  FROM {sche
  * Matches all activity jobs for the given workflow and extracts their input arguments.
  */
 export declare const GET_ACTIVITY_INPUTS = "\n  SELECT j.key, ja.value\n  FROM {schema}.jobs j\n  JOIN {schema}.jobs_attributes ja ON ja.job_id = j.id\n  WHERE j.key LIKE $1\n    AND ja.field = $2\n";
+/**
+ * Fetch all worker stream messages for a job AND its child activities.
+ * Child activity jobs use the pattern: -{parentJobId}-$activityName-N
+ * Uses the partial index on (jid, created_at) WHERE jid != '' for efficiency.
+ * Includes both active and expired messages for full execution history.
+ */
+export declare const GET_STREAM_HISTORY_BY_JID = "\n  SELECT\n    id, jid, aid, dad, msg_type, topic, workflow_name,\n    message, created_at, expired_at\n  FROM {schema}.worker_streams\n  WHERE jid = $1 OR jid LIKE '-' || $1 || '-%'\n  ORDER BY created_at, id\n";
+/**
+ * Fetch worker stream messages for a job filtered by message type.
+ * Includes child activity messages.
+ */
+export declare const GET_STREAM_HISTORY_BY_JID_AND_TYPE = "\n  SELECT\n    id, jid, aid, dad, msg_type, topic, workflow_name,\n    message, created_at, expired_at\n  FROM {schema}.worker_streams\n  WHERE (jid = $1 OR jid LIKE '-' || $1 || '-%')\n    AND msg_type = ANY($2::text[])\n  ORDER BY created_at, id\n";
+/**
+ * Fetch worker stream messages for a job filtered by activity ID.
+ * Includes child activity messages.
+ */
+export declare const GET_STREAM_HISTORY_BY_JID_AND_AID = "\n  SELECT\n    id, jid, aid, dad, msg_type, topic, workflow_name,\n    message, created_at, expired_at\n  FROM {schema}.worker_streams\n  WHERE (jid = $1 OR jid LIKE '-' || $1 || '-%')\n    AND aid = $2\n  ORDER BY created_at, id\n";
 /**
  * Fetch child workflow inputs in batch.
  * Uses parameterized IN clause for exact-match efficiency.

package/build/services/store/providers/postgres/exporter-sql.js

@@ -4,7 +4,7 @@
  * These queries support the exporter's input enrichment and direct query features.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildChildWorkflowInputsQuery = exports.GET_ACTIVITY_INPUTS = exports.GET_JOB_ATTRIBUTES = exports.GET_JOB_BY_KEY = void 0;
+exports.buildChildWorkflowInputsQuery = exports.GET_STREAM_HISTORY_BY_JID_AND_AID = exports.GET_STREAM_HISTORY_BY_JID_AND_TYPE = exports.GET_STREAM_HISTORY_BY_JID = exports.GET_ACTIVITY_INPUTS = exports.GET_JOB_ATTRIBUTES = exports.GET_JOB_BY_KEY = void 0;
 /**
  * Fetch job record by key.
  */
@@ -34,6 +34,46 @@ exports.GET_ACTIVITY_INPUTS = `
   WHERE j.key LIKE $1
     AND ja.field = $2
 `;
+/**
+ * Fetch all worker stream messages for a job AND its child activities.
+ * Child activity jobs use the pattern: -{parentJobId}-$activityName-N
+ * Uses the partial index on (jid, created_at) WHERE jid != '' for efficiency.
+ * Includes both active and expired messages for full execution history.
+ */
+exports.GET_STREAM_HISTORY_BY_JID = `
+  SELECT
+    id, jid, aid, dad, msg_type, topic, workflow_name,
+    message, created_at, expired_at
+  FROM {schema}.worker_streams
+  WHERE jid = $1 OR jid LIKE '-' || $1 || '-%'
+  ORDER BY created_at, id
+`;
+/**
+ * Fetch worker stream messages for a job filtered by message type.
+ * Includes child activity messages.
+ */
+exports.GET_STREAM_HISTORY_BY_JID_AND_TYPE = `
+  SELECT
+    id, jid, aid, dad, msg_type, topic, workflow_name,
+    message, created_at, expired_at
+  FROM {schema}.worker_streams
+  WHERE (jid = $1 OR jid LIKE '-' || $1 || '-%')
+    AND msg_type = ANY($2::text[])
+  ORDER BY created_at, id
+`;
+/**
+ * Fetch worker stream messages for a job filtered by activity ID.
+ * Includes child activity messages.
+ */
+exports.GET_STREAM_HISTORY_BY_JID_AND_AID = `
+  SELECT
+    id, jid, aid, dad, msg_type, topic, workflow_name,
+    message, created_at, expired_at
+  FROM {schema}.worker_streams
+  WHERE (jid = $1 OR jid LIKE '-' || $1 || '-%')
+    AND aid = $2
+  ORDER BY created_at, id
+`;
 /**
  * Fetch child workflow inputs in batch.
  * Uses parameterized IN clause for exact-match efficiency.

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

@@ -223,6 +223,14 @@ declare class PostgresStoreService extends StoreService<ProviderClient, Provider
         };
         attributes: Record<string, string>;
     }>;
+    /**
+     * Fetch stream message history for a job from worker_streams.
+     * Returns raw activity input/output data from soft-deleted messages.
+     */
+    getStreamHistory(jobId: string, options?: {
+        activity?: string;
+        types?: string[];
+    }): Promise<import('../../../../types/exporter').StreamHistoryEntry[]>;
     /**
      * Parse a HotMesh-encoded value string.
      * Values may be prefixed with `/s` (JSON), `/d` (number), `/t` or `/f` (boolean), `/n` (null).

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

@@ -1365,6 +1365,58 @@ class PostgresStoreService extends __1.StoreService {
         }
         return { job, attributes };
     }
+    /**
+     * Fetch stream message history for a job from worker_streams.
+     * Returns raw activity input/output data from soft-deleted messages.
+     */
+    async getStreamHistory(jobId, options) {
+        const { GET_STREAM_HISTORY_BY_JID, GET_STREAM_HISTORY_BY_JID_AND_TYPE, GET_STREAM_HISTORY_BY_JID_AND_AID, } = await Promise.resolve().then(() => __importStar(require('./exporter-sql')));
+        const schemaName = this.kvsql().safeName(this.appId);
+        let sql;
+        let params;
+        if (options?.activity) {
+            sql = GET_STREAM_HISTORY_BY_JID_AND_AID.replace(/{schema}/g, schemaName);
+            params = [jobId, options.activity];
+        }
+        else if (options?.types?.length) {
+            sql = GET_STREAM_HISTORY_BY_JID_AND_TYPE.replace(/{schema}/g, schemaName);
+            params = [jobId, options.types];
+        }
+        else {
+            sql = GET_STREAM_HISTORY_BY_JID.replace(/{schema}/g, schemaName);
+            params = [jobId];
+        }
+        const result = await this.pgClient.query(sql, params);
+        return result.rows.map((row) => {
+            let parsed = {};
+            try {
+                parsed = JSON.parse(row.message);
+            }
+            catch {
+                // message may not be valid JSON
+            }
+            return {
+                id: parseInt(row.id),
+                jid: row.jid,
+                aid: row.aid,
+                dad: row.dad,
+                msg_type: row.msg_type,
+                topic: row.topic,
+                workflow_name: row.workflow_name,
+                data: parsed.data || {},
+                status: parsed.status,
+                code: parsed.code,
+                created_at: row.created_at instanceof Date
+                    ? row.created_at.toISOString()
+                    : String(row.created_at),
+                expired_at: row.expired_at
+                    ? (row.expired_at instanceof Date
+                        ? row.expired_at.toISOString()
+                        : String(row.expired_at))
+                    : undefined,
+            };
+        });
+    }
     /**
      * Parse a HotMesh-encoded value string.
      * Values may be prefixed with `/s` (JSON), `/d` (number), `/t` or `/f` (boolean), `/n` (null).

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

@@ -64,6 +64,7 @@ export declare abstract class StreamService<ClientProvider extends ProviderClien
         maxMessageSize: number;
         maxBatchSize: number;
     };
+    deadLetterMessages?(streamName: string, groupName: string, messageIds: string[]): Promise<number>;
     stopNotificationConsumer?(streamName: string, groupName: string): Promise<void>;
     cleanup?(): Promise<void>;
 }

package/build/services/stream/providers/postgres/kvtables.js

@@ -129,6 +129,7 @@ async function createTables(client, schemaName) {
       reserved_at TIMESTAMPTZ,
       reserved_by TEXT,
       expired_at TIMESTAMPTZ,
+      dead_lettered_at TIMESTAMPTZ,
       max_retry_attempts INT DEFAULT 3,
       backoff_coefficient NUMERIC DEFAULT 10,
       maximum_interval_seconds INT DEFAULT 120,
@@ -167,6 +168,18 @@ async function createTables(client, schemaName) {
     CREATE INDEX IF NOT EXISTS idx_engine_streams_processed_volume
     ON ${engineTable} (expired_at, stream_name)
     WHERE expired_at IS NOT NULL;
+  `);
+    await client.query(`
+    CREATE INDEX IF NOT EXISTS idx_engine_streams_dead_lettered
+    ON ${engineTable} (dead_lettered_at, stream_name)
+    WHERE dead_lettered_at IS NOT NULL;
+  `);
+    // Migration: add dead_lettered_at column to existing tables
+    await client.query(`
+    DO $$ BEGIN
+      ALTER TABLE ${engineTable} ADD COLUMN IF NOT EXISTS dead_lettered_at TIMESTAMPTZ;
+    EXCEPTION WHEN duplicate_column THEN NULL;
+    END $$;
   `);
     // ---- WORKER_STREAMS table ----
     const workerTable = `${schemaName}.worker_streams`;
@@ -175,11 +188,17 @@ async function createTables(client, schemaName) {
       id BIGSERIAL,
       stream_name TEXT NOT NULL,
       workflow_name TEXT NOT NULL DEFAULT '',
+      jid TEXT NOT NULL DEFAULT '',
+      aid TEXT NOT NULL DEFAULT '',
+      dad TEXT NOT NULL DEFAULT '',
+      msg_type TEXT NOT NULL DEFAULT '',
+      topic TEXT NOT NULL DEFAULT '',
       message TEXT NOT NULL,
       created_at TIMESTAMPTZ DEFAULT NOW(),
       reserved_at TIMESTAMPTZ,
       reserved_by TEXT,
       expired_at TIMESTAMPTZ,
+      dead_lettered_at TIMESTAMPTZ,
       max_retry_attempts INT DEFAULT 3,
       backoff_coefficient NUMERIC DEFAULT 10,
       maximum_interval_seconds INT DEFAULT 120,
@@ -219,6 +238,47 @@ async function createTables(client, schemaName) {
     ON ${workerTable} (expired_at, stream_name)
     WHERE expired_at IS NOT NULL;
   `);
+    await client.query(`
+    CREATE INDEX IF NOT EXISTS idx_worker_streams_dead_lettered
+    ON ${workerTable} (dead_lettered_at, stream_name)
+    WHERE dead_lettered_at IS NOT NULL;
+  `);
+    // Migration: add dead_lettered_at column to existing tables
+    await client.query(`
+    DO $$ BEGIN
+      ALTER TABLE ${workerTable} ADD COLUMN IF NOT EXISTS dead_lettered_at TIMESTAMPTZ;
+    EXCEPTION WHEN duplicate_column THEN NULL;
+    END $$;
+  `);
+    // ---- Export fidelity columns and indexes ----
+    // These columns surface stream message metadata for efficient job history queries.
+    // Migration: add columns to existing tables (no-op on fresh installs)
+    for (const col of ['jid', 'aid', 'dad', 'msg_type', 'topic']) {
+        await client.query(`
+      DO $$ BEGIN
+        ALTER TABLE ${workerTable} ADD COLUMN IF NOT EXISTS ${col} TEXT NOT NULL DEFAULT '';
+      EXCEPTION WHEN duplicate_column THEN NULL;
+      END $$;
+    `);
+    }
+    // All messages for a job, ordered by time
+    await client.query(`
+    CREATE INDEX IF NOT EXISTS idx_worker_streams_jid_created
+    ON ${workerTable} (jid, created_at)
+    WHERE jid != '';
+  `);
+    // Activity-specific lookups within a job
+    await client.query(`
+    CREATE INDEX IF NOT EXISTS idx_worker_streams_jid_aid
+    ON ${workerTable} (jid, aid, created_at)
+    WHERE jid != '';
+  `);
+    // Type-filtered queries (e.g., only worker invocations + responses)
+    await client.query(`
+    CREATE INDEX IF NOT EXISTS idx_worker_streams_jid_type
+    ON ${workerTable} (jid, msg_type, created_at)
+    WHERE jid != '';
+  `);
 }
 async function createNotificationTriggers(client, schemaName) {
     const engineTable = `${schemaName}.engine_streams`;

package/build/services/stream/providers/postgres/messages.d.ts

@@ -46,6 +46,11 @@ export declare function deleteMessages(client: PostgresClientType & ProviderClie
  * Acknowledge and delete messages in one operation.
  */
 export declare function ackAndDelete(client: PostgresClientType & ProviderClient, tableName: string, streamName: string, messageIds: string[], logger: ILogger): Promise<number>;
+/**
+ * Move messages to the dead-letter state by setting dead_lettered_at
+ * and expired_at. The message payload is preserved for inspection.
+ */
+export declare function deadLetterMessages(client: PostgresClientType & ProviderClient, tableName: string, streamName: string, messageIds: string[], logger: ILogger): Promise<number>;
 /**
  * Retry messages (placeholder for future implementation).
  */

package/build/services/stream/providers/postgres/messages.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.retryMessages = exports.ackAndDelete = exports.deleteMessages = exports.acknowledgeMessages = exports.fetchMessages = exports.buildPublishSQL = exports.publishMessages = void 0;
+exports.retryMessages = exports.deadLetterMessages = exports.ackAndDelete = exports.deleteMessages = exports.acknowledgeMessages = exports.fetchMessages = exports.buildPublishSQL = exports.publishMessages = void 0;
 const utils_1 = require("../../../../modules/utils");
 /**
  * Publish messages to a stream. Can be used within a transaction.
@@ -49,8 +49,13 @@ function buildPublishSQL(tableName, streamName, isEngine, messages, options) {
         delete data._streamRetryConfig;
         delete data._visibilityDelayMs;
         delete data._retryAttempt;
-        // Extract workflow name for worker streams
+        // Extract metadata for worker stream columns
         const workflowName = data.metadata?.wfn || '';
+        const jid = data.metadata?.jid || '';
+        const aid = data.metadata?.aid || '';
+        const dad = data.metadata?.dad || '';
+        const msgType = data.type || '';
+        const topic = data.metadata?.topic || '';
         // Determine if this message has explicit retry config
         const hasExplicitConfig = (retryConfig && 'max_retry_attempts' in retryConfig) || options?.retryPolicy;
         let normalizedPolicy = null;
@@ -71,6 +76,11 @@ function buildPublishSQL(tableName, streamName, isEngine, messages, options) {
             visibilityDelayMs: visibilityDelayMs || 0,
             retryAttempt: retryAttempt || 0,
             workflowName,
+            jid,
+            aid,
+            dad,
+            msgType,
+            topic,
         };
     });
     const params = [streamName];
@@ -124,45 +134,45 @@ function buildPublishSQL(tableName, streamName, isEngine, messages, options) {
         }
     }
     else {
-        // Worker table: includes workflow_name, no group_name
+        // Worker table: includes workflow_name + export fidelity columns, no group_name
         if (noneHaveConfig && !hasVisibilityDelays) {
-            insertColumns = '(stream_name, workflow_name, message)';
+            insertColumns = '(stream_name, workflow_name, jid, aid, dad, msg_type, topic, message)';
             parsedMessages.forEach((pm) => {
                 const paramOffset = params.length + 1;
-                valuesClauses.push(`($1, $${paramOffset}, $${paramOffset + 1})`);
-                params.push(pm.workflowName, pm.message);
+                valuesClauses.push(`($1, $${paramOffset}, $${paramOffset + 1}, $${paramOffset + 2}, $${paramOffset + 3}, $${paramOffset + 4}, $${paramOffset + 5}, $${paramOffset + 6})`);
+                params.push(pm.workflowName, pm.jid, pm.aid, pm.dad, pm.msgType, pm.topic, pm.message);
             });
         }
         else if (noneHaveConfig && hasVisibilityDelays) {
-            insertColumns = '(stream_name, workflow_name, message, visible_at, retry_attempt)';
+            insertColumns = '(stream_name, workflow_name, jid, aid, dad, msg_type, topic, message, visible_at, retry_attempt)';
             parsedMessages.forEach((pm) => {
                 const paramOffset = params.length + 1;
                 if (pm.visibilityDelayMs > 0) {
                     const visibleAtSQL = `NOW() + INTERVAL '${pm.visibilityDelayMs} milliseconds'`;
-                    valuesClauses.push(`($1, $${paramOffset}, $${paramOffset + 1}, ${visibleAtSQL}, $${paramOffset + 2})`);
-                    params.push(pm.workflowName, pm.message, pm.retryAttempt);
+                    valuesClauses.push(`($1, $${paramOffset}, $${paramOffset + 1}, $${paramOffset + 2}, $${paramOffset + 3}, $${paramOffset + 4}, $${paramOffset + 5}, $${paramOffset + 6}, ${visibleAtSQL}, $${paramOffset + 7})`);
+                    params.push(pm.workflowName, pm.jid, pm.aid, pm.dad, pm.msgType, pm.topic, pm.message, pm.retryAttempt);
                 }
                 else {
-                    valuesClauses.push(`($1, $${paramOffset}, $${paramOffset + 1}, DEFAULT, $${paramOffset + 2})`);
-                    params.push(pm.workflowName, pm.message, pm.retryAttempt);
+                    valuesClauses.push(`($1, $${paramOffset}, $${paramOffset + 1}, $${paramOffset + 2}, $${paramOffset + 3}, $${paramOffset + 4}, $${paramOffset + 5}, $${paramOffset + 6}, DEFAULT, $${paramOffset + 7})`);
+                    params.push(pm.workflowName, pm.jid, pm.aid, pm.dad, pm.msgType, pm.topic, pm.message, pm.retryAttempt);
                 }
             });
         }
         else {
-            insertColumns = '(stream_name, workflow_name, message, max_retry_attempts, backoff_coefficient, maximum_interval_seconds, visible_at, retry_attempt)';
+            insertColumns = '(stream_name, workflow_name, jid, aid, dad, msg_type, topic, message, max_retry_attempts, backoff_coefficient, maximum_interval_seconds, visible_at, retry_attempt)';
             parsedMessages.forEach((pm) => {
                 const visibleAtClause = pm.visibilityDelayMs > 0
                     ? `NOW() + INTERVAL '${pm.visibilityDelayMs} milliseconds'`
                     : 'DEFAULT';
                 if (pm.hasExplicitConfig) {
                     const paramOffset = params.length + 1;
-                    valuesClauses.push(`($1, $${paramOffset}, $${paramOffset + 1}, $${paramOffset + 2}, $${paramOffset + 3}, $${paramOffset + 4}, ${visibleAtClause}, $${paramOffset + 5})`);
-                    params.push(pm.workflowName, pm.message, pm.retryPolicy.max_retry_attempts, pm.retryPolicy.backoff_coefficient, pm.retryPolicy.maximum_interval_seconds, pm.retryAttempt);
+                    valuesClauses.push(`($1, $${paramOffset}, $${paramOffset + 1}, $${paramOffset + 2}, $${paramOffset + 3}, $${paramOffset + 4}, $${paramOffset + 5}, $${paramOffset + 6}, $${paramOffset + 7}, $${paramOffset + 8}, $${paramOffset + 9}, ${visibleAtClause}, $${paramOffset + 10})`);
+                    params.push(pm.workflowName, pm.jid, pm.aid, pm.dad, pm.msgType, pm.topic, pm.message, pm.retryPolicy.max_retry_attempts, pm.retryPolicy.backoff_coefficient, pm.retryPolicy.maximum_interval_seconds, pm.retryAttempt);
                 }
                 else {
                     const paramOffset = params.length + 1;
-                    valuesClauses.push(`($1, $${paramOffset}, $${paramOffset + 1}, DEFAULT, DEFAULT, DEFAULT, ${visibleAtClause}, $${paramOffset + 2})`);
-                    params.push(pm.workflowName, pm.message, pm.retryAttempt);
+                    valuesClauses.push(`($1, $${paramOffset}, $${paramOffset + 1}, $${paramOffset + 2}, $${paramOffset + 3}, $${paramOffset + 4}, $${paramOffset + 5}, $${paramOffset + 6}, DEFAULT, DEFAULT, DEFAULT, ${visibleAtClause}, $${paramOffset + 7})`);
+                    params.push(pm.workflowName, pm.jid, pm.aid, pm.dad, pm.msgType, pm.topic, pm.message, pm.retryAttempt);
                 }
             });
         }
@@ -290,6 +300,27 @@ async function ackAndDelete(client, tableName, streamName, messageIds, logger) {
     return await deleteMessages(client, tableName, streamName, messageIds, logger);
 }
 exports.ackAndDelete = ackAndDelete;
+/**
+ * Move messages to the dead-letter state by setting dead_lettered_at
+ * and expired_at. The message payload is preserved for inspection.
+ */
+async function deadLetterMessages(client, tableName, streamName, messageIds, logger) {
+    try {
+        const ids = messageIds.map((id) => parseInt(id));
+        const res = await client.query(`UPDATE ${tableName}
+       SET dead_lettered_at = NOW(), expired_at = NOW()
+       WHERE stream_name = $1 AND id = ANY($2::bigint[])`, [streamName, ids]);
+        return res.rowCount;
+    }
+    catch (error) {
+        logger.error(`postgres-stream-dead-letter-error-${streamName}`, {
+            error,
+            messageIds,
+        });
+        throw error;
+    }
+}
+exports.deadLetterMessages = deadLetterMessages;
 /**
  * Retry messages (placeholder for future implementation).
  */

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

@@ -73,6 +73,7 @@ declare class PostgresStreamService extends StreamService<PostgresClientType & P
     stopNotificationConsumer(streamName: string, groupName: string): Promise<void>;
     private fetchMessages;
     ackAndDelete(streamName: string, groupName: string, messageIds: string[]): Promise<number>;
+    deadLetterMessages(streamName: string, groupName: string, messageIds: string[]): Promise<number>;
     acknowledgeMessages(streamName: string, groupName: string, messageIds: string[], options?: StringAnyType): Promise<number>;
     deleteMessages(streamName: string, groupName: string, messageIds: string[], options?: StringAnyType): Promise<number>;
     retryMessages(streamName: string, groupName: string, options?: {

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

@@ -220,6 +220,10 @@ class PostgresStreamService extends index_1.StreamService {
         const target = this.resolveStreamTarget(streamName);
         return Messages.ackAndDelete(this.streamClient, target.tableName, target.streamName, messageIds, this.logger);
     }
+    async deadLetterMessages(streamName, groupName, messageIds) {
+        const target = this.resolveStreamTarget(streamName);
+        return Messages.deadLetterMessages(this.streamClient, target.tableName, target.streamName, messageIds, this.logger);
+    }
     async acknowledgeMessages(streamName, groupName, messageIds, options) {
         return Messages.acknowledgeMessages(messageIds);
     }

package/build/services/stream/providers/postgres/scout.js

@@ -59,7 +59,7 @@ class ScoutManager {
             if (!wasScout) {
                 // First time becoming scout - set timeout to reset after interval and track start time
                 this.scoutStartTime = Date.now();
-                this.logger.info('postgres-stream-router-scout-role-acquired', {
+                this.logger.debug('postgres-stream-router-scout-role-acquired', {
                     appId: this.appId,
                 });
                 setTimeout(() => {
@@ -216,7 +216,7 @@ class ScoutManager {
         const durationMinutes = durationMs / 1000 / 60;
         const qpm = durationMinutes > 0 ? this.pollCount / durationMinutes : 0;
         const qps = durationMs > 0 ? this.pollCount / (durationMs / 1000) : 0;
-        this.logger.info('postgres-stream-router-scout-metrics', {
+        this.logger.debug('postgres-stream-router-scout-metrics', {
             appId: this.appId,
             totalPolls: this.pollCount,
             totalNotifications: this.totalNotifications,

package/build/services/stream/providers/postgres/stats.js

@@ -61,7 +61,7 @@ async function trimStream(client, tableName, streamName, options, logger) {
         if (options.maxLen !== undefined) {
             const res = await client.query(`WITH to_expire AS (
           SELECT id FROM ${tableName}
-          WHERE stream_name = $1
+          WHERE stream_name = $1 AND dead_lettered_at IS NULL
           ORDER BY id ASC
           OFFSET $2
         )
@@ -73,7 +73,8 @@ async function trimStream(client, tableName, streamName, options, logger) {
         if (options.maxAge !== undefined) {
             const res = await client.query(`UPDATE ${tableName}
         SET expired_at = NOW()
-        WHERE stream_name = $1 AND created_at < NOW() - INTERVAL '${options.maxAge} milliseconds'`, [streamName]);
+        WHERE stream_name = $1 AND dead_lettered_at IS NULL
+          AND created_at < NOW() - INTERVAL '${options.maxAge} milliseconds'`, [streamName]);
             expiredCount += res.rowCount;
         }
         return expiredCount;

package/build/types/exporter.d.ts

@@ -18,6 +18,13 @@ export interface ExportOptions {
      * @default true
      */
     values?: boolean;
+    /**
+     * When true, fetches stream message history and produces a structured
+     * `activities` array with input/output per activity, timing, dimensional
+     * cycle info, and retry attempts. This is the dashboard-friendly format.
+     * @default false
+     */
+    enrich_inputs?: boolean;
 }
 export type JobAction = {
     cursor: number;
@@ -74,10 +81,24 @@ export interface DurableJobExport {
     timeline?: TimelineType[];
     transitions?: TransitionType[];
 }
+export interface ActivityDetail {
+    name: string;
+    type: string;
+    dimension: string;
+    input?: Record<string, any>;
+    output?: Record<string, any>;
+    started_at?: string;
+    completed_at?: string;
+    duration_ms?: number;
+    retry_attempt?: number;
+    cycle_iteration?: number;
+    error?: string | null;
+}
 export interface JobExport {
     dependencies: DependencyExport[];
     process: StringAnyType;
     status: string;
+    activities?: ActivityDetail[];
 }
 export type ExportMode = 'sparse' | 'verbose';
 export type WorkflowEventType = 'workflow_execution_started' | 'workflow_execution_completed' | 'workflow_execution_failed' | 'activity_task_scheduled' | 'activity_task_completed' | 'activity_task_failed' | 'child_workflow_execution_started' | 'child_workflow_execution_completed' | 'child_workflow_execution_failed' | 'timer_started' | 'timer_fired' | 'workflow_execution_signaled';
@@ -203,6 +224,7 @@ export interface WorkflowExecution {
     events: WorkflowExecutionEvent[];
     summary: WorkflowExecutionSummary;
     children?: WorkflowExecution[];
+    stream_history?: StreamHistoryEntry[];
 }
 export interface ExecutionExportOptions {
     mode?: ExportMode;
@@ -225,6 +247,29 @@ export interface ExecutionExportOptions {
      * @default false
      */
     allow_direct_query?: boolean;
+    /**
+     * When true, fetches the full stream message history for this workflow
+     * from the worker_streams table and attaches it as `stream_history`.
+     * This provides raw activity input/output data from the original stream
+     * messages, enabling Temporal-grade export fidelity.
+     *
+     * @default false
+     */
+    include_stream_history?: boolean;
+}
+export interface StreamHistoryEntry {
+    id: number;
+    jid: string;
+    aid: string;
+    dad: string;
+    msg_type: string;
+    topic: string;
+    workflow_name: string;
+    data: Record<string, any>;
+    status?: string;
+    code?: number;
+    created_at: string;
+    expired_at?: string;
 }
 export interface JobAttributesRow {
     field: string;

package/build/types/index.d.ts

@@ -6,7 +6,7 @@ export { CollationFaultType, CollationStage } from './collator';
 export { ActivityConfig, ActivityInterceptor, ActivityInterceptorContext, ActivityWorkflowDataType, ChildResponseType, ClientConfig, ClientWorkflow, ContextType, Connection, ProxyResponseType, ProxyType, Registry, SignalOptions, FindJobsOptions, FindOptions, FindWhereOptions, FindWhereQuery, HookOptions, SearchResults, WorkflowConfig, WorkerConfig, WorkerOptions, WorkflowContext, WorkflowSearchOptions, WorkflowSearchSchema, WorkflowDataType, WorkflowOptions, WorkflowInterceptor, InterceptorRegistry, } from './durable';
 export { PruneOptions, PruneResult, } from './dba';
 export { DurableChildErrorType, DurableProxyErrorType, DurableSleepErrorType, DurableWaitForAllErrorType, DurableWaitForErrorType, } from './error';
-export { ActivityAction, DependencyExport, DurableJobExport, ExecutionExportOptions, ExportCycles, ExportItem, ExportMode, ExportOptions, ExportTransitions, JobAction, JobExport, JobActionExport, JobTimeline, WorkflowEventAttributes, WorkflowEventCategory, WorkflowEventType, WorkflowExecution, WorkflowExecutionEvent, WorkflowExecutionStatus, WorkflowExecutionSummary, } from './exporter';
+export { ActivityAction, ActivityDetail, ActivityInputMap, ActivityTaskCompletedAttributes, ActivityTaskFailedAttributes, ActivityTaskScheduledAttributes, ChildWorkflowExecutionCompletedAttributes, ChildWorkflowExecutionFailedAttributes, ChildWorkflowExecutionStartedAttributes, DependencyExport, DurableJobExport, ExecutionExportOptions, ExportCycles, ExportFields, ExportItem, ExportMode, ExportOptions, ExportTransitions, JobAction, JobActionExport, JobAttributesRow, JobExport, JobRow, JobTimeline, StreamHistoryEntry, TimelineType, TimerFiredAttributes, TimerStartedAttributes, TransitionType, WorkflowEventAttributes, WorkflowEventCategory, WorkflowEventType, WorkflowExecution, WorkflowExecutionCompletedAttributes, WorkflowExecutionEvent, WorkflowExecutionFailedAttributes, WorkflowExecutionSignaledAttributes, WorkflowExecutionStartedAttributes, WorkflowExecutionStatus, WorkflowExecutionSummary, } from './exporter';
 export { HookCondition, HookConditions, HookGate, HookInterface, HookRule, HookRules, HookSignal, } from './hook';
 export { HotMesh, HotMeshEngine, HotMeshWorker, HotMeshSettings, HotMeshApp, HotMeshApps, HotMeshConfig, HotMeshManifest, HotMeshGraph, KeyType, KeyStoreParams, ScoutType, } from './hotmesh';
 export { ILogger, LogLevel } from './logger';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hotmeshio/hotmesh",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Permanent-Memory Workflows & AI Agents",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",