@juspay/neurolink 13.4.8 → 13.4.10

package/dist/hitl/hitlManager.d.ts

@@ -7,6 +7,7 @@
  */
 import { EventEmitter } from "events";
 import type { HITLConfig, ConfirmationResult, HITLStatistics } from "../types/index.js";
+export declare const DEFAULT_ALLOW_MODIFICATION = false;
 /**
  * HITLManager - Central orchestrator for Human-in-the-Loop safety mechanisms
  *

package/dist/hitl/hitlManager.js

@@ -11,7 +11,8 @@ import { HITLTimeoutError, HITLConfigurationError } from "./hitlErrors.js";
 import { logger } from "../utils/logger.js";
 // Default configuration constants
 const DEFAULT_TIMEOUT = 30000; // 30 seconds
-const DEFAULT_ALLOW_MODIFICATION = false;
+// Shared with NeuroLink's HITL init logs so they report the policy applied here
+export const DEFAULT_ALLOW_MODIFICATION = false;
 /**
  * HITLManager - Central orchestrator for Human-in-the-Loop safety mechanisms
  *

package/dist/neurolink.js

@@ -44,7 +44,7 @@ import { ProviderFactory } from "./factories/providerFactory.js";
 import { ProviderRegistry } from "./factories/providerRegistry.js";
 import { FileReferenceRegistry } from "./files/fileReferenceRegistry.js";
 import { createFileTools } from "./files/fileTools.js";
-import { HITLManager } from "./hitl/hitlManager.js";
+import { HITLManager, DEFAULT_ALLOW_MODIFICATION } from "./hitl/hitlManager.js";
 import { ToolCallBatcher } from "./mcp/batching/index.js";
 // MCP Enhancement modules - wired into core execution path
 import { ToolResultCache } from "./mcp/caching/index.js";
@@ -242,7 +242,10 @@ const MEMORY_WRITE_TIMEOUT_MS = 30_000;
  *
  * @example With HITL security
  * ```typescript
- * import type { ConfirmationRequestEvent } from '@juspay/neurolink';
+ * import type {
+ *   ConfirmationRequestEvent,
+ *   ConfirmationResponseEvent,
+ * } from '@juspay/neurolink';
  *
  * const neurolink = new NeuroLink({
  *   hitl: {
@@ -255,12 +258,20 @@ const MEMORY_WRITE_TIMEOUT_MS = 30_000;
  * // Approval is event-based; answer each request with the matching id
  * const emitter = neurolink.getEventEmitter();
  * emitter.on('hitl:confirmation-request', async (event) => {
+ *   const receivedAt = Date.now();
  *   const { payload } = event as ConfirmationRequestEvent; // listeners are typed unknown
  *   const approved = await askUser(payload); // your approval UI
  *   emitter.emit('hitl:confirmation-response', {
  *     type: 'hitl:confirmation-response',
- *     payload: { confirmationId: payload.confirmationId, approved }
- *   });
+ *     payload: {
+ *       confirmationId: payload.confirmationId,
+ *       approved,
+ *       metadata: {
+ *         timestamp: new Date().toISOString(),
+ *         responseTime: Date.now() - receivedAt // ms since the request arrived
+ *       }
+ *     }
+ *   } satisfies ConfirmationResponseEvent);
  * });
  * ```
  *
@@ -1518,7 +1529,7 @@ export class NeuroLink {
                     enabled: config.hitl.enabled,
                     dangerousActions: config.hitl.dangerousActions || [],
                     timeout: config.hitl.timeout || 30000,
-                    allowArgumentModification: config.hitl.allowArgumentModification ?? true,
+                    allowArgumentModification: config.hitl.allowArgumentModification ?? DEFAULT_ALLOW_MODIFICATION,
                     auditLogging: config.hitl.auditLogging ?? false,
                 },
                 message: "Starting HITL (Human-in-the-Loop) initialization",
@@ -1548,7 +1559,7 @@ export class NeuroLink {
                 logger.info(`[NeuroLink] HITL safety features enabled`, {
                     dangerousActions: config.hitl.dangerousActions?.length || 0,
                     timeout: config.hitl.timeout || 30000,
-                    allowArgumentModification: config.hitl.allowArgumentModification ?? true,
+                    allowArgumentModification: config.hitl.allowArgumentModification ?? DEFAULT_ALLOW_MODIFICATION,
                     auditLogging: config.hitl.auditLogging ?? false,
                 });
             }