agentic-qe 3.3.4 → 3.4.0

package/v3/dist/adapters/a2a/tasks/task-store.d.ts

@@ -0,0 +1,251 @@
+/**
+ * A2A Task Store
+ *
+ * Provides persistence layer for A2A tasks with in-memory storage
+ * and support for context-based grouping and pagination.
+ *
+ * @module adapters/a2a/tasks/task-store
+ * @see https://a2a-protocol.org/latest/specification/
+ */
+import type { A2AMessage, TaskStatus, A2AArtifact } from '../jsonrpc/methods.js';
+/**
+ * Task history entry for state transitions
+ */
+export interface TaskHistoryEntry {
+    /** Previous status */
+    readonly fromStatus: TaskStatus | null;
+    /** New status */
+    readonly toStatus: TaskStatus;
+    /** Timestamp of transition */
+    readonly timestamp: Date;
+    /** Reason for transition (optional) */
+    readonly reason?: string;
+    /** User or system that triggered the transition */
+    readonly triggeredBy?: string;
+}
+/**
+ * Task error with detailed information
+ */
+export interface TaskError {
+    /** Error message */
+    readonly message: string;
+    /** Error code */
+    readonly code?: string;
+    /** Stack trace (for debugging) */
+    readonly stack?: string;
+    /** Timestamp when error occurred */
+    readonly timestamp?: Date;
+    /** Whether the error is retryable */
+    readonly retryable?: boolean;
+}
+/**
+ * Task metadata
+ */
+export interface TaskMetadata {
+    /** Creation timestamp */
+    readonly createdAt: Date;
+    /** Last update timestamp */
+    readonly updatedAt: Date;
+    /** Agent ID handling this task */
+    readonly agentId: string;
+    /** Parent task ID (for subtasks) */
+    readonly parentTaskId?: string;
+    /** Priority (higher = more urgent) */
+    readonly priority?: number;
+    /** Tags for categorization */
+    readonly tags?: string[];
+    /** Custom user metadata */
+    readonly custom?: Record<string, unknown>;
+}
+/**
+ * Full A2A Task structure with extended properties
+ */
+export interface A2ATask {
+    /** Unique task identifier */
+    readonly id: string;
+    /** Context ID for multi-turn conversations */
+    readonly contextId?: string;
+    /** Current task status */
+    status: TaskStatus;
+    /** Input message that created this task */
+    readonly message: A2AMessage;
+    /** Output artifacts */
+    artifacts: A2AArtifact[];
+    /** State transition history */
+    history: TaskHistoryEntry[];
+    /** Error information (when status is 'failed') */
+    error?: TaskError;
+    /** Task metadata */
+    readonly metadata: TaskMetadata;
+}
+/**
+ * Query options for listing tasks
+ */
+export interface TaskQueryOptions {
+    /** Filter by context ID */
+    readonly contextId?: string;
+    /** Filter by status(es) */
+    readonly status?: TaskStatus | TaskStatus[];
+    /** Filter by agent ID */
+    readonly agentId?: string;
+    /** Filter by parent task ID */
+    readonly parentTaskId?: string;
+    /** Maximum number of results */
+    readonly limit?: number;
+    /** Offset for pagination */
+    readonly offset?: number;
+    /** Sort order */
+    readonly order?: 'asc' | 'desc';
+    /** Sort field */
+    readonly sortBy?: 'createdAt' | 'updatedAt' | 'priority';
+    /** Include tasks created after this date */
+    readonly createdAfter?: Date;
+    /** Include tasks created before this date */
+    readonly createdBefore?: Date;
+}
+/**
+ * Paginated query result
+ */
+export interface TaskQueryResult {
+    /** List of tasks matching the query */
+    readonly tasks: A2ATask[];
+    /** Total count of matching tasks */
+    readonly total: number;
+    /** Current offset */
+    readonly offset: number;
+    /** Limit used */
+    readonly limit: number;
+    /** Whether there are more results */
+    readonly hasMore: boolean;
+    /** Next cursor for pagination */
+    readonly nextCursor?: string;
+}
+/**
+ * Task store configuration
+ */
+export interface TaskStoreConfig {
+    /** Maximum tasks to retain (0 = unlimited) */
+    readonly maxTasks?: number;
+    /** TTL for completed tasks in milliseconds (0 = no expiry) */
+    readonly completedTaskTtl?: number;
+    /** Whether to enable automatic cleanup */
+    readonly enableAutoCleanup?: boolean;
+    /** Cleanup interval in milliseconds */
+    readonly cleanupInterval?: number;
+}
+/**
+ * Default task store configuration
+ */
+export declare const DEFAULT_TASK_STORE_CONFIG: Required<TaskStoreConfig>;
+/**
+ * A2A Task Store
+ *
+ * In-memory storage for A2A tasks with query and pagination support.
+ */
+export declare class TaskStore {
+    private readonly config;
+    private readonly tasks;
+    private readonly contextIndex;
+    private readonly statusIndex;
+    private readonly agentIndex;
+    private cleanupTimer?;
+    constructor(config?: TaskStoreConfig);
+    /**
+     * Store a new task
+     */
+    create(task: A2ATask): A2ATask;
+    /**
+     * Get a task by ID
+     */
+    get(taskId: string): A2ATask | null;
+    /**
+     * Check if a task exists
+     */
+    has(taskId: string): boolean;
+    /**
+     * Update an existing task
+     */
+    update(taskId: string, updates: Partial<Pick<A2ATask, 'status' | 'artifacts' | 'history' | 'error'>>): A2ATask | null;
+    /**
+     * Delete a task
+     */
+    delete(taskId: string): boolean;
+    /**
+     * Query tasks with filtering and pagination
+     */
+    query(options?: TaskQueryOptions): TaskQueryResult;
+    /**
+     * Get tasks by context ID
+     */
+    getByContext(contextId: string): A2ATask[];
+    /**
+     * Get tasks by status
+     */
+    getByStatus(status: TaskStatus): A2ATask[];
+    /**
+     * Get tasks by agent ID
+     */
+    getByAgent(agentId: string): A2ATask[];
+    /**
+     * Get multiple tasks by IDs
+     */
+    getMany(taskIds: string[]): Map<string, A2ATask | null>;
+    /**
+     * Delete multiple tasks
+     */
+    deleteMany(taskIds: string[]): number;
+    /**
+     * Delete all tasks in a context
+     */
+    deleteByContext(contextId: string): number;
+    /**
+     * Get store statistics
+     */
+    getStats(): {
+        totalTasks: number;
+        tasksByStatus: Record<TaskStatus, number>;
+        contextCount: number;
+        agentCount: number;
+    };
+    /**
+     * Get total task count
+     */
+    get size(): number;
+    /**
+     * Clean up expired completed tasks
+     */
+    cleanupExpired(): number;
+    /**
+     * Evict oldest tasks to make room
+     */
+    private evictOldestTasks;
+    /**
+     * Start the cleanup timer
+     */
+    private startCleanupTimer;
+    /**
+     * Stop the cleanup timer
+     */
+    stopCleanupTimer(): void;
+    /**
+     * Clear all tasks and reset store
+     */
+    clear(): void;
+    /**
+     * Destroy the store and stop cleanup
+     */
+    destroy(): void;
+    /**
+     * Add a task to all indices
+     */
+    private addToIndex;
+    /**
+     * Remove a task from all indices
+     */
+    private removeFromIndex;
+}
+/**
+ * Create a new TaskStore instance
+ */
+export declare function createTaskStore(config?: TaskStoreConfig): TaskStore;
+//# sourceMappingURL=task-store.d.ts.map

package/v3/dist/adapters/a2a/tasks/task-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-store.d.ts","sourceRoot":"","sources":["../../../../src/adapters/a2a/tasks/task-store.ts"],"names":[],"mappings":"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"}