agentic-qe 3.3.4 → 3.4.0

package/v3/dist/adapters/ag-ui/index.js

@@ -0,0 +1,47 @@
+/**
+ * AG-UI Protocol Adapter
+ *
+ * Barrel export for AG-UI event types, adapter, and state management.
+ * Provides AG-UI Protocol 1.0 compliance for AQE v3.
+ *
+ * @module adapters/ag-ui
+ */
+// Event Types
+export { 
+// Enum
+AGUIEventType, 
+// Type Guards
+isAQEToolProgress, isAQEToolResult, isAQEAgentStarted, isAQEAgentCompleted, isAQEAgentError, isAQEDomainEvent, getEventCategory, getEventTypesForCategory, } from './event-types.js';
+// Event Adapter
+export { EventAdapter, createEventAdapter, } from './event-adapter.js';
+// State Manager
+export { StateManager, createStateManager, } from './state-manager.js';
+// JSON Patch Wrapper (RFC 6902) - fast-json-patch based
+export { 
+// Path utilities
+escapePathToken, unescapePathToken, parsePath, buildPath, getValueAtPath, setValueAtPath, deleteValueAtPath, pathExists, validatePath, 
+// Validation
+validateOperation, validatePatch, 
+// RFC 6902 Compliance
+checkCompliance, ensureCompliance, 
+// Patch application
+applyOperation, applyPatch, applyPatchAtomic, validate, 
+// Diff computation
+deepEqual, computeDiff, observe, unobserve, 
+// Operation factories
+createTestOperation, createAddOperation, createRemoveOperation, createReplaceOperation, createMoveOperation, createCopyOperation, 
+// Error handling
+JsonPatchError, 
+// Fast-json-patch access for advanced usage
+fastJsonPatchLib, } from './json-patch.js';
+// NOTE: PatchResult and DiffConfig are already exported from state-manager.js above
+// Do not re-export from json-patch.js to avoid duplicate identifier errors
+// Stream Controller
+export { StreamController, createStreamController, streamEvents, createEventTransform, } from './stream-controller.js';
+// Backpressure Handler
+export { BackpressureHandler, createBackpressureHandler, createBackpressureConsumer, isCriticalEventCategory, getRecommendedStrategy, } from './backpressure-handler.js';
+// Event Batcher
+export { EventBatcher, createEventBatcher, serializeBatch, deserializeBatch, calculateOptimalBatchConfig, getDefaultPriorityEvents, withBatching, } from './event-batcher.js';
+// State Delta Cache
+export { StateDeltaCache, createStateDeltaCache, getAgentStatusValues, getProgressMilestones, getToolStatusValues, } from './state-delta-cache.js';
+//# sourceMappingURL=index.js.map

package/v3/dist/adapters/ag-ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/ag-ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc;AACd,OAAO;AACL,OAAO;AACP,aAAa;AAoDb,cAAc;AACd,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAIhB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAE1B,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,kBAAkB,GAMnB,MAAM,oBAAoB,CAAC;AAE5B,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,kBAAkB,GAMnB,MAAM,oBAAoB,CAAC;AAE5B,wDAAwD;AACxD,OAAO;AACL,iBAAiB;AACjB,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,YAAY;AAEZ,aAAa;AACb,iBAAiB,EACjB,aAAa;AAGb,sBAAsB;AACtB,eAAe,EACf,gBAAgB;AAIhB,oBAAoB;AACpB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,QAAQ;AAER,mBAAmB;AACnB,SAAS,EACT,WAAW,EACX,OAAO,EACP,SAAS;AAET,sBAAsB;AACtB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB;AAEnB,iBAAiB;AACjB,cAAc;AAOd,4CAA4C;AAC5C,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,oFAAoF;AACpF,2EAA2E;AAE3E,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,oBAAoB,GAIrB,MAAM,wBAAwB,CAAC;AAEhC,uBAAuB;AACvB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,GAKvB,MAAM,2BAA2B,CAAC;AAEnC,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,2BAA2B,EAC3B,wBAAwB,EACxB,YAAY,GAKb,MAAM,oBAAoB,CAAC;AAE5B,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,GAQpB,MAAM,wBAAwB,CAAC"}

package/v3/dist/adapters/ag-ui/json-patch-utils.d.ts

