@vibesdotdev/integrations-redis 0.0.0-stage → 1.0.0-rc.1

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @vibesdotdev/integrations-redis — the Redis connection registry and
+ * instrumented client (moved from `@vibesdotdev/logging/observability/redis`)
+ * and the Workers scheduler lock (moved from `@vibesdotdev/workers`), RC09.
+ */
+export { RedisConnectionManager, redisManagerFor, getRedisConnection, disposeRedisConnections, setupRedisShutdownHandlers, REDIS_URL, redisPurposeUrlKey, resolveRedisUrl } from "./manager.js";
+export { RedisConnectionPurpose, RedisConnections, redisConnectionsFor, getCacheConnection, getSessionsConnection, getWorkersConnection, getPubSubConnection, getGPUQueueConnection, getModelRegistryConnection } from "./connections.js";
+export { instrumentRedisClient } from "./instrumented.js";
+export { RedisSchedulerLock } from "./scheduler-lock.js";
+export { RedisSettingsSchema, REDIS_SETTINGS_MANIFEST_ID, redisSettingsManifest, redisSettingsDescriptor } from "./config.js";
+export { redisPlugin } from "./redis.plugin.js";
+export { RedisClient } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,SAAS,EACT,kBAAkB,EAClB,eAAe,EAEf,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAE1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAA2B,MAAM,qBAAqB,CAAC;AAClF,OAAO,EACN,mBAAmB,EACnB,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EAEvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/instrumented.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Instrument the vendor dispatch boundary. Command overloads, callbacks and
+ * synchronous multi/pipeline builders remain implemented by ioredis itself.
+ */
+import type { Redis } from 'ioredis';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+export declare function instrumentRedisClient(client: Redis, _runtime?: RuntimeRef): Redis;
+//# sourceMappingURL=instrumented.d.ts.map

package/dist/instrumented.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumented.d.ts","sourceRoot":"","sources":["../src/instrumented.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGhF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,KAAK,CAoCjF"}

package/dist/instrumented.js

@@ -0,0 +1,41 @@
+import { valueFreeFailure, settle } from '@vibesdotdev/kernel';
+import { SpanKind, SpanStatusCode, trace } from '@opentelemetry/api';
+export function instrumentRedisClient(client, _runtime) {
+    return new Proxy(client, {
+        get(target, prop) {
+            if (prop === 'sendCommand') {
+                return (...args) => {
+                    const [command] = args;
+                    return trace.getTracer('redis').startActiveSpan('redis.command', {
+                        kind: SpanKind.CLIENT,
+                        attributes: { 'db.system': 'redis', component: 'ioredis' }
+                    }, (span) => {
+                        try {
+                            const result = target.sendCommand(...args);
+                            void settle(() => command.promise).then((outcome) => {
+                                if (outcome.ok) {
+                                    span.setStatus({ code: SpanStatusCode.OK });
+                                }
+                                else {
+                                    span.recordException(new Error('Redis command failed', { cause: valueFreeFailure(outcome.cause) }));
+                                    span.setStatus({ code: SpanStatusCode.ERROR, message: 'Redis command failed' });
+                                }
+                                span.end();
+                            });
+                            return result;
+                        }
+                        catch (error) {
+                            span.setStatus({ code: SpanStatusCode.ERROR, message: 'Redis command failed' });
+                            span.end();
+                            throw error;
+                        }
+                    });
+                };
+            }
+            // SAFETY: Proxy property reads must preserve all vendor properties,
+            // including symbols. The key assertion changes no value or call contract.
+            return target[prop];
+        }
+    });
+}
+//# sourceMappingURL=instrumented.js.map

