agentic-qe 3.3.4 → 3.4.0

package/v3/dist/adapters/a2ui/renderer/templates/test-results-surface.js

@@ -0,0 +1,294 @@
+/**
+ * Test Results Surface Template
+ *
+ * Generates A2UI surface for displaying test execution results
+ * including pass/fail badges, test list, and timeline.
+ *
+ * @module adapters/a2ui/renderer/templates/test-results-surface
+ */
+import { literal, path, templateChildren } from '../message-types.js';
+import { createComponentBuilder } from '../component-builder.js';
+// ============================================================================
+// Test Results Surface Generator
+// ============================================================================
+/**
+ * Generate test results dashboard surface
+ */
+export function createTestResultsSurface(data, surfaceId = 'test-results') {
+    const builder = createComponentBuilder();
+    builder
+        .beginSurface(surfaceId)
+        .setTitle('Test Results')
+        .setCatalog('qe-v1');
+    // Root container
+    builder.addComponent('root', {
+        type: 'Column',
+        spacing: 16,
+    });
+    builder.setChildren('root', [
+        'header',
+        'badges-row',
+        'progress-section',
+        'results-tabs',
+    ]);
+    // Header
+    builder.addComponent('header', {
+        type: 'Row',
+        alignment: 'spaceBetween',
+    });
+    builder.setChildren('header', ['title', 'duration-badge']);
+    builder.addComponent('title', {
+        type: 'Text',
+        text: literal('Test Execution Results'),
+        usageHint: 'h1',
+    });
+    builder.addComponent('duration-badge', {
+        type: 'Row',
+        spacing: 8,
+    });
+    builder.setChildren('duration-badge', ['duration-icon', 'duration-text']);
+    builder.addComponent('duration-icon', {
+        type: 'Icon',
+        name: 'timer',
+    });
+    builder.addComponent('duration-text', {
+        type: 'Text',
+        text: path('/results/durationFormatted'),
+        style: { fontWeight: 'bold' },
+    });
+    // Status badges row
+    builder.addComponent('badges-row', {
+        type: 'Row',
+        spacing: 16,
+        alignment: 'center',
+    });
+    builder.setChildren('badges-row', [
+        'total-badge',
+        'pass-badge',
+        'fail-badge',
+        'skip-badge',
+    ]);
+    // Total badge
+    builder.addComponent('total-badge', {
+        type: 'qe:testStatusBadge',
+        status: literal('total'),
+        count: path('/results/total'),
+        label: literal('Total'),
+        color: '#2196F3',
+    });
+    // Pass badge
+    builder.addComponent('pass-badge', {
+        type: 'qe:testStatusBadge',
+        status: literal('passed'),
+        count: path('/results/passed'),
+        duration: path('/results/passDuration'),
+        label: literal('Passed'),
+        color: '#4CAF50',
+        accessibility: {
+            role: 'status',
+            live: 'polite',
+        },
+    });
+    // Fail badge
+    builder.addComponent('fail-badge', {
+        type: 'qe:testStatusBadge',
+        status: literal('failed'),
+        count: path('/results/failed'),
+        duration: path('/results/failDuration'),
+        label: literal('Failed'),
+        color: '#F44336',
+        accessibility: {
+            role: 'alert',
+            live: 'assertive',
+        },
+    });
+    // Skip badge
+    builder.addComponent('skip-badge', {
+        type: 'qe:testStatusBadge',
+        status: literal('skipped'),
+        count: path('/results/skipped'),
+        label: literal('Skipped'),
+        color: '#FFC107',
+    });
+    // Progress section
+    builder.addComponent('progress-section', {
+        type: 'Card',
+        title: literal('Pass Rate'),
+    });
+    builder.setChildren('progress-section', ['progress-bar', 'progress-text']);
+    builder.addComponent('progress-bar', {
+        type: 'ProgressBar',
+        value: path('/results/passRate'),
+        max: 100,
+        color: path('/results/passRateColor'),
+    });
+    builder.addComponent('progress-text', {
+        type: 'Text',
+        text: path('/results/passRateFormatted'),
+        alignment: 'center',
+        style: { fontSize: 24, fontWeight: 'bold' },
+    });
+    // Results tabs
+    builder.addComponent('results-tabs', {
+        type: 'Tabs',
+    });
+    builder.setChildren('results-tabs', [
+        'timeline-tab',
+        'tests-tab',
+        'suites-tab',
+        'failures-tab',
+    ]);
+    // Timeline tab
+    builder.addComponent('timeline-tab', {
+        type: 'Tab',
+        label: literal('Timeline'),
+    });
+    builder.setChildren('timeline-tab', ['test-timeline']);
+    builder.addComponent('test-timeline', {
+        type: 'qe:testTimeline',
+        tests: path('/results/tests'),
+        startTime: path('/results/startTime'),
+        endTime: path('/results/endTime'),
+    });
+    // Tests tab
+    builder.addComponent('tests-tab', {
+        type: 'Tab',
+        label: literal('All Tests'),
+    });
+    builder.setChildren('tests-tab', ['tests-table']);
+    builder.addComponent('tests-table', {
+        type: 'Table',
+        columns: [
+            { key: 'status', label: 'Status', width: '10%' },
+            { key: 'name', label: 'Test Name', width: '40%' },
+            { key: 'suite', label: 'Suite', width: '25%' },
+            { key: 'duration', label: 'Duration', width: '15%' },
+            { key: 'actions', label: 'Actions', width: '10%' },
+        ],
+        data: path('/results/tests'),
+        sortable: true,
+        filterable: true,
+        rowAction: { name: 'view_test_details' },
+    });
+    // Suites tab
+    builder.addComponent('suites-tab', {
+        type: 'Tab',
+        label: literal('Suites'),
+    });
+    builder.setChildren('suites-tab', ['suites-accordion']);
+    builder.addComponent('suites-accordion', {
+        type: 'Accordion',
+        children: templateChildren('/results/suites', 'suite-item-template'),
+    });
+    builder.addComponent('suite-item-template', {
+        type: 'AccordionItem',
+        title: path('/name'),
+        subtitle: path('/summaryText'),
+    });
+    // Failures tab
+    builder.addComponent('failures-tab', {
+        type: 'Tab',
+        label: literal('Failures'),
+        badge: path('/results/failed'),
+    });
+    builder.setChildren('failures-tab', ['failures-list']);
+    builder.addComponent('failures-list', {
+        type: 'List',
+        children: templateChildren('/results/failedTests', 'failure-item-template'),
+        emptyMessage: literal('No failures - all tests passed!'),
+    });
+    builder.addComponent('failure-item-template', {
+        type: 'Card',
+        variant: 'error',
+    });
+    return builder.build();
+}
+/**
+ * Generate test results data model update
+ */
+export function createTestResultsDataUpdate(data, surfaceId = 'test-results') {
+    // Format duration
+    const formatDuration = (ms) => {
+        if (ms < 1000)
+            return `${ms}ms`;
+        if (ms < 60000)
+            return `${(ms / 1000).toFixed(1)}s`;
+        return `${Math.floor(ms / 60000)}m ${Math.round((ms % 60000) / 1000)}s`;
+    };
+    // Compute pass rate color
+    const getPassRateColor = (rate) => {
+        if (rate >= 90)
+            return '#4CAF50';
+        if (rate >= 70)
+            return '#FFC107';
+        return '#F44336';
+    };
+    // Filter failed tests
+    const failedTests = data.tests.filter((t) => t.status === 'failed');
+    return {
+        type: 'dataModelUpdate',
+        surfaceId,
+        data: {
+            results: {
+                total: data.total,
+                passed: data.passed,
+                failed: data.failed,
+                skipped: data.skipped,
+                duration: data.duration,
+                durationFormatted: formatDuration(data.duration),
+                passDuration: data.passDuration,
+                failDuration: data.failDuration,
+                startTime: data.startTime,
+                endTime: data.endTime,
+                passRate: data.passRate,
+                passRateFormatted: `${data.passRate.toFixed(1)}%`,
+                passRateColor: getPassRateColor(data.passRate),
+                summary: data.summary,
+                tests: data.tests.map((test) => ({
+                    ...test,
+                    durationFormatted: formatDuration(test.duration),
+                })),
+                suites: data.suites.map((suite) => ({
+                    ...suite,
+                    summaryText: `${suite.passed}/${suite.total} passed (${formatDuration(suite.duration)})`,
+                })),
+                failedTests,
+            },
+        },
+    };
+}
+/**
+ * Create a simple test summary surface
+ */
+export function createTestSummarySurface(data, surfaceId = 'test-summary') {
+    const builder = createComponentBuilder();
+    builder
+        .beginSurface(surfaceId)
+        .setTitle('Test Summary')
+        .setCatalog('qe-v1');
+    builder.addComponent('root', {
+        type: 'Row',
+        spacing: 16,
+    });
+    builder.setChildren('root', ['pass-badge', 'fail-badge', 'skip-badge']);
+    builder.addComponent('pass-badge', {
+        type: 'qe:testStatusBadge',
+        status: literal('passed'),
+        count: path('/tests/passed'),
+        label: literal('Passed'),
+    });
+    builder.addComponent('fail-badge', {
+        type: 'qe:testStatusBadge',
+        status: literal('failed'),
+        count: path('/tests/failed'),
+        label: literal('Failed'),
+    });
+    builder.addComponent('skip-badge', {
+        type: 'qe:testStatusBadge',
+        status: literal('skipped'),
+        count: path('/tests/skipped'),
+        label: literal('Skipped'),
+    });
+    return builder.build();
+}
+//# sourceMappingURL=test-results-surface.js.map