@@ -0,0 +1,136 @@
+/**
+ * JSON Patch Utilities (RFC 6902)
+ *
+ * Provides utilities for computing and applying JSON Patch operations
+ * for AG-UI STATE_DELTA event synchronization.
+ *
+ * Reference: https://datatracker.ietf.org/doc/html/rfc6902
+ *
+ * @module adapters/ag-ui/json-patch-utils
+ */
+import type { JsonPatchOperation } from './event-types.js';
+/**
+ * Result of applying a patch operation
+ */
+export interface PatchResult {
+    /** Whether the patch was applied successfully */
+    success: boolean;
+    /** The resulting document after patch application */
+    document: Record<string, unknown>;
+    /** Error message if patch failed */
+    error?: string;
+    /** Index of the failed operation (if any) */
+    failedOperationIndex?: number;
+}
+/**
+ * Configuration for diff computation
+ */
+export interface DiffConfig {
+    /** Whether to generate 'test' operations for validation */
+    generateTestOps?: boolean;
+    /** Whether to use 'move' operations when possible */
+    detectMoves?: boolean;
+    /** Maximum depth to compare objects (default: unlimited) */
+    maxDepth?: number;
+}
+/**
+ * Validation result for a patch operation
+ */
+export interface ValidationResult {
+    /** Whether the operation is valid */
+    valid: boolean;
+    /** Error message if invalid */
+    error?: string;
+}
+/**
+ * Escape special characters in a JSON Pointer token (RFC 6901)
+ * ~ becomes ~0
+ * / becomes ~1
+ */
+export declare function escapePathToken(token: string): string;
+/**
+ * Unescape special characters in a JSON Pointer token (RFC 6901)
+ * ~0 becomes ~
+ * ~1 becomes /
+ */
+export declare function unescapePathToken(token: string): string;
+/**
+ * Parse a JSON Pointer path into tokens
+ */
+export declare function parsePath(path: string): string[];
+/**
+ * Build a JSON Pointer path from tokens
+ */
+export declare function buildPath(tokens: string[]): string;
+/**
+ * Get a value from an object using a JSON Pointer path
+ */
+export declare function getValueAtPath(document: Record<string, unknown>, path: string): unknown;
+/**
+ * Set a value at a JSON Pointer path (mutates the document)
+ */
+export declare function setValueAtPath(document: Record<string, unknown>, path: string, value: unknown): void;
+/**
+ * Delete a value at a JSON Pointer path (mutates the document)
+ */
+export declare function deleteValueAtPath(document: Record<string, unknown>, path: string): void;
+/**
+ * Check if a path exists in the document
+ */
+export declare function pathExists(document: Record<string, unknown>, path: string): boolean;
+/**
+ * Validate a single patch operation
+ */
+export declare function validateOperation(op: JsonPatchOperation): ValidationResult;
+/**
+ * Validate an array of patch operations
+ */
+export declare function validatePatch(patch: JsonPatchOperation[]): ValidationResult;
+/**
+ * Apply a single patch operation to a document
+ * Returns a new document (immutable)
+ */
+export declare function applyOperation(document: Record<string, unknown>, op: JsonPatchOperation): Record<string, unknown>;
+/**
+ * Apply a JSON Patch to a document
+ * Returns result with success status and either new document or error info
+ */
+export declare function applyPatch(document: Record<string, unknown>, patch: JsonPatchOperation[]): PatchResult;
+/**
+ * Apply a JSON Patch atomically with automatic rollback on failure
+ * Returns the new document if successful, throws on error
+ */
+export declare function applyPatchAtomic(document: Record<string, unknown>, patch: JsonPatchOperation[]): Record<string, unknown>;
+/**
+ * Deep equality comparison for JSON values
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+/**
+ * Compute the JSON Patch to transform oldState into newState
+ */
+export declare function computeDiff(oldState: Record<string, unknown>, newState: Record<string, unknown>, config?: DiffConfig): JsonPatchOperation[];
+/**
+ * Create a test operation to validate state before applying patches
+ */
+export declare function createTestOperation(path: string, value: unknown): JsonPatchOperation;
+/**
+ * Create an add operation
+ */
+export declare function createAddOperation(path: string, value: unknown): JsonPatchOperation;
+/**
+ * Create a remove operation
+ */
+export declare function createRemoveOperation(path: string): JsonPatchOperation;
+/**
+ * Create a replace operation
+ */
+export declare function createReplaceOperation(path: string, value: unknown): JsonPatchOperation;
+/**
+ * Create a move operation
+ */
+export declare function createMoveOperation(from: string, path: string): JsonPatchOperation;
+/**
+ * Create a copy operation
+ */
+export declare function createCopyOperation(from: string, path: string): JsonPatchOperation;
+//# sourceMappingURL=json-patch-utils.d.ts.map

package/v3/dist/adapters/ag-ui/json-patch-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-patch-utils.d.ts","sourceRoot":"","sources":["../../../src/adapters/ag-ui/json-patch-utils.ts"],"names":[],"mappings":"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"}