package/dist/instrumented.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumented.js","sourceRoot":"","sources":["../src/instrumented.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAmB,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAErE,MAAM,UAAU,qBAAqB,CAAC,MAAa,EAAE,QAAqB;IACzE,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE;QACxB,GAAG,CAAC,MAAM,EAAE,IAAI;YACf,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;gBAC5B,OAAO,CAAC,GAAG,IAAsC,EAAE,EAAE;oBACpD,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;oBACvB,OAAO,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,eAAe,EAAE;wBAChE,IAAI,EAAE,QAAQ,CAAC,MAAM;wBACrB,UAAU,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE;qBAC1D,EAAE,CAAC,IAAI,EAAE,EAAE;wBACX,IAAI,CAAC;4BACJ,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;4BAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;gCACnD,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;oCAChB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;gCAC7C,CAAC;qCAAM,CAAC;oCACP,IAAI,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;oCACpG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC;gCACjF,CAAC;gCACD,IAAI,CAAC,GAAG,EAAE,CAAC;4BACZ,CAAC,CAAC,CAAC;4BACH,OAAO,MAAM,CAAC;wBACf,CAAC;wBAAC,OAAO,KAAK,EAAE,CAAC;4BAChB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC;4BAChF,IAAI,CAAC,GAAG,EAAE,CAAC;4BACX,MAAM,KAAK,CAAC;wBACb,CAAC;oBACF,CAAC,CAAC,CAAC;gBACJ,CAAC,CAAC;YACH,CAAC;YAED,oEAAoE;YACpE,0EAA0E;YAC1E,OAAO,MAAM,CAAC,IAAmB,CAAC,CAAC;QACpC,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/manager.d.ts

@@ -0,0 +1,79 @@
+import type IORedis from 'ioredis';
+import type { RedisOptions } from 'ioredis';
+import { type RuntimeLifecycle, type RuntimeRef } from '@vibesdotdev/kernel';
+import type { RedisClient } from './client.ts';
+export declare function isDeclaredBuildHost(runtime: Pick<RuntimeRef, 'scope'>): boolean;
+/** The base Redis URL credential; a purpose may set its own `REDIS_<PURPOSE>_URL`. */
+export declare const REDIS_URL = "REDIS_URL";
+/** The credential key naming `purpose`'s own Redis URL (`REDIS_CACHE_URL`, …). */
+export declare function redisPurposeUrlKey(purpose: string): string;
+/**
+ * The Redis URL on `runtime`: `purpose`'s own credential when given and set,
+ * else the base `REDIS_URL` credential (the declared chain). A Redis URL
+ * carries its password, so both are credentials, never environment reads. No
+ * URL at all is `UNAVAILABLE redis-url-not-set`, never a guessed localhost.
+ */
+export declare function resolveRedisUrl(runtime: Pick<RuntimeRef, 'resolveCredential'>, purpose?: string): Promise<string>;
+/**
+ * Centralized Redis connection manager for proper cleanup
+ */
+export declare class RedisConnectionManager {
+    private connections;
+    private closeAllPromise;
+    private runtime?;
+    private readonly createClient;
+    constructor(runtimeOrCreateClient?: RuntimeRef | ((url: string, options: RedisOptions) => IORedis), createClient?: (url: string, options: RedisOptions) => IORedis);
+    createBuildClient(): IORedis;
+    private log;
+    private logDebug;
+    private logInfo;
+    private logWarn;
+    /**
+     * Create a new Redis connection with cleanup tracking. The caller supplies
+     * the URL (a resolved credential: `resolveRedisUrl`) and the runtime whose
+     * declared scope decides whether this is a build host.
+     */
+    createConnection(runtime: RuntimeRef, url: string, options?: RedisOptions): IORedis;
+    /**
+     * Gracefully close all tracked connections
+     */
+    closeAllConnections(): Promise<void>;
+    /**
+     * Get count of active connections
+     */
+    getConnectionCount(): number;
+    /**
+     * Wait for a connection's own `ready` event, bounded by the caller's
+     * runtime lifecycle (RC07): the wait rejects `TIMEOUT wait-timeout` at the
+     * deadline, `CANCELLED wait-aborted` when the runtime is disposed, or with
+     * the connection's `error`.
+     */
+    waitForConnection(redis: IORedis, lifecycle: Pick<RuntimeLifecycle, 'wait'>, timeoutMs?: number): Promise<void>;
+    /**
+     * Check if a connection is healthy
+     */
+    isConnectionHealthy(redis: IORedis): boolean;
+    /**
+     * Force disconnect all connections (emergency cleanup)
+     */
+    forceDisconnectAll(): void;
+    private removeConnection;
+}
+/** What identifies the runtime that owns a set of Redis connections. */
+export type RedisOwnerRuntime = RuntimeRef;
+export declare function redisClientFor(runtime: RedisOwnerRuntime): RedisClient;
+export declare function redisManagerFor(runtime: RedisOwnerRuntime): RedisConnectionManager;
+export declare function disposeRedisConnections(runtime: RedisOwnerRuntime): Promise<void>;
+/**
+ * @deprecated Process-global shutdown handlers were removed from this reusable
+ * package. Compose `redisPlugin`: the runtime's disposal closes that
+ * runtime's connections (`disposeRedisConnections(runtime)`).
+ */
+export declare function setupRedisShutdownHandlers(): never;
+/**
+ * A Redis connection on `runtime`, tracked by the manager `runtime` owns: the URL is the
+ * `REDIS_URL` credential and the retry and ready-check settings are the
+ * `integrations.redis` manifest; `options` wins per field.
+ */
+export declare function getRedisConnection(runtime: RuntimeRef, options?: RedisOptions): Promise<IORedis>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAwD,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAInI,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,OAAO,CAE/E;AAaD,sFAAsF;AACtF,eAAO,MAAM,SAAS,cAAc,CAAC;AAErC,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACpC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,EAC9C,OAAO,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAajB;AAED;;GAEG;AACH,qBAAa,sBAAsB;IAClC,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,OAAO,CAAC,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkD;gBAG9E,qBAAqB,CAAC,EACnB,UAAU,GACV,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,EACpD,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO;IAU/D,iBAAiB,IAAI,OAAO;IAyB5B,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,QAAQ;IAGhB,OAAO,CAAC,OAAO;IAGf,OAAO,CAAC,OAAO;IAIf;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO;IA4DnF;;OAEG;IACH,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgDpC;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAM5B;;;;;OAKG;IACH,iBAAiB,CAChB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,EACzC,SAAS,SAAmD,GAC1D,OAAO,CAAC,IAAI,CAAC;IA+BhB;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAI5C;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAkB1B,OAAO,CAAC,gBAAgB;CAIxB;AAED,wEAAwE;AACxE,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE3C,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,WAAW,CAItE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,sBAAsB,CAElF;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,KAAK,CAIlD;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAStG"}