package/v3/dist/adapters/a2ui/renderer/templates/test-results-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-results-surface.js","sourceRoot":"","sources":["../../../../../src/adapters/a2ui/renderer/templates/test-results-surface.ts"],"names":[],"mappings":"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"}

package/v3/dist/adapters/ag-ui/backpressure-handler.d.ts

@@ -0,0 +1,201 @@
+/**
+ * AG-UI Backpressure Handler
+ *
+ * Detects and handles backpressure when client consumes events slower than producer.
+ * Provides configurable strategies for handling buffer overflow.
+ *
+ * @module adapters/ag-ui/backpressure-handler
+ */
+import { EventEmitter } from 'events';
+import type { AGUIEvent, AGUIEventType } from './event-types.js';
+import { type AGUIEventCategory } from './event-types.js';
+/**
+ * Backpressure strategy
+ *
+ * - `buffer`: Keep buffering up to maxBufferSize (default)
+ * - `drop-non-critical`: Drop TEXT_MESSAGE_CONTENT, keep lifecycle events
+ * - `pause-producer`: Signal producer to slow down
+ */
+export type BackpressureStrategy = 'buffer' | 'drop-non-critical' | 'pause-producer';
+/**
+ * Backpressure handler configuration
+ */
+export interface BackpressureHandlerConfig {
+    /** Maximum buffer size before backpressure is applied (default: 100) */
+    maxBufferSize?: number;
+    /** Strategy for handling backpressure (default: 'buffer') */
+    strategy?: BackpressureStrategy;
+    /** Callback when backpressure is detected */
+    onPressure?: (metrics: BackpressureMetrics) => void;
+    /** Callback when backpressure is relieved */
+    onRelieve?: (metrics: BackpressureMetrics) => void;
+    /** High watermark percentage to trigger pressure (default: 80) */
+    highWatermark?: number;
+    /** Low watermark percentage to relieve pressure (default: 50) */
+    lowWatermark?: number;
+    /** Maximum memory in bytes for buffer (default: 10MB) */
+    maxMemoryBytes?: number;
+    /** Event priority configuration */
+    eventPriority?: EventPriorityConfig;
+}
+/**
+ * Event priority configuration for drop-non-critical strategy
+ */
+export interface EventPriorityConfig {
+    /** Event types that are always kept (critical) */
+    critical?: AGUIEventType[];
+    /** Event types that can be dropped under pressure */
+    droppable?: AGUIEventType[];
+}
+/**
+ * Backpressure metrics
+ */
+export interface BackpressureMetrics {
+    /** Current buffer size */
+    bufferSize: number;
+    /** Maximum buffer size */
+    maxBufferSize: number;
+    /** Buffer utilization percentage */
+    utilizationPercent: number;
+    /** Total events dropped */
+    droppedCount: number;
+    /** Total events processed */
+    processedCount: number;
+    /** Number of times producer was paused */
+    pauseCount: number;
+    /** Total time spent in paused state (ms) */
+    totalPauseTimeMs: number;
+    /** Whether currently under pressure */
+    underPressure: boolean;
+    /** Estimated buffer memory usage in bytes */
+    memoryUsageBytes: number;
+    /** Events dropped by type */
+    droppedByType: Record<string, number>;
+    /** Current strategy */
+    strategy: BackpressureStrategy;
+}
+/**
+ * AG-UI Backpressure Handler
+ *
+ * Monitors event buffer and applies backpressure strategies when needed.
+ */
+export declare class BackpressureHandler extends EventEmitter {
+    private readonly maxBufferSize;
+    private readonly strategy;
+    private readonly onPressureCallback?;
+    private readonly onRelieveCallback?;
+    private readonly highWatermark;
+    private readonly lowWatermark;
+    private readonly maxMemoryBytes;
+    private readonly criticalEvents;
+    private readonly droppableEvents;
+    private buffer;
+    private memoryUsage;
+    private underPressure;
+    private producerPaused;
+    private pauseStartTime;
+    private metrics;
+    constructor(config?: BackpressureHandlerConfig);
+    /**
+     * Push an event to the handler
+     *
+     * @returns true if event was accepted, false if dropped or producer should pause
+     */
+    push(event: AGUIEvent): boolean;
+    /**
+     * Pull events from the buffer
+     *
+     * @param count - Number of events to pull (default: all)
+     * @returns Array of events
+     */
+    pull(count?: number): AGUIEvent[];
+    /**
+     * Pull a single event from the buffer
+     */
+    pullOne(): AGUIEvent | undefined;
+    /**
+     * Check if buffer has events
+     */
+    hasEvents(): boolean;
+    /**
+     * Clear the buffer
+     */
+    clear(): void;
+    /**
+     * Get current metrics
+     */
+    getMetrics(): Readonly<BackpressureMetrics>;
+    /**
+     * Check if under pressure
+     */
+    isUnderPressure(): boolean;
+    /**
+     * Check if producer is paused
+     */
+    isProducerPaused(): boolean;
+    /**
+     * Get buffer size
+     */
+    getBufferSize(): number;
+    /**
+     * Get memory usage
+     */
+    getMemoryUsage(): number;
+    /**
+     * Signal that producer can resume (for pause-producer strategy)
+     */
+    resumeProducer(): void;
+    private handleMemoryPressure;
+    private handleBufferFull;
+    private applyBackpressureStrategy;
+    private addToBuffer;
+    private recordDropped;
+    private isCriticalEvent;
+    private isDroppableEvent;
+    private enterPressureState;
+    private exitPressureState;
+    private estimateEventSize;
+    private initializeMetrics;
+}
+/**
+ * Create a new BackpressureHandler instance
+ *
+ * @param config - Backpressure handler configuration
+ * @returns BackpressureHandler instance
+ *
+ * @example
+ * ```typescript
+ * const handler = createBackpressureHandler({
+ *   maxBufferSize: 100,
+ *   strategy: 'drop-non-critical',
+ *   onPressure: (metrics) => {
+ *     console.log(`Buffer: ${metrics.bufferSize}, Dropped: ${metrics.droppedCount}`);
+ *   }
+ * });
+ *
+ * // Producer emits faster than consumer
+ * const accepted = handler.push(event); // Returns false if buffer full
+ * ```
+ */
+export declare function createBackpressureHandler(config?: BackpressureHandlerConfig): BackpressureHandler;
+/**
+ * Create a backpressure-aware event consumer
+ * Automatically pulls events at a specified rate
+ */
+export declare function createBackpressureConsumer(handler: BackpressureHandler, onEvent: (event: AGUIEvent) => void | Promise<void>, options?: {
+    pullInterval?: number;
+    batchSize?: number;
+}): {
+    start: () => void;
+    stop: () => void;
+    isRunning: () => boolean;
+};
+/**
+ * Determine if an event is critical based on category
+ */
+export declare function isCriticalEventCategory(category: AGUIEventCategory): boolean;
+/**
+ * Get recommended strategy based on use case
+ */
+export declare function getRecommendedStrategy(useCase: 'realtime' | 'reliable' | 'balanced'): BackpressureStrategy;
+//# sourceMappingURL=backpressure-handler.d.ts.map

