glide-mq 0.12.0 → 0.14.0

package/CHANGELOG.md

@@ -6,6 +6,70 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ---
 
+## [0.14.0] - 2026-03-28
+
+### Breaking Changes
+
+- **JobUsage redesigned**: `inputTokens`/`outputTokens` replaced with `tokens: Record<string, number>` for extensible category tracking (input, output, reasoning, cachedInput, etc.)
+- **Cost tracking redesigned**: `costUsd` replaced with `costs: Record<string, number>` + `costUnit` for currency-agnostic per-category cost tracking
+- **BudgetOptions expanded**: `maxCostUsd` replaced with `maxTotalCost`. Added `maxTokens` (per-category caps), `tokenWeights` (weighted totals), `maxCosts` (per-category cost caps), `costUnit`
+- **getFlowUsage return type changed**: `totalInputTokens`/`totalOutputTokens`/`totalCostUsd` replaced with `tokens`/`costs` maps + `totalTokens`/`totalCost`
+
+### Added
+
+- `job.streamChunk(type, content?)` - typed streaming convenience for reasoning vs content chunks
+- Per-category budget enforcement with independent limits per token/cost category
+- Weighted token budgets - reasoning tokens can count 4x toward budget
+- `ConnectionOptions.requestTimeout` - configurable command timeout (was hardcoded 500ms)
+- 9 new examples: thinking-model, cost-breakdown, budget-weighted, reasoning-stream, agent-budget-loop, multi-model-cost, fallback-usage, streaming-sse, batch-embed-tpm
+- Upgraded to valkey-search 1.2 in test infrastructure (compose.yaml)
+- Bumped speedkey to 0.3.0-rc1
+
+### Fixed
+
+- Budget bypass when only `totalTokens` reported without `tokens` breakdown
+- `JSON.parse` null safety in budget and usage parsing
+- Prototype pollution prevention with `Object.create(null)` in aggregation maps
+- DAG cluster test flaky timeouts (15s -> 30s)
+- `TestJobRecord` missing `usage` field causing empty `getFlowUsage()` in testing mode
+
+---
+
+## [0.13.0] - 2026-03-27
+
+### Added
+
+- **Structured AI metadata** (#168): `job.reportUsage({ model, tokens: { input, output }, costs: { total } })` records LLM usage on any job. `queue.getFlowUsage(flowId)` aggregates token counts and cost across an entire flow.
+- **Per-job streaming channel** (#169): `job.stream(chunk)` publishes incremental data (LLM tokens, progress events) to a dedicated channel. `queue.readStream(jobId, opts?)` consumes chunks in real time. Blocking reads via XREAD BLOCK.
+- **Suspend/resume with signals** (#170): `job.suspend(opts?)` pauses a job mid-processor; `queue.signal(jobId, name, data?)` resumes it with an external event. Enables human-in-the-loop approval gates, webhook callbacks, and any pattern requiring external input before a job can continue.
+  - `SuspendOptions`: `reason` (label), `timeout` (auto-fail after N ms)
+  - `onResume` callback: best-effort same-worker continuation called with `signals[]` on resume
+  - `queue.getSuspendInfo(jobId)`: returns suspension metadata and signals delivered so far
+  - `glidemq_suspend` FCALL: moves active job to suspended sorted set, releases group slot
+  - `glidemq_signal` FCALL: appends signal, re-queues job to stream
+  - `glidemq_sweepSuspended` FCALL: fails timed-out suspended jobs on each stalled recovery tick
+  - Proxy: `POST /queues/:name/jobs/:id/signal` endpoint
+  - Testing: `TestJob.suspend()` and `TestQueue.signal()` with full parity (no Valkey)
+- **Per-job lockDuration override** (#172): set `lockDuration` per job to control heartbeat interval and stall detection timeout independently of the worker default.
+- **Fallback chains** (#173): ordered list of model/provider alternatives via `opts.fallbacks`. On processor failure, the job automatically retries with the next fallback entry. Each fallback can override `data` and `metadata`.
+- **Budget middleware** (#174): flow-level token and cost caps. Set `budget: { maxTokens, maxCost }` on a flow; jobs that would exceed the budget are failed before execution.
+- **Dual-axis rate limiting (RPM + TPM)** (#175): enforce both requests-per-minute and tokens-per-minute limits on a queue. Designed for LLM API compliance where providers impose concurrent rate ceilings.
+- **18 real-world AI examples** (#176): framework integrations covering LangChain, Vercel AI SDK, OpenAI, Anthropic, multi-model routing, RAG pipelines, and more.
+- **Valkey Search integration** (#177): vector search over jobs using Valkey Search module. `queue.createIndex(schema, opts?)` defines indexes; `queue.search(query, opts?)` runs hybrid vector + filter queries. `IndexCreateOptions` and `SearchQueryOptions` types decoupled from speedkey.
+- `SuspendError`, `SuspendOptions`, `SignalEntry` exported from public API.
+- Stress tests: 38 tests for correctness under concurrent load and edge-case pressure.
+- Docker: `compose.yaml` uses `valkey-bundle` image (search + json + bloom modules).
+- CI: `test-search` job with `valkey-bundle` for search integration tests.
+
+### Fixed
+
+- OTel `SpanStatusCode` values corrected (OK=1, ERROR=2) - previously swapped.
+- Signal data auto-deserialization: signals received via `onResume` are now parsed from JSON automatically.
+- Fallback type uses explicit `metadata` field instead of index signature.
+- `glidemq_clean` and `glidemq_drain` now delete `signals:{id}` LIST keys when removing jobs, preventing a key leak when suspended jobs time out or are cleaned after failure.
+
+---
+
 ## [0.12.0] - 2026-03-20
 
 ### Added
@@ -44,8 +108,6 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 - `groupq` key type changed from LIST to ZSET. Existing groups with queued jobs need migration (drain before upgrade). Pre-stable, acceptable.
 
-## [Unreleased]
-
 ---
 
 ## [0.11.0] - 2026-03-10

package/README.md

@@ -3,247 +3,211 @@
 [![npm version](https://img.shields.io/npm/v/glide-mq)](https://www.npmjs.com/package/glide-mq)
 [![license](https://img.shields.io/npm/l/glide-mq)](https://github.com/avifenesh/glide-mq/blob/main/LICENSE)
 [![CI](https://github.com/avifenesh/glide-mq/actions/workflows/ci.yml/badge.svg)](https://github.com/avifenesh/glide-mq/actions/workflows/ci.yml)
-[![node](https://img.shields.io/node/v/glide-mq)](https://nodejs.org/)
-[![changelog](https://img.shields.io/badge/changelog-CHANGELOG.md-blue)](CHANGELOG.md)
-[![docs](https://img.shields.io/badge/docs-glide--mq.dev-6366f1)](https://avifenesh.github.io/glide-mq.dev/)
 
-High-performance message queue for Node.js built on Valkey/Redis Streams with 1-RTT job operations and cluster-native design.
+High-performance message queue for Node.js with first-class AI orchestration. Built on Valkey/Redis Streams with a Rust NAPI core.
 
-glide-mq is for anyone building background jobs, task queues, or workflow orchestration in Node.js. It connects through a Rust-native NAPI client ([valkey-glide](https://github.com/valkey-io/valkey-glide)), executes all queue logic in a single Valkey Server Function call per operation (FCALL, not EVAL), and hash-tags every key for automatic cluster slot alignment. The result is fewer round trips, no Lua cache misses, and zero cluster configuration.
-
-> If glide-mq is useful to you, consider giving it a star on [GitHub](https://github.com/avifenesh/glide-mq). It helps others discover the project.
-
-## Why glide-mq
-
-- Use this when you need **throughput**: 18,000+ jobs/s on production infrastructure with TLS -- up to 36% faster than alternatives at typical concurrency, 1 RTT per job via Valkey Server Functions.
-- Use this when you run **Valkey/Redis clusters**: all keys hash-tagged out of the box, no `{braces}` workarounds.
-- Use this when you need **workflows**: parent-child trees, DAGs with fan-in, step jobs, batch processing, and cron scheduling in one library.
-- Use this when you deploy to **serverless**: lightweight `Producer` and `ServerlessPool` cache connections across warm invocations.
-- Use this when you want **pub/sub with durability**: `Broadcast` delivers to all subscribers with retries, backpressure, and NATS-style subject filtering.
-
-## Install
+Completes and fetches the next job in a single server-side function call (1 RTT per job), hash-tags every key for zero-config clustering, and ships seven built-in primitives for LLM orchestration - cost tracking, token streaming, human-in-the-loop, model failover, TPM rate limiting, budget caps, and vector search.
 
 ```bash
 npm install glide-mq
 ```
 
-Requires Node.js 20+ and a running [Valkey](https://valkey.io) 7.0+ or Redis 7.0+ instance.
-
-## Quick start
+### General Usage
 
 ```typescript
 import { Queue, Worker } from 'glide-mq';
 
 const connection = { addresses: [{ host: 'localhost', port: 6379 }] };
-
 const queue = new Queue('tasks', { connection });
-await queue.add('send-email', { to: 'user@example.com', subject: 'Hello' });
 
-const worker = new Worker('tasks', async (job) => {
-  console.log(`Processing ${job.name}:`, job.data);
-  return { sent: true };
-}, { connection, concurrency: 10 });
+await queue.add('send-email', { to: 'user@example.com', subject: 'Welcome' });
 
-worker.on('completed', (job) => console.log(`Job ${job.id} done`));
-worker.on('failed', (job, err) => console.error(`Job ${job.id} failed:`, err.message));
+const worker = new Worker(
+  'tasks',
+  async (job) => {
+    await sendEmail(job.data.to, job.data.subject);
+    return { sent: true };
+  },
+  { connection, concurrency: 10 },
+);
 ```
 
-## Performance
-
-Benchmarked on production infrastructure -- not localhost, where all queues look similar.
-
-**Setup**: AWS ElastiCache Valkey 8.2 (r7g.large), TLS enabled, EC2 client in the same region. No-op processor, warmup jobs excluded from measurement.
-
-| Concurrency | glide-mq    | Leading alternative | Delta       |
-|:-----------:|------------:|--------------------:|:-----------:|
-| c=1         | 2,479 j/s   | 2,535 j/s           | -2%         |
-| c=5         | 10,754 j/s  | 9,866 j/s           | +9%         |
-| c=10        | **18,218 j/s** | 13,541 j/s       | **+35%**    |
-| c=15        | **19,583 j/s** | 14,162 j/s       | **+38%**    |
-| c=20        | 19,408 j/s  | 16,085 j/s          | +21%        |
-| c=50        | 19,768 j/s  | 19,159 j/s          | +3%         |
-
-Most production deployments run workers with concurrency between 5 and 20 -- exactly where glide-mq's architecture pays off the most. The advantage comes from completing and fetching the next job in a single server-side function call (1 RTT per job). When the network between your application and Valkey/Redis is real -- as it is in every production deployment where app servers and data stores run on separate machines -- that round-trip savings compounds across concurrent workers.
+### AI Usage
 
-At higher concurrency levels both libraries converge toward the Valkey single-thread execution ceiling, which is the expected behavior.
+```typescript
+import { Queue, Worker } from 'glide-mq';
 
-Other highlights:
+const queue = new Queue('ai', { connection });
+
+await queue.add(
+  'inference',
+  { prompt: 'Explain message queues' },
+  {
+    fallbacks: [{ model: 'gpt-5.4-nano', provider: 'openai' }],
+    lockDuration: 120000,
+  },
+);
+
+const worker = new Worker(
+  'ai',
+  async (job) => {
+    const result = await callLLM(job.data.prompt);
+    await job.reportUsage({
+      model: 'gpt-5.4',
+      tokens: { input: 50, output: 200 },
+      costs: { total: 0.003 },
+    });
+    await job.stream({ type: 'token', content: result });
+    return result;
+  },
+  { connection, tokenLimiter: { maxTokens: 100000, duration: 60000 } },
+);
+```
 
-- **addBulk**: 10,000 jobs in 350 ms
-- **Gzip compression**: 98% payload reduction on 15 KB payloads
+## When to use glide-mq
 
-Run `npm run bench` locally or `npx tsx benchmarks/elasticache-head-to-head.ts` against your own infrastructure to reproduce.
+- **Background jobs and task processing** - email, image processing, data pipelines, webhooks, any async work.
+- **Scheduled and recurring work** - cron jobs, interval tasks, bounded schedulers.
+- **Distributed workflows** - parent-child trees, DAGs, fan-in/fan-out, step jobs, dynamic children.
+- **High-throughput queues over real networks** - 1 RTT per job via Valkey Server Functions, up to 38% faster than alternatives.
+- **LLM pipelines and model orchestration** - cost tracking, token streaming, model failover, budget caps without external middleware.
+- **Valkey/Redis clusters** - hash-tagged keys out of the box with zero configuration.
 
 ## How it's different
 
-| Aspect | glide-mq approach |
-|--------|-------------------|
-| **Network per job** | 1 RTT -- complete current job + fetch next in a single FCALL |
-| **Client** | Rust NAPI bindings ([valkey-glide](https://github.com/valkey-io/valkey-glide)) -- no JS protocol parsing |
-| **Server logic** | 1 persistent Valkey Function library (FUNCTION LOAD + FCALL) -- no per-call EVAL recompilation |
-| **Cluster** | Hash-tagged keys (`glide:{queueName}:*`) -- all queue data routes to the same slot automatically |
-| **Workflows** | FlowProducer trees, DAGs with fan-in, chain/group/chord, step jobs, dynamic children |
-| **Pub/sub** | Broadcast with NATS-style subject filtering, independent subscriber retries |
-| **Serverless** | Lightweight `Producer` + `ServerlessPool` for Lambda/Edge with connection reuse |
-
-## Core concepts
-
-- **Queue** -- stores jobs in Valkey Streams. Handles enqueue, delay, priority, pause, drain, and bulk operations.
-- **Worker** -- processes jobs with configurable concurrency, prefetch, lock duration, and stalled-job recovery.
-- **Job** -- a unit of work with name, data, options (retries, backoff, priority, TTL), and lifecycle events.
-- **FlowProducer** -- creates parent-child job trees and DAGs. A parent waits for all children before processing.
-- **Producer** -- lightweight enqueue-only client. No EventEmitter, no Job instances, returns plain string IDs. Built for serverless.
-- **Broadcast** -- fan-out pub/sub. Each message is delivered to every subscriber group with independent retries and backpressure.
-- **QueueEvents** -- real-time stream of job lifecycle events (completed, failed, delayed, waiting, etc.).
-
-## Features
-
-### Core
-
-- **Queues and workers** with configurable concurrency, prefetch, and lock duration ([Usage](docs/USAGE.md))
-- **Delayed, priority, and bulk enqueue** for scheduling and high-throughput ingestion ([Usage](docs/USAGE.md))
-- **Batch processing** -- process multiple jobs at once via `batch: { size, timeout? }` ([Usage](docs/USAGE.md#batch-processing))
-- **Request-reply** -- `queue.addAndWait(name, data, { waitTimeout })` for synchronous RPC ([Usage](docs/USAGE.md#request-reply-with-addandwait))
-- **LIFO mode** -- `lifo: true` processes newest jobs first ([Advanced](docs/ADVANCED.md#lifo-mode))
-- **Job TTL** -- auto-expire jobs after a time-to-live window ([Advanced](docs/ADVANCED.md#job-ttl))
-- **Custom job IDs** -- deterministic, idempotent enqueue; duplicates return `null` ([Advanced](docs/ADVANCED.md#custom-job-ids))
-- **Pluggable serializers** -- swap JSON for any `{ serialize, deserialize }` implementation ([Advanced](docs/ADVANCED.md#pluggable-serializers))
-- **Transparent compression** -- gzip payloads at the queue level ([Advanced](docs/ADVANCED.md#transparent-compression))
-
-### Reliability
-
-- **Retries with exponential, fixed, or custom backoff** and dead-letter queues ([Advanced](docs/ADVANCED.md#retries-and-backoff))
-- **UnrecoverableError** -- skip all retries and fail permanently ([Usage](docs/USAGE.md#unrecoverableerror))
-- **Stalled recovery** -- auto-reclaim stuck jobs via consumer group PEL and `XAUTOCLAIM` ([Usage](docs/USAGE.md#worker))
-- **Job revocation** -- cooperative cancellation with `AbortSignal` ([Advanced](docs/ADVANCED.md#job-revocation))
-- **Deduplication** -- simple, throttle, and debounce modes with configurable TTL ([Advanced](docs/ADVANCED.md#deduplication))
-- **Per-key ordering** -- sequential processing per ordering key with configurable group concurrency ([Advanced](docs/ADVANCED.md#ordering-and-group-concurrency))
-- **Rate limiting** -- per-group sliding window, token bucket, and global queue-wide limits ([Advanced](docs/ADVANCED.md#global-rate-limiting))
-- **Sandboxed processors** -- run processors in worker threads or child processes ([Architecture](docs/ARCHITECTURE.md))
-
-### Orchestration
+| Aspect              | glide-mq                                                                                                  |
+| ------------------- | --------------------------------------------------------------------------------------------------------- |
+| **Network per job** | 1 RTT - complete + fetch next in a single FCALL                                                           |
+| **Client**          | Rust NAPI bindings via [valkey-glide](https://github.com/valkey-io/valkey-glide) - no JS protocol parsing |
+| **Server logic**    | Persistent Valkey Function library (FUNCTION LOAD + FCALL) - no per-call EVAL                             |
+| **Cluster**         | Hash-tagged keys (`glide:{queueName}:*`) route to the same slot automatically                             |
+| **AI-native**       | Cost tracking, token streaming, suspend/resume, fallback chains, TPM limits, budget caps                  |
+| **Vector search**   | KNN similarity queries over job data via Valkey Search                                                    |
 
-- **FlowProducer** -- parent-child job trees with `chain`, `group`, and `chord` helpers ([Workflows](docs/WORKFLOWS.md))
-- **DAG workflows** -- arbitrary dependency graphs with `FlowProducer.addDAG()` and `dag()` helper; multi-parent fan-in, diamond patterns, cycle detection ([Workflows](docs/WORKFLOWS.md))
-- **Step jobs** -- `job.moveToDelayed(timestamp, nextStep)` suspends a job mid-processor and resumes later ([Usage](docs/USAGE.md#pause-and-resume-a-job-later-step-jobs))
-- **Dynamic children** -- `job.moveToWaitingChildren()` pauses a parent to add children mid-execution ([Workflows](docs/WORKFLOWS.md))
-- **Batch processing** -- process multiple jobs at once for bulk I/O ([Usage](docs/USAGE.md#batch-processing))
+## AI-native primitives
 
-### Scheduling
+Seven primitives for LLM and agent workflows, built into the core API.
 
-- **Cron and interval schedulers** -- 5-field cron with timezone, fixed intervals, and `repeatAfterComplete` mode ([Advanced](docs/ADVANCED.md#job-schedulers))
-- **Bounded schedulers** -- `limit`, `startDate`, and `endDate` for finite schedules ([Advanced](docs/ADVANCED.md#bounded-schedulers))
+- **Cost tracking** - `job.reportUsage()` records model, tokens, cost, latency per job. `queue.getFlowUsage()` aggregates across flows.
+- **Token streaming** - `job.stream(chunk)` pushes LLM output tokens in real time. `queue.readStream(jobId)` consumes them with optional long-polling.
+- **Suspend/resume** - `job.suspend()` pauses mid-processor for human approval or webhook callback. `queue.signal(jobId, name, data)` resumes with external input.
+- **Fallback chains** - ordered `fallbacks` array on job options. On failure, the next retry reads `job.currentFallback` for the alternate model/provider.
+- **TPM rate limiting** - `tokenLimiter` on worker options enforces tokens-per-minute caps. Combine with RPM `limiter` for dual-axis rate control.
+- **Budget caps** - `FlowProducer.add(flow, { budget })` sets `maxTotalTokens` and `maxTotalCost` across all jobs in a flow. Jobs fail or pause when exceeded.
+- **Per-job lock duration** - override `lockDuration` per job for adaptive stall detection. Short for classifiers, long for multi-minute LLM calls.
 
-### Pub/Sub
+See [Usage - AI-native primitives](docs/USAGE.md#ai-native-primitives) for full examples.
 
-- **Broadcast** -- fan-out delivery to all subscriber groups ([Usage](docs/USAGE.md#broadcast--broadcastworker))
-- **BroadcastWorker** -- independent consumer groups with own retries, concurrency, and backpressure ([Usage](docs/USAGE.md#broadcast--broadcastworker))
-- **Subject filtering** -- NATS-style patterns (`*` one segment, `>` trailing wildcard) for topic-based routing ([Usage](docs/USAGE.md#broadcast--broadcastworker))
-
-### Serverless
-
-- **Producer** -- enqueue without EventEmitter overhead, returns plain string IDs ([Usage](docs/USAGE.md))
-- **ServerlessPool** -- connection caching across warm Lambda/Edge invocations ([Serverless](docs/SERVERLESS.md))
-
-### Observability
-
-- **QueueEvents** -- real-time stream-based lifecycle events ([Observability](docs/OBSERVABILITY.md))
-- **Time-series metrics** -- per-minute throughput and latency retained 24h, recorded server-side ([Observability](docs/OBSERVABILITY.md))
-- **OpenTelemetry** -- automatic span emission; bring your own tracer or auto-detect `@opentelemetry/api` ([Observability](docs/OBSERVABILITY.md))
-- **Job logs** -- append structured log entries per job with pagination ([Observability](docs/OBSERVABILITY.md))
-- **Job mutations** -- `changePriority()`, `changeDelay()`, `promote()` after enqueue; `retryJobs()` and `clean()` in bulk ([Usage](docs/USAGE.md))
-- **Graceful shutdown** -- `gracefulShutdown()` helper registers SIGTERM/SIGINT handlers ([Usage](docs/USAGE.md#graceful-shutdown))
-- **In-memory testing** -- `TestQueue` and `TestWorker` with zero Valkey dependency ([Testing](docs/TESTING.md))
-
-### Cloud
-
-- **Cluster-native** -- hash-tagged keys `glide:{queueName}:*` route all queue data to the same slot ([Usage](docs/USAGE.md#cluster-mode))
-- **IAM authentication** -- native SigV4 auth for AWS ElastiCache and MemoryDB ([Usage](docs/USAGE.md#cluster-mode))
-- **AZ-affinity routing** -- `readFrom: 'AZAffinity'` routes reads to same-AZ replicas ([Usage](docs/USAGE.md#cluster-mode))
-
-## Framework integrations
-
-| Package | Install | Setup |
-|---------|---------|-------|
-| [`@glidemq/hono`](https://github.com/avifenesh/glidemq-hono) | `npm i @glidemq/hono` | `app.use(glideMQ({ connection, queues: { ... } }))` |
-| [`@glidemq/fastify`](https://github.com/avifenesh/glidemq-fastify) | `npm i @glidemq/fastify` | `app.register(glideMQPlugin, { connection, queues: { ... } })` |
-| [`@glidemq/nestjs`](https://github.com/avifenesh/glidemq-nestjs) | `npm i @glidemq/nestjs` | `GlideMQModule.forRoot({ connection, queues: { ... } })` |
-| [`@glidemq/dashboard`](https://github.com/avifenesh/glidemq-dashboard) | `npm i @glidemq/dashboard` | `app.use('/dashboard', createDashboard([queue1, queue2]))` |
-| [`@glidemq/hapi`](https://github.com/avifenesh/glidemq-hapi) | `npm i @glidemq/hapi` | `await server.register({ plugin: glideMQPlugin, options: { connection, queues } })` |
-
-All framework packages provide REST endpoints, SSE events, and serverless Producer support. See each package's README for full documentation.
-
-## Cross-language
-
-Non-Node.js services can enqueue jobs into glide-mq queues using the HTTP proxy or direct FCALL:
-
-```typescript
-import { createProxyServer } from 'glide-mq/proxy';
-
-const proxy = createProxyServer({
-  connection: { addresses: [{ host: 'localhost', port: 6379 }] },
-  queues: ['emails', 'reports'],
-});
-proxy.app.listen(3000);
-```
+## Features
 
-```bash
-curl -X POST http://localhost:3000/queues/emails/jobs \
-  -H 'Content-Type: application/json' \
-  -d '{"name": "send-email", "data": {"to": "user@example.com"}}'
-```
+- **1 RTT per job** - complete current + fetch next in a single server-side function call
+- **Cluster-native** - hash-tagged keys, zero cluster configuration
+- **Workflows** - FlowProducer trees, DAGs with fan-in, chain/group/chord, step jobs, dynamic children
+- **Scheduling** - 5-field cron with timezone, fixed intervals, bounded schedulers
+- **Retries** - exponential, fixed, or custom backoff with dead-letter queues
+- **Rate limiting** - per-group sliding window, token bucket, global queue-wide limits
+- **Broadcast** - fan-out pub/sub with NATS-style subject filtering and independent subscriber retries
+- **Batch processing** - process multiple jobs at once for bulk I/O
+- **Request-reply** - `queue.addAndWait()` for synchronous RPC patterns
+- **Deduplication** - simple, throttle, and debounce modes
+- **Compression** - transparent gzip at the queue level
+- **Serverless** - lightweight `Producer` and `ServerlessPool` for Lambda/Edge
+- **OpenTelemetry** - automatic span emission with bring-your-own tracer
+- **In-memory testing** - `TestQueue` and `TestWorker` with zero Valkey dependency
+- **Cross-language** - HTTP proxy and wire protocol for non-Node.js services
 
-Endpoints: `POST /queues/:name/jobs`, `POST /queues/:name/jobs/bulk`, `GET /queues/:name/jobs/:id`, `POST /queues/:name/pause`, `POST /queues/:name/resume`, `GET /queues/:name/counts`, `GET /health`.
+## Performance
 
-For zero-overhead integration, call Valkey Server Functions directly from any language with a Valkey client. See [Wire Protocol](docs/WIRE_PROTOCOL.md) for FCALL signatures, key layout, and examples in Python and Go.
+Benchmarked on AWS ElastiCache Valkey 8.2 (r7g.large) with TLS, EC2 client in the same region.
+
+| Concurrency |   glide-mq |     BullMQ | Delta |
+| :---------: | ---------: | ---------: | :---: |
+|     c=5     | 10,754 j/s |  9,866 j/s |  +9%  |
+|    c=10     | 18,218 j/s | 13,541 j/s | +35%  |
+|    c=15     | 19,583 j/s | 14,162 j/s | +38%  |
+|    c=20     | 19,408 j/s | 16,085 j/s | +21%  |
+
+The advantage comes from completing and fetching the next job in a single FCALL. The savings compound over real network latency - exactly the conditions in every production deployment. At high concurrency both libraries converge toward the Valkey single-thread ceiling.
+
+Reproduce with `npm run bench` or `npx tsx benchmarks/elasticache-head-to-head.ts` against your own infrastructure.
+
+## Examples
+
+27 runnable examples in `examples/`. Run any with `npx tsx examples/<name>.ts`.
+
+| Example                 | What it shows                                   |
+| ----------------------- | ----------------------------------------------- |
+| `usage-tracking.ts`     | Token and cost tracking across multi-step flows |
+| `token-streaming.ts`    | Real-time LLM token streaming to clients        |
+| `human-approval.ts`     | Suspend/resume with editorial review gate       |
+| `model-failover.ts`     | Fallback chains across providers                |
+| `tpm-throttle.ts`       | Dual-axis RPM + TPM rate limiting               |
+| `budget-cap.ts`         | Flow-level token and cost caps                  |
+| `vector-search.ts`      | KNN similarity search with pre-filters          |
+| `with-langchain.ts`     | LangChain integration with token tracking       |
+| `with-vercel-ai-sdk.ts` | Vercel AI SDK integration with streaming        |
+| `rag-pipeline.ts`       | RAG with embedding, indexing, retrieval         |
+| `ai-agent-loop.ts`      | Autonomous agent loop with budget enforcement   |
+| `testing-mode.ts`       | In-memory testing without Valkey                |
+| `agent-budget-loop.ts`  | Agent loop with per-step budget tracking        |
+| `multi-model-cost.ts`   | Cost breakdown across multiple models           |
+| `fallback-usage.ts`     | Usage tracking through fallback chains          |
+| `streaming-sse.ts`      | Server-sent events with token streaming         |
+| `batch-embed-tpm.ts`    | Batch embeddings with TPM rate limiting         |
+| `thinking-model.ts`     | Thinking/reasoning model token tracking         |
+| `cost-breakdown.ts`     | Detailed per-category cost breakdown            |
+| `budget-weighted.ts`    | Weighted budget allocation across flow steps    |
+| `reasoning-stream.ts`   | Streaming reasoning/chain-of-thought tokens     |
+| `adaptive-timeout.ts`   | Adaptive lock duration based on model complexity |
+| `broadcast-events.ts`   | Fan-out event publishing with subject filtering  |
+| `agent-memory.ts`       | Multi-turn agent with persistent memory          |
+| `search-dashboard.ts`   | Job search and monitoring dashboard              |
+| `embedding-pipeline.ts` | Batch document embedding with rate limiting      |
+| `content-pipeline.ts`   | Content moderation with streaming and approval   |
+
+## When NOT to use glide-mq
+
+- **You need a log-based event streaming platform.** glide-mq is a job/task queue, not a partitioned event log. It does not provide Kafka-style topic partitions, consumer offset management, or event replay.
+- **You need browser support.** The Rust NAPI client requires a server-side runtime (Node.js 20+, Bun, or Deno with NAPI support).
+- **You need exactly-once semantics.** glide-mq provides at-least-once delivery. Duplicate processing is rare but possible - design processors to be idempotent.
+- **You need to run without Valkey or Redis.** Production use requires Valkey 7.0+ or Redis 7.0+. For dev/testing, `TestQueue`/`TestWorker` run fully in-memory.
 
 ## Documentation
 
-| Guide | Topics |
-|-------|--------|
-| [Usage](docs/USAGE.md) | Queue, Worker, Producer, batch, request-reply, graceful shutdown, cluster mode |
-| [Broadcast](docs/BROADCAST.md) | Pub/sub fan-out, BroadcastWorker, subject filtering |
-| [Step Jobs](docs/STEP_JOBS.md) | `moveToDelayed`, `moveToWaitingChildren`, multi-step processors |
-| [Advanced](docs/ADVANCED.md) | Schedulers, rate limiting, dedup, compression, retries, DLQ, custom IDs, LIFO, TTL, serializers |
-| [Workflows](docs/WORKFLOWS.md) | FlowProducer, DAG, `chain`, `group`, `chord`, dynamic children |
-| [Observability](docs/OBSERVABILITY.md) | OpenTelemetry, time-series metrics, job logs, dashboard |
-| [Serverless](docs/SERVERLESS.md) | Producer, ServerlessPool, Lambda and Edge deployment |
-| [Testing](docs/TESTING.md) | In-memory `TestQueue` and `TestWorker` -- no Valkey needed |
-| [Wire Protocol](docs/WIRE_PROTOCOL.md) | Cross-language FCALL specs, key layout, Python and Go examples |
-| [Architecture](docs/ARCHITECTURE.md) | Key design, Valkey functions, LIFO, Broadcast, DAG internals |
-| [Durability](docs/DURABILITY.md) | Persistence modes, crash windows, feature-specific durability |
-| [Migration](docs/MIGRATION.md) | Coming from BullMQ? API mapping and step-by-step guide |
-
-## Limitations
-
-- Requires a running Valkey 7.0+ or Redis 7.0+ instance. There is no embedded mode.
-- Node.js only. The Rust-native NAPI client (`@valkey/valkey-glide`) does not run in browsers or Deno.
-- At-least-once delivery semantics. Jobs may be processed more than once after crashes or stalled recovery.
-- Not a streaming platform. glide-mq is a job/task queue, not a replacement for Kafka or NATS JetStream.
-- Single dependency on `@glidemq/speedkey` (which wraps `@valkey/valkey-glide`). Native addon compilation is required on install.
+| Guide                                  | Topics                                                      |
+| -------------------------------------- | ----------------------------------------------------------- |
+| [Usage](docs/USAGE.md)                 | Queue, Worker, Producer, batch, request-reply, cluster mode |
+| [Workflows](docs/WORKFLOWS.md)         | FlowProducer, DAG, chain/group/chord, dynamic children      |
+| [Advanced](docs/ADVANCED.md)           | Schedulers, rate limiting, dedup, compression, retries, DLQ |
+| [Broadcast](docs/BROADCAST.md)         | Pub/sub fan-out, subject filtering                          |
+| [Observability](docs/OBSERVABILITY.md) | OpenTelemetry, metrics, job logs, dashboard                 |
+| [Serverless](docs/SERVERLESS.md)       | Producer, ServerlessPool, Lambda/Edge                       |
+| [Testing](docs/TESTING.md)             | In-memory TestQueue and TestWorker                          |
+| [Wire Protocol](docs/WIRE_PROTOCOL.md) | Cross-language FCALL specs, Python/Go examples              |
+| [Step Jobs](docs/STEP_JOBS.md)         | Step-job workflows with moveToDelayed                       |
+| [Durability](docs/DURABILITY.md)       | Durability guarantees, persistence, delivery semantics      |
+| [Architecture](docs/ARCHITECTURE.md)   | Internal architecture and design reference                  |
+| [Migration](docs/MIGRATION.md)         | Coming from BullMQ - API mapping guide                      |
 
 ## Ecosystem
 
-| Package | Description | Links |
-|---------|-------------|-------|
-| [glide-mq](https://github.com/avifenesh/glide-mq) | Core queue library | [npm](https://www.npmjs.com/package/glide-mq) |
-| [@glidemq/hono](https://github.com/avifenesh/glidemq-hono) | Hono middleware -- REST endpoints, SSE, serverless Producer | [npm](https://www.npmjs.com/package/@glidemq/hono) |
-| [@glidemq/fastify](https://github.com/avifenesh/glidemq-fastify) | Fastify plugin -- REST endpoints, SSE, serverless Producer | [npm](https://www.npmjs.com/package/@glidemq/fastify) |
-| [@glidemq/nestjs](https://github.com/avifenesh/glidemq-nestjs) | NestJS module -- decorators, DI, lifecycle management | [npm](https://www.npmjs.com/package/@glidemq/nestjs) |
-| [@glidemq/dashboard](https://github.com/avifenesh/glidemq-dashboard) | Web UI -- metrics charts, scheduler management, job mutations | [npm](https://www.npmjs.com/package/@glidemq/dashboard) |
-| [@glidemq/hapi](https://github.com/avifenesh/glidemq-hapi) | Hapi plugin -- REST endpoints, SSE, Joi validation | [npm](https://www.npmjs.com/package/@glidemq/hapi) |
-| [@glidemq/speedkey](https://github.com/avifenesh/speedkey) | Valkey GLIDE client with native NAPI bindings | [npm](https://www.npmjs.com/package/@glidemq/speedkey) |
-| [glidemq-examples](https://github.com/avifenesh/glidemq-examples) | 40+ runnable examples across frameworks and use cases | [GitHub](https://github.com/avifenesh/glidemq-examples) |
-| [glide-mq.dev](https://avifenesh.github.io/glide-mq.dev/) | Full documentation, guides, API reference | [Website](https://avifenesh.github.io/glide-mq.dev/) |
-
-> If glide-mq is useful to you, consider [starring the repo](https://github.com/avifenesh/glide-mq). It helps others find the project.
+| Package                                                              | Description                                   |
+| -------------------------------------------------------------------- | --------------------------------------------- |
+| [@glidemq/speedkey](https://github.com/avifenesh/speedkey)           | Valkey GLIDE client with native NAPI bindings |
+| [@glidemq/dashboard](https://github.com/avifenesh/glidemq-dashboard) | Web UI for metrics, schedulers, job mutations |
+| [@glidemq/hono](https://github.com/avifenesh/glidemq-hono)           | Hono middleware                               |
+| [@glidemq/fastify](https://github.com/avifenesh/glidemq-fastify)     | Fastify plugin                                |
+| [@glidemq/nestjs](https://github.com/avifenesh/glidemq-nestjs)       | NestJS module                                 |
+| [@glidemq/hapi](https://github.com/avifenesh/glidemq-hapi)           | Hapi plugin                                   |
+| [glide-mq.dev](https://avifenesh.github.io/glide-mq.dev/)            | Full documentation site                       |
 
 ## Contributing
 
-Bug reports, feature requests, and pull requests are welcome. See [CHANGELOG.md](CHANGELOG.md) for release history.
+Bug reports, feature requests, and pull requests are welcome.
 
 - [Open an issue](https://github.com/avifenesh/glide-mq/issues)
 - [Discussions](https://github.com/avifenesh/glide-mq/discussions)
+- [Changelog](CHANGELOG.md)
 
 ## License
 

package/dist/base-worker.d.ts

@@ -1,10 +1,10 @@
 import { EventEmitter } from 'events';
-import type { WorkerOptions, Processor, BatchProcessor, Client, Serializer } from './types';
+import type { WorkerOptions, Processor, BatchProcessor, Client, Serializer, SignalEntry } from './types';
 import { Job } from './job';
 import { buildKeys } from './utils';
 import type { QueueKeys } from './functions/index';
 import { Scheduler } from './scheduler';
-export type WorkerEvent = 'completed' | 'failed' | 'error' | 'stalled' | 'closing' | 'closed' | 'active' | 'drained';
+export type WorkerEvent = 'completed' | 'failed' | 'error' | 'stalled' | 'closing' | 'closed' | 'active' | 'drained' | 'budget-exceeded';
 /**
  * Configuration that differs between Worker and BroadcastWorker.
  * Passed from the subclass constructor to BaseWorker.
@@ -59,9 +59,12 @@ export declare abstract class BaseWorker<D = any, R = any> extends EventEmitter
     protected globalRateLimitEnabled: boolean;
     protected cachedRateLimitMax: number;
     protected cachedRateLimitDuration: number;
+    protected tpmLocalCounter: number;
+    protected tpmWindowStart: number;
     protected sandboxClose?: (force?: boolean) => Promise<void>;
     protected workerHeartbeatTimer: ReturnType<typeof setInterval> | null;
     protected pollLoopPromise: Promise<void> | null;
+    protected suspendContinuations: Map<string, (signals: SignalEntry[]) => Promise<any>>;
     protected readonly startedAt: number;
     protected readonly hostname: string;
     protected serializer: Serializer;
@@ -217,7 +220,7 @@ export declare abstract class BaseWorker<D = any, R = any> extends EventEmitter
      * Returns true if the job was found and aborted, false if not currently active.
      */
     abortJob(jobId: string): boolean;
-    protected startHeartbeat(jobId: string): void;
+    protected startHeartbeat(jobId: string, jobLockDuration?: number): void;
     protected stopHeartbeat(jobId: string): void;
     protected moveToDLQ(job: Job<D, R>, error: Error): Promise<void>;
     /**
@@ -225,8 +228,23 @@ export declare abstract class BaseWorker<D = any, R = any> extends EventEmitter
      * Also respects any manual rate limit set via rateLimit(ms).
      */
     protected waitForRateLimit(): Promise<void>;
+    /**
+     * Check the TPM (token-per-minute) rate limit and wait if either the local or
+     * per-queue counter exceeds the configured maxTokens for the current window.
+     */
+    protected waitForTokenLimit(): Promise<void>;
+    /**
+     * Increment the TPM counter after a job completes (or reports tokens).
+     * Called from the completion path when tokenLimiter is configured.
+     */
+    protected incrementTpmCounter(tokens: number): Promise<void>;
     /** Refresh cached meta flags from Valkey. Called on init and each scheduler tick. */
     private refreshMetaFlags;
+    /**
+     * Read the onExceeded policy from a budget hash.
+     * Returns 'fail' (default) or 'pause'.
+     */
+    private getBudgetOnExceeded;
     /**
      * Register this worker in Valkey with a TTL-based heartbeat key.
      * The key expires after stalledInterval ms; a periodic timer refreshes it at half that interval.

package/dist/base-worker.d.ts.map

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