package/dist/manager.js

@@ -0,0 +1,321 @@
+import { CapabilityError, valueFreeFailure, settle, settleNow } from '@vibesdotdev/kernel';
+import { getLogger } from '@vibesdotdev/logging';
+import { getVibesClient, tryGetVibesClient } from '@vibesdotdev/kernel/client';
+import { RedisSettingsSchema, redisSettingsManifest } from "./config.js";
+import { RedisCredentialSchema } from "./schemas/connection.js";
+export function isDeclaredBuildHost(runtime) {
+    return runtime.scope.lifecycle === 'finite' && runtime.scope.qualifiers.building === true;
+}
+async function resolveOptionalSecret(runtime, key) {
+    const result = await runtime.resolveCredential({ source: 'secret', key });
+    if (result.ok) {
+        const parsed = RedisCredentialSchema.safeParse(result.value);
+        if (parsed.success)
+            return parsed.data;
+        throw new CapabilityError('Invalid Redis credential', 'INVALID_INPUT', { reason: 'redis-credential-invalid' });
+    }
+    if (result.error.code === 'NOT_FOUND' && result.error.reason === 'credential-not-set')
+        return null;
+    throw result.error;
+}
+/** The base Redis URL credential; a purpose may set its own `REDIS_<PURPOSE>_URL`. */
+export const REDIS_URL = 'REDIS_URL';
+/** The credential key naming `purpose`'s own Redis URL (`REDIS_CACHE_URL`, …). */
+export function redisPurposeUrlKey(purpose) {
+    return `REDIS_${purpose.toUpperCase()}_URL`;
+}
+/**
+ * The Redis URL on `runtime`: `purpose`'s own credential when given and set,
+ * else the base `REDIS_URL` credential (the declared chain). A Redis URL
+ * carries its password, so both are credentials, never environment reads. No
+ * URL at all is `UNAVAILABLE redis-url-not-set`, never a guessed localhost.
+ */
+export async function resolveRedisUrl(runtime, purpose) {
+    if (purpose) {
+        const own = await resolveOptionalSecret(runtime, redisPurposeUrlKey(purpose));
+        if (own)
+            return own;
+    }
+    const base = await resolveOptionalSecret(runtime, REDIS_URL);
+    if (base)
+        return base;
+    const keys = purpose ? `${redisPurposeUrlKey(purpose)} or ${REDIS_URL}` : REDIS_URL;
+    throw new CapabilityError(`No Redis URL is set${purpose ? ` for '${purpose}'` : ''}: set the ${keys} secret.`, 'UNAVAILABLE', {
+        reason: 'redis-url-not-set',
+        retryable: false,
+        details: { purpose: purpose ?? null }
+    });
+}
+/**
+ * Centralized Redis connection manager for proper cleanup
+ */
+export class RedisConnectionManager {
+    connections = [];
+    closeAllPromise = null;
+    runtime;
+    createClient;
+    constructor(runtimeOrCreateClient, createClient) {
+        if (runtimeOrCreateClient instanceof Function) {
+            this.createClient = runtimeOrCreateClient;
+        }
+        else {
+            this.runtime = runtimeOrCreateClient;
+            this.createClient = createClient ?? (() => { throw new CapabilityError('Compose the Redis Node plugin to connect', 'UNAVAILABLE', { reason: 'redis-provider-unavailable' }); });
+        }
+    }
+    createBuildClient() {
+        // The host factory creates a lazy client; no socket is opened.
+        const client = this.createClient('', { lazyConnect: true });
+        const transaction = new Proxy(client, {
+            get(_target, prop) {
+                if (prop === 'then')
+                    return undefined;
+                if (prop === 'exec')
+                    return () => Promise.resolve([]);
+                return () => transaction;
+            }
+        });
+        const builder = new Proxy(client, {
+            get(target, prop) {
+                if (prop === 'then')
+                    return undefined;
+                if (prop === 'multi' || prop === 'pipeline')
+                    return () => transaction;
+                if (prop === 'exec')
+                    return () => Promise.resolve([]);
+                if (prop === 'status')
+                    return 'end';
+                // SAFETY: Proxy keys address the vendor target; unknown keys preserve undefined.
+                if (target[prop] instanceof Function)
+                    return () => Promise.resolve();
+                // SAFETY: Preserve the vendor's property values for arbitrary proxy keys.
+                return target[prop];
+            }
+        });
+        return builder;
+    }
+    log(level, message, meta, activeRuntime) {
+        const targetRuntime = activeRuntime ?? this.runtime;
+        if (targetRuntime && !targetRuntime.lifecycle.signal.aborted)
+            getLogger('redis', targetRuntime)[level](message, meta);
+    }
+    logDebug(message, meta, runtime) {
+        this.log('debug', message, meta, runtime);
+    }
+    logInfo(message, meta, runtime) {
+        this.log('info', message, meta, runtime);
+    }
+    logWarn(message, meta, runtime) {
+        this.log('warn', message, meta, runtime);
+    }
+    /**
+     * Create a new Redis connection with cleanup tracking. The caller supplies
+     * the URL (a resolved credential: `resolveRedisUrl`) and the runtime whose
+     * declared scope decides whether this is a build host.
+     */
+    createConnection(runtime, url, options) {
+        if (!this.runtime) {
+            this.runtime = runtime;
+        }
+        // A declared finite build (prerender) gets a client that does nothing.
+        if (isDeclaredBuildHost(runtime)) {
+            return this.createBuildClient();
+        }
+        if (this.closeAllPromise) {
+            throw new Error('Cannot create a Redis connection while disposal is in progress');
+        }
+        const defaults = RedisSettingsSchema.parse({});
+        const redis = this.createClient(url, {
+            // Defaults; `getRedisConnection` passes the declared `redis` settings.
+            maxRetriesPerRequest: defaults.maxRetriesPerRequest,
+            enableReadyCheck: defaults.enableReadyCheck,
+            retryStrategy: (times) => {
+                const delay = Math.min(times * 50, 2000);
+                this.logDebug(`Redis reconnecting (attempt ${times})...`, undefined, runtime);
+                return delay;
+            },
+            reconnectOnError: (err) => {
+                // Reconnect and resend command on READONLY (failover scenario)
+                if (err.message.includes('READONLY')) {
+                    return 2; // reconnect and resend the failed command
+                }
+                // Reconnect on NOAUTH - happens when port-forward drops/reconnects
+                // Return 2 to reconnect and resend the command
+                if (err.message.includes('NOAUTH')) {
+                    return 2;
+                }
+                return false;
+            },
+            // Override with provided options (e.g., maxRetriesPerRequest: null for BullMQ)
+            ...options
+        });
+        // Track connection for cleanup
+        this.connections.push(redis);
+        // Set up comprehensive error handling
+        redis.on('error', (error) => {
+            settleNow(() => runtime.diagnostics.error('Redis connection error', { scope: 'redis', plugin: 'redis', error: valueFreeFailure(error) }));
+        });
+        redis.on('reconnecting', (delay) => {
+            this.logDebug(`Redis reconnecting in ${delay}ms...`, undefined, runtime);
+        });
+        redis.on('connect', () => {
+            // Silent connection established
+        });
+        redis.on('ready', () => {
+            // Silent connection ready
+        });
+        return redis;
+    }
+    /**
+     * Gracefully close all tracked connections
+     */
+    closeAllConnections() {
+        if (this.closeAllPromise)
+            return this.closeAllPromise;
+        const activeConnections = [...this.connections];
+        if (activeConnections.length === 0)
+            return Promise.resolve();
+        this.logInfo(`Closing ${activeConnections.length} Redis connections...`);
+        const closeOperation = (async () => {
+            const results = await Promise.allSettled(activeConnections.map(async (redis, index) => {
+                if (redis.status === 'end') {
+                    this.removeConnection(redis);
+                    return;
+                }
+                const quit = await settle(() => redis.quit());
+                if (quit.ok) {
+                    this.removeConnection(redis);
+                    return;
+                }
+                const disconnect = settleNow(() => redis.disconnect());
+                if (disconnect.ok)
+                    this.removeConnection(redis);
+                const failures = [new Error('Redis quit failed', { cause: valueFreeFailure(quit.cause) })];
+                if (!disconnect.ok) {
+                    failures.push(new Error('Redis disconnect failed', { cause: valueFreeFailure(disconnect.cause) }));
+                }
+                throw new AggregateError(failures, `Redis connection ${index + 1} cleanup failed`);
+            }));
+            const failures = results.flatMap((result) => result.status === 'rejected' ? [result.reason] : []);
+            if (failures.length > 0) {
+                throw new AggregateError(failures, `Redis disposal failed for ${failures.length} connection${failures.length === 1 ? '' : 's'}`);
+            }
+            this.logInfo('All Redis connections closed');
+        })();
+        this.closeAllPromise = closeOperation.finally(() => {
+            this.closeAllPromise = null;
+        });
+        return this.closeAllPromise;
+    }
+    /**
+     * Get count of active connections
+     */
+    getConnectionCount() {
+        return this.connections.filter((redis) => redis.status === 'ready' || redis.status === 'connecting').length;
+    }
+    /**
+     * Wait for a connection's own `ready` event, bounded by the caller's
+     * runtime lifecycle (RC07): the wait rejects `TIMEOUT wait-timeout` at the
+     * deadline, `CANCELLED wait-aborted` when the runtime is disposed, or with
+     * the connection's `error`.
+     */
+    waitForConnection(redis, lifecycle, timeoutMs = RedisSettingsSchema.parse({}).readinessTimeoutMs) {
+        if (redis.status === 'ready')
+            return Promise.resolve();
+        return lifecycle.wait((signal) => new Promise((resolve, reject) => {
+            if (signal.aborted) {
+                reject(signal.reason);
+                return;
+            }
+            const onReady = () => {
+                cleanup();
+                resolve();
+            };
+            const onError = (error) => {
+                cleanup();
+                reject(new CapabilityError('Redis connection failed', 'UNAVAILABLE', { reason: 'redis-connection-failed', cause: valueFreeFailure(error) }));
+            };
+            const onAbort = () => {
+                cleanup();
+                reject(signal.reason);
+            };
+            const cleanup = () => {
+                redis.off('ready', onReady);
+                redis.off('error', onError);
+                signal.removeEventListener('abort', onAbort);
+            };
+            redis.once('ready', onReady);
+            redis.once('error', onError);
+            signal.addEventListener('abort', onAbort, { once: true });
+        }), { timeoutMs, reason: 'redis-connection-ready' });
+    }
+    /**
+     * Check if a connection is healthy
+     */
+    isConnectionHealthy(redis) {
+        return redis.status === 'ready';
+    }
+    /**
+     * Force disconnect all connections (emergency cleanup)
+     */
+    forceDisconnectAll() {
+        this.logWarn('Force disconnecting all Redis connections');
+        const failures = [];
+        for (const [index, redis] of [...this.connections].entries()) {
+            const disconnected = settleNow(() => redis.disconnect());
+            if (disconnected.ok) {
+                this.removeConnection(redis);
+            }
+            else {
+                failures.push(new Error(`Failed to force-disconnect Redis connection ${index + 1}`, {
+                    cause: valueFreeFailure(disconnected.cause)
+                }));
+            }
+        }
+        if (failures.length > 0) {
+            throw new AggregateError(failures, 'One or more Redis connections could not be disconnected');
+        }
+    }
+    removeConnection(redis) {
+        const index = this.connections.indexOf(redis);
+        if (index >= 0)
+            this.connections.splice(index, 1);
+    }
+}
+export function redisClientFor(runtime) {
+    const client = tryGetVibesClient('redis', runtime);
+    if (!client)
+        throw new CapabilityError('Activate the Redis plugin before synchronous access', 'UNAVAILABLE', { reason: 'redis-client-unavailable' });
+    return client;
+}
+export function redisManagerFor(runtime) {
+    return redisClientFor(runtime).manager;
+}
+export async function disposeRedisConnections(runtime) {
+    await redisClientFor(runtime).dispose();
+}
+/**
+ * @deprecated Process-global shutdown handlers were removed from this reusable
+ * package. Compose `redisPlugin`: the runtime's disposal closes that
+ * runtime's connections (`disposeRedisConnections(runtime)`).
+ */
+export function setupRedisShutdownHandlers() {
+    throw new Error('setupRedisShutdownHandlers() no longer installs process handlers; register disposeRedisConnections() with the executable host lifecycle');
+}
+/**
+ * A Redis connection on `runtime`, tracked by the manager `runtime` owns: the URL is the
+ * `REDIS_URL` credential and the retry and ready-check settings are the
+ * `integrations.redis` manifest; `options` wins per field.
+ */
+export async function getRedisConnection(runtime, options) {
+    if (isDeclaredBuildHost(runtime))
+        return redisManagerFor(runtime).createBuildClient();
+    const url = await resolveRedisUrl(runtime);
+    const settings = await (await getVibesClient('config', runtime)).read(redisSettingsManifest);
+    return redisManagerFor(runtime).createConnection(runtime, url, {
+        maxRetriesPerRequest: settings.maxRetriesPerRequest,
+        enableReadyCheck: settings.enableReadyCheck,
+        ...options
+    });
+}
+//# sourceMappingURL=manager.js.map