package/v3/dist/adapters/ag-ui/backpressure-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backpressure-handler.d.ts","sourceRoot":"","sources":["../../../src/adapters/ag-ui/backpressure-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAM5E;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,6CAA6C;IAC7C,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACpD,6CAA6C;IAC7C,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACnD,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,qDAAqD;IACrD,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;CAC7B;AA2CD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,aAAa,EAAE,OAAO,CAAC;IACvB,6CAA6C;IAC7C,gBAAgB,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,uBAAuB;IACvB,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAeD;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAyC;IAC7E,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAyC;IAC5E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IAErD,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,OAAO,CAAsB;gBAEzB,MAAM,GAAE,yBAA8B;IAyBlD;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IA0B/B;;;;;OAKG;IACH,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE;IAmBjC;;OAEG;IACH,OAAO,IAAI,SAAS,GAAG,SAAS;IAKhC;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAab;;OAEG;IACH,UAAU,IAAI,QAAQ,CAAC,mBAAmB,CAAC;IAU3C;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,cAAc,IAAI,IAAI;IAiBtB,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,yBAAyB;IA0CjC,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,iBAAiB;CAe1B;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,GAAE,yBAA8B,GACrC,mBAAmB,CAErB;AAMD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACnD,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL;IACD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B,CAkCA;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAE5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,oBAAoB,CAU1G"}