@hazeljs/agent 1.0.0 → 1.0.2

package/IMPLEMENTATION_SUMMARY.md

@@ -315,36 +315,36 @@ const result = await runtime.execute('chat-agent', message, {
 
 **Benefits**: Memory, tools, state, observability, resumable
 
-## 🚀 Production Considerations
+## Production Considerations (v1.0.1+)
 
-### Current Implementation
+### Shipped persistence
 
-- In-memory state (Map-based)
-- Single process
-- No distributed coordination
+- **State**: `AgentStateManager`, `RedisStateManager`, `DatabaseStateManager`
+- **Approvals**: `InMemoryApprovalStore`, `RedisApprovalStore`
+- **Module bootstrap**: `AgentModule.forRootAsync({ redis: { url } })`
 
-### Production Recommendations
+### Further recommendations
 
-1. **State Persistence**: Replace Map with Redis/Database
-2. **Distributed Approvals**: Use message queue
-3. **Execution Queue**: Use job queue for long-running agents
-4. **Event Bus**: Replace in-memory emitter with distributed bus
+1. **Execution queue**: Job queue for long-running agents (future `@hazeljs/flow`)
+2. **Event bus**: Distributed event bus for cross-service observability
+3. **Observability**: `observabilityProvider` for OTel spans
 
-### Scaling Example
+### Scaling example
 
 ```typescript
-class RedisStateManager extends AgentStateManager {
-  async getContext(executionId: string) {
-    return redis.get(`agent:context:${executionId}`);
-  }
-}
+import { AgentModule } from '@hazeljs/agent';
+import { createClient } from 'redis';
 
-const runtime = new AgentRuntime({
-  stateManager: new RedisStateManager(),
+const redis = createClient({ url: process.env.REDIS_URL });
+await redis.connect();
+
+await AgentModule.forRootAsync({
+  redis: { client: redis },
+  useRedisApprovals: true,
 });
 ```
 
-## 📚 Documentation
+## Documentation
 
 - **README.md** - User-facing documentation with examples
 - **ARCHITECTURE.md** - Technical architecture deep-dive

package/PERSISTENCE.md

@@ -26,6 +26,55 @@ The `@hazeljs/agent` package supports multiple persistence backends for agent ex
 - **Pros**: Durable, queryable, full audit trail
 - **Cons**: Slower than Redis, requires database setup
 
+## Environment-driven setup (v1.0+)
+
+Use `createStateManagerFromEnv()` or `AgentModule.forRootAsync()` to pick Redis automatically from `REDIS_URL`:
+
+```typescript
+import { AgentModule } from '@hazeljs/agent';
+
+// Async bootstrap (connects Redis from REDIS_URL)
+await AgentModule.forRootAsync({
+  stateBackend: process.env.AGENT_STATE_BACKEND as 'memory' | 'redis' | 'database',
+  redis: { url: process.env.REDIS_URL },
+});
+
+// Or sync when you already have a connected client
+AgentModule.forRoot({
+  redis: { client: redisClient },
+  useRedisApprovals: true,
+});
+```
+
+Environment variables:
+
+| Variable              | Values                        | Default                                       |
+| --------------------- | ----------------------------- | --------------------------------------------- |
+| `AGENT_STATE_BACKEND` | `memory`, `redis`, `database` | `memory` (or `redis` when `REDIS_URL` is set) |
+| `REDIS_URL`           | Redis connection URL          | —                                             |
+
+Factory helpers:
+
+```typescript
+import { createStateManager, createStateManagerFromEnv } from '@hazeljs/agent';
+
+const syncManager = createStateManager({ backend: 'redis', redisClient });
+const asyncManager = await createStateManagerFromEnv({ redisUrl: process.env.REDIS_URL });
+```
+
+### Durable tool approvals (1.0.1+)
+
+Redis-backed approvals for multi-instance human-in-the-loop:
+
+```typescript
+await AgentModule.forRootAsync({
+  redis: { url: process.env.REDIS_URL },
+  useRedisApprovals: true,
+});
+```
+
+Pass `redis.client` to `forRoot()` when you already have a connected client. Exports: `IApprovalStore`, `InMemoryApprovalStore`, `RedisApprovalStore`, `createApprovalStore`.
+
 ## Usage
 
 ### In-Memory (Default)

package/PRODUCTION_READINESS.md

@@ -43,7 +43,7 @@ This document tracks the production readiness improvements made to `@hazeljs/age
 
 ### 4. Rate Limiting
 
-**Implementation**: `src/utils/rate-limiter.ts`
+**Implementation**: `src/utils/rate-limiter.ts` (adapter over `@hazeljs/resilience` `TokenBucketLimiter`)
 
 - Token bucket algorithm for rate limiting
 - Configurable tokens per minute and burst size
@@ -95,7 +95,7 @@ console.log(runtime.getMetricsSummary());
 
 ### 7. Retry Logic
 
-**Implementation**: `src/utils/retry.ts`
+**Implementation**: `src/utils/retry.ts` (adapter over `@hazeljs/resilience` `RetryPolicy`)
 
 - Exponential backoff with jitter
 - Configurable retry attempts and delays
@@ -112,7 +112,7 @@ const runtime = new AgentRuntime({
 
 ### 8. Circuit Breaker
 
-**Implementation**: `src/utils/circuit-breaker.ts`
+**Implementation**: `@hazeljs/resilience` `CircuitBreaker` (used internally by `AgentRuntime`)
 
 - Three states: CLOSED, OPEN, HALF_OPEN
 - Automatic state transitions
@@ -123,11 +123,14 @@ const runtime = new AgentRuntime({
 **Usage**:
 
 ```typescript
+import { CircuitBreakerError } from '@hazeljs/resilience';
+
 const runtime = new AgentRuntime({
   enableCircuitBreaker: true, // Enabled by default
 });
 
 const status = runtime.getCircuitBreakerStatus();
+// Repeated failures throw CircuitBreakerError on execute()
 ```
 
 ### 9. Health Checks
@@ -161,19 +164,12 @@ console.log(health.status); // 'healthy' | 'degraded' | 'unhealthy'
 npm run benchmark
 ```
 
-## 🚧 Remaining Tasks
-
-### Additional Test Coverage
+## Remaining tasks (post-1.0.1)
 
-Create tests for remaining core components:
-
-- `tests/runtime/agent.runtime.test.ts`
-- `tests/executor/agent.executor.test.ts`
-- `tests/executor/tool.executor.test.ts`
-- `tests/state/agent.state.test.ts`
-- `tests/registry/agent.registry.test.ts`
-- `tests/context/agent.context.test.ts`
-- `tests/events/event.emitter.test.ts`
+- Durable **A2A task store** (same Redis pattern as approvals)
+- Full **`@hazeljs/flow`** integration for long-running workflows
+- Typed DI token replacing global `__HAZELJS_AI_ENHANCED_SERVICE__`
+- Cross-link agent OTel spans in `@hazeljs/observability` package docs
 
 ## 📋 Installation Instructions
 
@@ -203,6 +199,37 @@ npm run test:watch
 npm run build
 ```
 
+## ✅ v1.0 Production Hardening (2026)
+
+### Durable state & approvals
+
+- `createStateManagerFromEnv()` / `createStateManager()` factory helpers
+- `AgentModule.forRoot()` wires Redis when `redis.client` is provided; `forRootAsync()` connects via `REDIS_URL`
+- `IApprovalStore` with `InMemoryApprovalStore` (dev) and `RedisApprovalStore` (multi-instance)
+- Typed `RedisClientLike` / `PrismaClientLike` minimal interfaces for state managers
+
+### Resilience consolidation
+
+- Local `retry.ts` and `rate-limiter.ts` delegate to `@hazeljs/resilience`
+- Removed deprecated `src/utils/circuit-breaker.js` shim
+- Circuit breaker integration tests through `AgentRuntime.execute()`
+
+### Observability
+
+- Optional peer: `@hazeljs/observability` and `@opentelemetry/api`
+- OTel spans: `agent.execute`, `agent.tool.execute`, `agent.llm`
+- `trackLlmCost()` bridge when observability provider is configured
+
+### Error handling
+
+- RAG failures emit `agent.rag.failed` instead of silent empty context
+- `strictEventHandlers` on `AgentEventEmitter` surfaces handler errors in production
+- LLM provider resolution logs error after 500ms timeout if `@hazeljs/ai` is not loaded
+
+### Integration tests
+
+- `tests/integration/production-hardening.test.ts` — Redis state, approvals, circuit breaker, RAG errors
+
 ## 🎯 Coverage Goals
 
 - **Unit Test Coverage**: 80%+ (configured in jest.config.js)

package/QUICKSTART.md

@@ -132,6 +132,26 @@ if (result.state === 'waiting_for_input') {
 }
 ```
 
+## Production setup
+
+For multi-instance deployments, use Redis-backed state and approvals:
+
+```typescript
+import { AgentModule } from '@hazeljs/agent';
+import { createClient } from 'redis';
+
+const redisClient = createClient({ url: process.env.REDIS_URL });
+await redisClient.connect();
+
+await AgentModule.forRootAsync({
+  redis: { client: redisClient },
+  useRedisApprovals: true,
+  runtime: { strictEventHandlers: process.env.NODE_ENV === 'production' },
+});
+```
+
+See [PERSISTENCE.md](./PERSISTENCE.md) for `AGENT_STATE_BACKEND` and factory helpers.
+
 ## Support
 
 - GitHub Issues: [Report bugs](https://github.com/hazeljs/hazeljs/issues)

package/README.md

@@ -83,15 +83,15 @@ export class SupportAgent {
 ### 2. Set up the runtime
 
 ```typescript
-import { AgentRuntime } from '@hazeljs/agent';
+import { AgentRuntime, AgentService } from '@hazeljs/agent';
 import { MemoryManager } from '@hazeljs/rag';
-import { AIService } from '@hazeljs/ai';
+import { AIEnhancedService } from '@hazeljs/ai';
 
 const runtime = new AgentRuntime({
   memoryManager: new MemoryManager(/* ... */),
-  llmProvider: new AIService({ provider: 'openai' }),
+  llmProvider: AgentService.createLLMProviderFromAI(new AIEnhancedService()),
   defaultMaxSteps: 10,
-  enableObservability: true,
+  // Optional: pass observabilityProvider from @hazeljs/observability for OTel spans
 });
 
 const agent = new SupportAgent();
@@ -436,6 +436,41 @@ runtime.onAny((e) => console.log(e.type, e.data));
 
 ---
 
+## Production deployment (1.0.1+)
+
+For multi-instance deployments, use Redis-backed state and durable approvals:
+
+```typescript
+import { AgentModule } from '@hazeljs/agent';
+import { createClient } from 'redis';
+
+const redis = createClient({ url: process.env.REDIS_URL });
+await redis.connect();
+
+await AgentModule.forRootAsync({
+  redis: { client: redis },
+  useRedisApprovals: true,
+  runtime: {
+    strictEventHandlers: process.env.NODE_ENV === 'production',
+    observabilityProvider: myObservabilityProvider, // optional, from @hazeljs/observability
+    enableMetrics: true,
+    enableCircuitBreaker: true,
+  },
+});
+```
+
+**Environment variables:** `REDIS_URL`, `AGENT_STATE_BACKEND` (`memory` | `redis` | `database`)
+
+**Factories:** `createStateManager`, `createStateManagerFromEnv`, `createApprovalStore`
+
+**Observability:** Pass `observabilityProvider` for OpenTelemetry spans (`agent.execute`, `agent.tool.execute`, `agent.llm`). The `enableObservability` flag is reserved; spans require an injected provider.
+
+**Resilience:** Circuit breaker and retry use `@hazeljs/resilience` internally.
+
+See [PERSISTENCE.md](./PERSISTENCE.md), [PRODUCTION_READINESS.md](./PRODUCTION_READINESS.md), and [QUICKSTART.md](./QUICKSTART.md).
+
+---
+
 ## HazelJS Module Integration
 
 ```typescript
@@ -449,7 +484,11 @@ import { RagModule } from '@hazeljs/rag';
       /* ... */
     }),
     AgentModule.forRoot({
-      runtime: { defaultMaxSteps: 10, enableObservability: true },
+      runtime: {
+        defaultMaxSteps: 10,
+        enableMetrics: true,
+        strictEventHandlers: process.env.NODE_ENV === 'production',
+      },
       agents: [SupportAgent, ResearchAgent, WriterAgent, OrchestratorAgent],
     }),
   ],

package/STATE_VS_MEMORY.md

@@ -235,12 +235,29 @@ const runtime = new AgentRuntime({
 ### Production
 
 ```typescript
-// Redis for agent state (fast, distributed)
-// Vector store (Pinecone) for memory (semantic search)
-const stateManager = new RedisStateManager({ client: redisClient });
+// Redis for agent state + durable approvals (multi-instance)
+import { AgentModule } from '@hazeljs/agent';
+import { createClient } from 'redis';
+
+const redisClient = createClient({ url: process.env.REDIS_URL });
+await redisClient.connect();
+
+await AgentModule.forRootAsync({
+  redis: { client: redisClient },
+  useRedisApprovals: true,
+});
+
+// Vector store (Pinecone) for long-term memory (semantic search)
 const memoryStore = new VectorMemory(pineconeStore, embeddings);
 const memoryManager = new MemoryManager(memoryStore);
+```
+
+Or wire managers manually:
 
+```typescript
+import { RedisStateManager } from '@hazeljs/agent';
+
+const stateManager = new RedisStateManager({ client: redisClient });
 const runtime = new AgentRuntime({
   stateManager, // ← Agent execution state
   memoryManager, // ← Long-term memory

package/dist/agent.module.d.ts

@@ -5,6 +5,9 @@ import { SupervisorAgent } from './supervisor/supervisor';
 import { AgentEventType } from './types/event.types';
 import type { AgentContext, AgentExecutionResult, AgentStreamChunk } from './types/agent.types';
 import type { LLMStreamChunk } from './types/llm.types';
+import { type AgentStateBackend, type CreateStateManagerOptions } from './state/create-state-manager';
+import type { RedisClientLike, PrismaClientLike } from './state/redis-client.types';
+import type { ObservabilityProvider } from './types/observability.types';
 type NewableFunction = new (...args: unknown[]) => unknown;
 /** Token for optional GuardrailsService injection (from @hazeljs/guardrails) */
 export declare const GUARDRAILS_SERVICE_TOKEN = "GuardrailsService";
@@ -15,6 +18,21 @@ export interface AgentModuleOptions {
     runtime?: AgentRuntimeConfig;
     agents?: NewableFunction[];
     autoDiscover?: boolean;
+    /** Pre-connected Redis client or URL (use forRootAsync when only url is available) */
+    redis?: {
+        client?: RedisClientLike;
+        url?: string;
+    };
+    /** Prisma client for database-backed state */
+    database?: {
+        prismaClient?: PrismaClientLike;
+    };
+    /** Override AGENT_STATE_BACKEND (memory | redis | database) */
+    stateBackend?: AgentStateBackend;
+    /** Use Redis-backed approval store when redis client is configured */
+    useRedisApprovals?: boolean;
+    /** Optional observability provider from @hazeljs/observability */
+    observabilityProvider?: ObservabilityProvider;
 }
 /**
  * Agent Service
@@ -100,6 +118,11 @@ export declare class AgentService {
 export declare class AgentModule {
     private static options;
     static forRoot(config?: AgentModuleOptions): typeof AgentModule;
+    /**
+     * Async module setup — connects Redis from REDIS_URL or redis.url before boot.
+     */
+    static forRootAsync(config?: AgentModuleOptions): Promise<typeof AgentModule>;
+    static buildStateManagerOptions(config: AgentModuleOptions): CreateStateManagerOptions;
     static getOptions(): AgentModuleOptions;
     /**
      * Create an LLM provider from AIEnhancedService

package/dist/agent.module.d.ts.map

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

package/dist/agent.module.js

@@ -17,6 +17,7 @@ exports.AgentModule = exports.AgentService = exports.GUARDRAILS_SERVICE_TOKEN =
 const core_1 = require("@hazeljs/core");
 const agent_runtime_1 = require("./runtime/agent.runtime");
 const agent_decorator_1 = require("./decorators/agent.decorator");
+const create_state_manager_1 = require("./state/create-state-manager");
 /** Token for optional GuardrailsService injection (from @hazeljs/guardrails) */
 exports.GUARDRAILS_SERVICE_TOKEN = 'GuardrailsService';
 /**
@@ -32,6 +33,15 @@ let AgentService = AgentService_1 = class AgentService {
             ...(moduleOpts.runtime || config),
             guardrailsService: guardrailsService ?? moduleOpts.runtime?.guardrailsService ?? config.guardrailsService,
             llmProvider: moduleOpts.runtime?.llmProvider ?? config.llmProvider,
+            observabilityProvider: moduleOpts.runtime?.observabilityProvider ??
+                moduleOpts.observabilityProvider ??
+                config.observabilityProvider,
+            stateManagerOptions: moduleOpts.runtime?.stateManagerOptions ??
+                config.stateManagerOptions ??
+                AgentModule.buildStateManagerOptions(moduleOpts),
+            useRedisApprovals: moduleOpts.runtime?.useRedisApprovals ??
+                moduleOpts.useRedisApprovals ??
+                config.useRedisApprovals,
         };
         this.runtime = new agent_runtime_1.AgentRuntime(runtimeConfig);
         // Defer agent discovery and LLM provider resolution until after all modules are loaded
@@ -55,6 +65,9 @@ let AgentService = AgentService_1 = class AgentService {
         else if (retryCount < 10) {
             setTimeout(() => this.resolveLLMProvider(retryCount + 1), 50);
         }
+        else {
+            core_1.logger.error('AgentService: LLM provider not available after 500ms. Load @hazeljs/ai or set runtime.llmProvider in AgentModule.forRoot().');
+        }
     }
     /**
      * Create an LLM provider adapter from AIEnhancedService
@@ -265,9 +278,49 @@ exports.AgentService = AgentService = AgentService_1 = __decorate([
  */
 let AgentModule = AgentModule_1 = class AgentModule {
     static forRoot(config = {}) {
-        AgentModule_1.options = config;
+        const runtime = { ...(config.runtime ?? {}) };
+        if (!runtime.stateManager) {
+            try {
+                runtime.stateManager = (0, create_state_manager_1.createStateManager)(AgentModule_1.buildStateManagerOptions(config));
+            }
+            catch {
+                // resolveStateManager in AgentRuntime falls back to in-memory
+            }
+        }
+        runtime.stateManagerOptions =
+            runtime.stateManagerOptions ?? AgentModule_1.buildStateManagerOptions(config);
+        runtime.useRedisApprovals = runtime.useRedisApprovals ?? config.useRedisApprovals;
+        runtime.observabilityProvider = runtime.observabilityProvider ?? config.observabilityProvider;
+        AgentModule_1.options = { ...config, runtime };
         return AgentModule_1;
     }
+    /**
+     * Async module setup — connects Redis from REDIS_URL or redis.url before boot.
+     */
+    static async forRootAsync(config = {}) {
+        const runtime = { ...(config.runtime ?? {}) };
+        const baseOptions = AgentModule_1.buildStateManagerOptions(config);
+        if (!runtime.stateManager) {
+            const { stateManager, stateManagerOptions } = await (0, create_state_manager_1.resolveStateManagerFromEnv)(baseOptions);
+            runtime.stateManager = stateManager;
+            runtime.stateManagerOptions = stateManagerOptions;
+        }
+        else {
+            runtime.stateManagerOptions = baseOptions;
+        }
+        runtime.useRedisApprovals = runtime.useRedisApprovals ?? config.useRedisApprovals;
+        runtime.observabilityProvider = runtime.observabilityProvider ?? config.observabilityProvider;
+        AgentModule_1.options = { ...config, runtime };
+        return AgentModule_1;
+    }
+    static buildStateManagerOptions(config) {
+        return {
+            backend: config.stateBackend,
+            redisClient: config.redis?.client,
+            redisUrl: config.redis?.url,
+            prismaClient: config.database?.prismaClient,
+        };
+    }
     static getOptions() {
         return AgentModule_1.options;
     }

package/dist/agent.module.js.map

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

package/dist/approval/approval-store.interface.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Pluggable store for tool approval requests (supports multi-instance deployments).
+ */
+import { ToolApprovalRequest } from '../types/tool.types';
+export interface IApprovalStore {
+    create(request: ToolApprovalRequest): Promise<void> | void;
+    get(requestId: string): Promise<ToolApprovalRequest | undefined> | ToolApprovalRequest | undefined;
+    listPending(): Promise<ToolApprovalRequest[]> | ToolApprovalRequest[];
+    approve(requestId: string, approvedBy: string): Promise<boolean> | boolean;
+    reject(requestId: string): Promise<boolean> | boolean;
+    delete(requestId: string): Promise<void> | void;
+}
+export interface ApprovalWaitOptions {
+    requestId: string;
+    expiresAt: Date;
+    pollIntervalMs?: number;
+}
+//# sourceMappingURL=approval-store.interface.d.ts.map

package/dist/approval/approval-store.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-store.interface.d.ts","sourceRoot":"","sources":["../../src/approval/approval-store.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3D,GAAG,CACD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAC9E,WAAW,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,GAAG,mBAAmB,EAAE,CAAC;IACtE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC3E,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACtD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/approval/approval-store.interface.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Pluggable store for tool approval requests (supports multi-instance deployments).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=approval-store.interface.js.map

package/dist/approval/approval-store.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-store.interface.js","sourceRoot":"","sources":["../../src/approval/approval-store.interface.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/approval/create-approval-store.d.ts

@@ -0,0 +1,8 @@
+import { IApprovalStore } from './approval-store.interface';
+import type { RedisClientLike } from '../state/redis-client.types';
+export interface CreateApprovalStoreOptions {
+    redisClient?: RedisClientLike;
+    useRedis?: boolean;
+}
+export declare function createApprovalStore(options?: CreateApprovalStoreOptions): IApprovalStore;
+//# sourceMappingURL=create-approval-store.d.ts.map

package/dist/approval/create-approval-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-approval-store.d.ts","sourceRoot":"","sources":["../../src/approval/create-approval-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,cAAc,CAQ5F"}

package/dist/approval/create-approval-store.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApprovalStore = createApprovalStore;
+const in_memory_approval_store_1 = require("./in-memory-approval.store");
+const redis_approval_store_1 = require("./redis-approval.store");
+function createApprovalStore(options = {}) {
+    if (options.useRedis || options.redisClient) {
+        if (!options.redisClient) {
+            throw new Error('redisClient is required when useRedis is enabled for approval store.');
+        }
+        return new redis_approval_store_1.RedisApprovalStore({ client: options.redisClient });
+    }
+    return new in_memory_approval_store_1.InMemoryApprovalStore();
+}
+//# sourceMappingURL=create-approval-store.js.map

package/dist/approval/create-approval-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-approval-store.js","sourceRoot":"","sources":["../../src/approval/create-approval-store.ts"],"names":[],"mappings":";;AAUA,kDAQC;AAjBD,yEAAmE;AACnE,iEAA4D;AAQ5D,SAAgB,mBAAmB,CAAC,UAAsC,EAAE;IAC1E,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,IAAI,yCAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,IAAI,gDAAqB,EAAE,CAAC;AACrC,CAAC"}

package/dist/approval/in-memory-approval.store.d.ts

@@ -0,0 +1,22 @@
+import { ToolApprovalRequest } from '../types/tool.types';
+import { IApprovalStore } from './approval-store.interface';
+/** In-process resolver for a pending approval wait. */
+export interface ApprovalResolver {
+    resolve: (approved: boolean) => void;
+    timeoutId?: NodeJS.Timeout;
+}
+/**
+ * In-memory approval store (default for development and single-instance deployments).
+ */
+export declare class InMemoryApprovalStore implements IApprovalStore {
+    private readonly requests;
+    readonly resolvers: Map<string, ApprovalResolver>;
+    create(request: ToolApprovalRequest): void;
+    get(requestId: string): ToolApprovalRequest | undefined;
+    listPending(): ToolApprovalRequest[];
+    approve(requestId: string, approvedBy: string): boolean;
+    reject(requestId: string): boolean;
+    delete(requestId: string): void;
+    registerResolver(requestId: string, resolver: ApprovalResolver): void;
+}
+//# sourceMappingURL=in-memory-approval.store.d.ts.map

package/dist/approval/in-memory-approval.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-approval.store.d.ts","sourceRoot":"","sources":["../../src/approval/in-memory-approval.store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IACnE,QAAQ,CAAC,SAAS,gCAAuC;IAEzD,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAI1C,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIvD,WAAW,IAAI,mBAAmB,EAAE;IAIpC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAgBvD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAelC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAO/B,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;CAGtE"}