package/dist/manager.js.map

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

package/dist/redis.consumer.plugin.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Integrations Redis plugin
+ *
+ * Declares the `integrations.redis` settings manifest, contributes the Redis
+ * and ioredis OpenTelemetry instrumentations to logging's instrumentation
+ * port, and registers the runtime-owned Node Redis semantic client.
+ */
+export declare const redisNodePlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default redisNodePlugin;
+//# sourceMappingURL=redis.consumer.plugin.d.ts.map

package/dist/redis.consumer.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.consumer.plugin.d.ts","sourceRoot":"","sources":["../src/redis.consumer.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,eAAO,MAAM,eAAe,6CAoB1B,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/dist/redis.consumer.plugin.js

@@ -0,0 +1,30 @@
+/**
+ * Integrations Redis plugin
+ *
+ * Declares the `integrations.redis` settings manifest, contributes the Redis
+ * and ioredis OpenTelemetry instrumentations to logging's instrumentation
+ * port, and registers the runtime-owned Node Redis semantic client.
+ */
+import { getVibesClient } from '@vibesdotdev/kernel/client';
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel/factory';
+import redisSettingsDescriptor from "./config.js";
+import { IOREDIS_TELEMETRY_INSTRUMENTATION_ID, REDIS_TELEMETRY_INSTRUMENTATION_ID, ioredisTelemetryInstrumentationDescriptor, redisTelemetryInstrumentationDescriptor } from "./telemetry.js";
+export const redisNodePlugin = createRuntimePlugin({
+    id: 'integrations-redis-consumer',
+    name: 'Integrations Redis',
+    description: 'Redis connection registry, instrumented client and the Workers scheduler lock.',
+    descriptors: [
+        redisSettingsDescriptor,
+        { kind: 'runtime/client', id: 'redis' },
+        ioredisTelemetryInstrumentationDescriptor,
+        redisTelemetryInstrumentationDescriptor
+    ],
+    loaders: [
+        loader('redis', { kind: 'runtime/client' }, () => import("./client.node.js")),
+        loader(IOREDIS_TELEMETRY_INSTRUMENTATION_ID, { kind: 'observability/telemetry-instrumentation' }, () => import("./telemetry-ioredis.impl.js")),
+        loader(REDIS_TELEMETRY_INSTRUMENTATION_ID, { kind: 'observability/telemetry-instrumentation' }, () => import("./telemetry-redis.impl.js"))
+    ],
+    onActivate: async (runtime) => { await getVibesClient('redis', runtime); }
+});
+export default redisNodePlugin;
+//# sourceMappingURL=redis.consumer.plugin.js.map

package/dist/redis.consumer.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.consumer.plugin.js","sourceRoot":"","sources":["../src/redis.consumer.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,uBAAuB,MAAM,aAAa,CAAC;AAClD,OAAO,EACN,oCAAoC,EACpC,kCAAkC,EAClC,yCAAyC,EACzC,uCAAuC,EACvC,MAAM,gBAAgB,CAAC;AAExB,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;IAClD,EAAE,EAAE,6BAA6B;IACjC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,gFAAgF;IAC7F,WAAW,EAAE;QACZ,uBAAuB;QACvB,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,OAAO,EAAE;QACvC,yCAAyC;QACzC,uCAAuC;KACvC;IACD,OAAO,EAAE;QACT,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC5E,MAAM,CAAC,oCAAoC,EAAE,EAAE,IAAI,EAAE,yCAAyC,EAAE,EAAE,GAAG,EAAE,CACtG,MAAM,CAAC,6BAA6B,CAAC,CACrC;QACD,MAAM,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,yCAAyC,EAAE,EAAE,GAAG,EAAE,CACpG,MAAM,CAAC,2BAA2B,CAAC,CACnC;KACD;IACD,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1E,CAAC,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/dist/redis.plugin.d.ts

@@ -0,0 +1,3 @@
+export declare const redisPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default redisPlugin;
+//# sourceMappingURL=redis.plugin.d.ts.map

package/dist/redis.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.plugin.d.ts","sourceRoot":"","sources":["../src/redis.plugin.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,6CAMtB,CAAC;AACH,eAAe,WAAW,CAAC"}

package/dist/redis.plugin.js

@@ -0,0 +1,12 @@
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel/factory';
+import { getVibesClient } from '@vibesdotdev/kernel/client';
+import redisSettingsDescriptor from "./config.js";
+export const redisPlugin = createRuntimePlugin({
+    id: 'integrations-redis',
+    name: 'Redis contract',
+    descriptors: [redisSettingsDescriptor, { kind: 'runtime/client', id: 'redis' }],
+    loaders: [loader('redis', { kind: 'runtime/client' }, () => import("./client.js").then(m => ({ impl: m.RedisClient })))],
+    onActivate: async (runtime) => { await getVibesClient('redis', runtime); }
+});
+export default redisPlugin;
+//# sourceMappingURL=redis.plugin.js.map

package/dist/redis.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.plugin.js","sourceRoot":"","sources":["../src/redis.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,uBAAuB,MAAM,aAAa,CAAC;AAElD,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAAC;IAC9C,EAAE,EAAE,oBAAoB;IACxB,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;IAC/E,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IACxH,UAAU,EAAE,KAAK,EAAC,OAAO,EAAC,EAAE,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACxE,CAAC,CAAC;AACH,eAAe,WAAW,CAAC"}

package/dist/scheduler-lock.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Redis implementation of the Workers scheduler lock port
+ * (`SchedulerLock` from `@vibesdotdev/workers/scheduler/lock`), moved from
+ * `@vibesdotdev/workers/scheduler/lock` (RC09).
+ *
+ * `SET key token NX PX ttl` to acquire; a token-checked Lua `DEL` to release.
+ * Not a distributed redlock: good for single-runner maintenance tasks. A
+ * release whose store call fails rejects with that failure (it is not read as
+ * "someone else holds it").
+ */
+import type { SchedulerLock } from '@vibesdotdev/workers/scheduler/lock';
+import { type SchedulerLockStore } from './schemas/lock.ts';
+export type { SchedulerLockStore } from './schemas/lock.ts';
+export declare class RedisSchedulerLock implements SchedulerLock {
+    private readonly redis;
+    constructor(redis: SchedulerLockStore);
+    acquire(key: string, ttlMs: number): Promise<string | null>;
+    release(key: string, token: string): Promise<boolean>;
+}
+//# sourceMappingURL=scheduler-lock.d.ts.map

package/dist/scheduler-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler-lock.d.ts","sourceRoot":"","sources":["../src/scheduler-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EAAkD,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5G,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAQ5D,qBAAa,kBAAmB,YAAW,aAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,kBAAkB;IAEhD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAO3D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAK3D"}