agent-relay 1.1.0 → 1.2.0

package/dist/trajectory/config.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Trajectory Configuration
+ *
+ * Handles repo-level opt-in/opt-out for trajectory storage.
+ * When trajectories are opt-out (not in source control), they're stored
+ * in the user's home directory instead of the repo.
+ *
+ * DECISIONS:
+ * 1. Default behavior: trajectories are OPT-OUT (stored outside repo)
+ *    - Reasoning: Most repos won't want trajectory files in source control
+ *    - Users must explicitly opt-in to store in repo
+ *
+ * 2. Setting location: .relay/config.json in repo root
+ *    - Reasoning: Keeps relay config separate from .claude/ which may have other uses
+ *    - Alternative considered: .claude/settings.json - rejected to avoid conflicts
+ *
+ * 3. User-level storage: ~/.config/agent-relay/trajectories/<project-hash>/
+ *    - Reasoning: XDG-compliant, project-isolated, survives repo deletion
+ */
+/**
+ * Relay config structure
+ */
+export interface RelayConfig {
+    /** Trajectory settings */
+    trajectories?: {
+        /**
+         * Whether to store trajectories in the repo (.trajectories/)
+         * Default: false (stored in ~/.config/agent-relay/trajectories/)
+         */
+        storeInRepo?: boolean;
+    };
+}
+/**
+ * Get the relay config file path
+ */
+export declare function getRelayConfigPath(projectRoot?: string): string;
+/**
+ * Read the relay config from the repo
+ */
+export declare function readRelayConfig(projectRoot?: string): RelayConfig;
+/**
+ * Check if trajectories should be stored in the repo
+ */
+export declare function shouldStoreInRepo(projectRoot?: string): boolean;
+/**
+ * Get a hash of the project path for user-level storage isolation
+ */
+export declare function getProjectHash(projectRoot?: string): string;
+/**
+ * Get the user-level trajectories directory
+ */
+export declare function getUserTrajectoriesDir(projectRoot?: string): string;
+/**
+ * Get the repo-level trajectories directory
+ */
+export declare function getRepoTrajectoriesDir(projectRoot?: string): string;
+/**
+ * Get the primary trajectories directory based on config
+ * This is where new trajectories will be written
+ */
+export declare function getPrimaryTrajectoriesDir(projectRoot?: string): string;
+/**
+ * Get all trajectories directories (for reading)
+ * Returns both repo and user-level if they exist
+ */
+export declare function getAllTrajectoriesDirs(projectRoot?: string): string[];
+/**
+ * Ensure the primary trajectories directory exists
+ */
+export declare function ensureTrajectoriesDir(projectRoot?: string): string;
+/**
+ * Get trajectory environment variables for trail CLI
+ * Sets TRAJECTORIES_DATA_DIR to the appropriate location
+ */
+export declare function getTrajectoryEnvVars(projectRoot?: string): Record<string, string>;
+/**
+ * Check if project has opted into repo-level trajectory storage
+ */
+export declare function isTrajectoryOptedIn(projectRoot?: string): boolean;
+/**
+ * Get a human-readable description of where trajectories are stored
+ */
+export declare function getTrajectoriesStorageDescription(projectRoot?: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/trajectory/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/trajectory/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,YAAY,CAAC,EAAE;QACb;;;WAGG;QACH,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;CACH;AAOD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAoCjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAI/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAInE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAcrE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAIlE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKjF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9E"}

package/dist/trajectory/config.js

@@ -0,0 +1,163 @@
+/**
+ * Trajectory Configuration
+ *
+ * Handles repo-level opt-in/opt-out for trajectory storage.
+ * When trajectories are opt-out (not in source control), they're stored
+ * in the user's home directory instead of the repo.
+ *
+ * DECISIONS:
+ * 1. Default behavior: trajectories are OPT-OUT (stored outside repo)
+ *    - Reasoning: Most repos won't want trajectory files in source control
+ *    - Users must explicitly opt-in to store in repo
+ *
+ * 2. Setting location: .relay/config.json in repo root
+ *    - Reasoning: Keeps relay config separate from .claude/ which may have other uses
+ *    - Alternative considered: .claude/settings.json - rejected to avoid conflicts
+ *
+ * 3. User-level storage: ~/.config/agent-relay/trajectories/<project-hash>/
+ *    - Reasoning: XDG-compliant, project-isolated, survives repo deletion
+ */
+import { existsSync, readFileSync, mkdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { createHash } from 'node:crypto';
+import { getProjectPaths } from '../utils/project-namespace.js';
+/**
+ * Cache for config to avoid repeated file reads
+ */
+let configCache = null;
+/**
+ * Get the relay config file path
+ */
+export function getRelayConfigPath(projectRoot) {
+    const root = projectRoot ?? getProjectPaths().projectRoot;
+    return join(root, '.relay', 'config.json');
+}
+/**
+ * Read the relay config from the repo
+ */
+export function readRelayConfig(projectRoot) {
+    const configPath = getRelayConfigPath(projectRoot);
+    // Check cache
+    if (configCache && configCache.path === configPath) {
+        try {
+            const stat = statSync(configPath);
+            if (stat.mtimeMs === configCache.mtime) {
+                return configCache.config;
+            }
+        }
+        catch {
+            // File may not exist or be readable
+        }
+    }
+    try {
+        if (!existsSync(configPath)) {
+            return {};
+        }
+        const content = readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        // Update cache
+        try {
+            const stat = statSync(configPath);
+            configCache = { path: configPath, config, mtime: stat.mtimeMs };
+        }
+        catch {
+            // Ignore cache update failures
+        }
+        return config;
+    }
+    catch (err) {
+        console.warn('[trajectory-config] Failed to read config:', err);
+        return {};
+    }
+}
+/**
+ * Check if trajectories should be stored in the repo
+ */
+export function shouldStoreInRepo(projectRoot) {
+    const config = readRelayConfig(projectRoot);
+    // Default to false - trajectories are stored outside repo by default
+    return config.trajectories?.storeInRepo === true;
+}
+/**
+ * Get a hash of the project path for user-level storage isolation
+ */
+export function getProjectHash(projectRoot) {
+    const root = projectRoot ?? getProjectPaths().projectRoot;
+    return createHash('sha256').update(root).digest('hex').slice(0, 16);
+}
+/**
+ * Get the user-level trajectories directory
+ */
+export function getUserTrajectoriesDir(projectRoot) {
+    const projectHash = getProjectHash(projectRoot);
+    const configDir = process.env.XDG_CONFIG_HOME || join(homedir(), '.config');
+    return join(configDir, 'agent-relay', 'trajectories', projectHash);
+}
+/**
+ * Get the repo-level trajectories directory
+ */
+export function getRepoTrajectoriesDir(projectRoot) {
+    const root = projectRoot ?? getProjectPaths().projectRoot;
+    return join(root, '.trajectories');
+}
+/**
+ * Get the primary trajectories directory based on config
+ * This is where new trajectories will be written
+ */
+export function getPrimaryTrajectoriesDir(projectRoot) {
+    if (shouldStoreInRepo(projectRoot)) {
+        return getRepoTrajectoriesDir(projectRoot);
+    }
+    return getUserTrajectoriesDir(projectRoot);
+}
+/**
+ * Get all trajectories directories (for reading)
+ * Returns both repo and user-level if they exist
+ */
+export function getAllTrajectoriesDirs(projectRoot) {
+    const dirs = [];
+    const repoDir = getRepoTrajectoriesDir(projectRoot);
+    if (existsSync(repoDir)) {
+        dirs.push(repoDir);
+    }
+    const userDir = getUserTrajectoriesDir(projectRoot);
+    if (existsSync(userDir)) {
+        dirs.push(userDir);
+    }
+    return dirs;
+}
+/**
+ * Ensure the primary trajectories directory exists
+ */
+export function ensureTrajectoriesDir(projectRoot) {
+    const dir = getPrimaryTrajectoriesDir(projectRoot);
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+/**
+ * Get trajectory environment variables for trail CLI
+ * Sets TRAJECTORIES_DATA_DIR to the appropriate location
+ */
+export function getTrajectoryEnvVars(projectRoot) {
+    const dataDir = getPrimaryTrajectoriesDir(projectRoot);
+    return {
+        TRAJECTORIES_DATA_DIR: dataDir,
+    };
+}
+/**
+ * Check if project has opted into repo-level trajectory storage
+ */
+export function isTrajectoryOptedIn(projectRoot) {
+    return shouldStoreInRepo(projectRoot);
+}
+/**
+ * Get a human-readable description of where trajectories are stored
+ */
+export function getTrajectoriesStorageDescription(projectRoot) {
+    if (shouldStoreInRepo(projectRoot)) {
+        return `repo (.trajectories/)`;
+    }
+    return `user (~/.config/agent-relay/trajectories/)`;
+}
+//# sourceMappingURL=config.js.map

package/dist/trajectory/config.js.map

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

package/dist/trajectory/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Trajectory Module
+ *
+ * Integrates agent-relay with the agent-trajectories package
+ * for PDERO paradigm tracking (Plan, Design, Execute, Review, Observe)
+ */
+export * from './integration.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/trajectory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trajectory/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,kBAAkB,CAAC"}

package/dist/trajectory/index.js

@@ -0,0 +1,8 @@
+/**
+ * Trajectory Module
+ *
+ * Integrates agent-relay with the agent-trajectories package
+ * for PDERO paradigm tracking (Plan, Design, Execute, Review, Observe)
+ */
+export * from './integration.js';
+//# sourceMappingURL=index.js.map

package/dist/trajectory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/trajectory/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,kBAAkB,CAAC"}

package/dist/trajectory/integration.d.ts

@@ -0,0 +1,292 @@
+/**
+ * Trajectory Integration Module
+ *
+ * Integrates with the agent-trajectories package to provide
+ * PDERO paradigm tracking within agent-relay.
+ *
+ * This module provides a bridge between agent-relay and the
+ * external `trail` CLI / agent-trajectories library.
+ *
+ * Key integration points:
+ * - Auto-starts trajectory when agent is instantiated with a task
+ * - Records all inter-agent messages
+ * - Auto-detects PDERO phase transitions from output
+ * - Provides hooks for key agent lifecycle events
+ */
+/**
+ * PDERO phases for agent work lifecycle
+ */
+export type PDEROPhase = 'plan' | 'design' | 'execute' | 'review' | 'observe';
+/**
+ * Options for starting a trajectory
+ */
+export interface StartTrajectoryOptions {
+    task: string;
+    taskId?: string;
+    source?: string;
+    agentName: string;
+    phase?: PDEROPhase;
+}
+/**
+ * Options for completing a trajectory
+ */
+export interface CompleteTrajectoryOptions {
+    summary?: string;
+    confidence?: number;
+    challenges?: string[];
+    learnings?: string[];
+}
+/**
+ * Options for recording a decision
+ */
+export interface DecisionOptions {
+    choice: string;
+    question?: string;
+    alternatives?: string[];
+    reasoning?: string;
+    confidence?: number;
+}
+/**
+ * Check if trail CLI is available
+ */
+export declare function isTrailAvailable(): Promise<boolean>;
+/**
+ * Start a new trajectory
+ */
+export declare function startTrajectory(options: StartTrajectoryOptions): Promise<{
+    success: boolean;
+    trajectoryId?: string;
+    error?: string;
+}>;
+/**
+ * Get current trajectory status
+ * Reads directly from .trajectories/index.json instead of using CLI
+ */
+export declare function getTrajectoryStatus(): Promise<{
+    active: boolean;
+    trajectoryId?: string;
+    phase?: PDEROPhase;
+    task?: string;
+}>;
+/**
+ * Transition to a new PDERO phase
+ */
+export declare function transitionPhase(phase: PDEROPhase, reason?: string, agentName?: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Record a decision
+ */
+export declare function recordDecision(options: DecisionOptions): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Record an event/observation
+ */
+export declare function recordEvent(content: string, type?: 'tool_call' | 'observation' | 'checkpoint' | 'error', agentName?: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Record a message (sent or received)
+ */
+export declare function recordMessage(direction: 'sent' | 'received', from: string, to: string, body: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Complete the current trajectory
+ */
+export declare function completeTrajectory(options?: CompleteTrajectoryOptions): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Abandon the current trajectory
+ */
+export declare function abandonTrajectory(reason?: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Trajectory step for dashboard display
+ */
+export interface TrajectoryStepData {
+    id: string;
+    timestamp: string | number;
+    type: 'tool_call' | 'decision' | 'message' | 'state_change' | 'error' | 'phase_transition';
+    phase?: PDEROPhase;
+    title: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    duration?: number;
+    status?: 'pending' | 'running' | 'success' | 'error';
+}
+/**
+ * List trajectory steps/events
+ * Returns steps for the current or specified trajectory
+ * Reads directly from filesystem instead of using CLI
+ */
+export declare function listTrajectorySteps(trajectoryId?: string): Promise<{
+    success: boolean;
+    steps: TrajectoryStepData[];
+    error?: string;
+}>;
+/**
+ * Trajectory history entry for dashboard display
+ */
+export interface TrajectoryHistoryEntry {
+    id: string;
+    title: string;
+    status: 'active' | 'completed' | 'abandoned';
+    startedAt: string;
+    completedAt?: string;
+    agents?: string[];
+    summary?: string;
+    confidence?: number;
+}
+/**
+ * Get trajectory history - list all trajectories
+ * Reads directly from filesystem
+ */
+export declare function getTrajectoryHistory(): Promise<{
+    success: boolean;
+    trajectories: TrajectoryHistoryEntry[];
+    error?: string;
+}>;
+/**
+ * Detect PDERO phase from content
+ */
+export declare function detectPhaseFromContent(content: string): PDEROPhase | undefined;
+/**
+ * Detected tool call information
+ */
+export interface DetectedToolCall {
+    tool: string;
+    args?: string;
+    status?: 'started' | 'completed' | 'failed';
+}
+/**
+ * Detected error information
+ */
+export interface DetectedError {
+    type: 'error' | 'warning' | 'failure';
+    message: string;
+    stack?: string;
+}
+/**
+ * Detect tool calls from agent output
+ *
+ * @example
+ * ```typescript
+ * const tools = detectToolCalls(output);
+ * // Returns: [{ tool: 'Read', args: 'file.ts' }, { tool: 'Bash', status: 'completed' }]
+ * ```
+ */
+export declare function detectToolCalls(content: string): DetectedToolCall[];
+/**
+ * Detect errors from agent output
+ *
+ * @example
+ * ```typescript
+ * const errors = detectErrors(output);
+ * // Returns: [{ type: 'error', message: 'TypeError: Cannot read property...' }]
+ * ```
+ */
+export declare function detectErrors(content: string): DetectedError[];
+/**
+ * TrajectoryIntegration class for managing trajectory state
+ *
+ * This class enforces trajectory tracking during agent lifecycle:
+ * - Auto-starts trajectory when agent is instantiated with a task
+ * - Records all inter-agent messages
+ * - Auto-detects PDERO phase transitions
+ * - Provides lifecycle hooks for tmux/pty wrappers
+ */
+export declare class TrajectoryIntegration {
+    private projectId;
+    private agentName;
+    private trailAvailable;
+    private currentPhase;
+    private trajectoryId;
+    private initialized;
+    private task;
+    constructor(projectId: string, agentName: string);
+    /**
+     * Check if trail is available (cached)
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Check if trail CLI is installed synchronously
+     */
+    isTrailInstalledSync(): boolean;
+    /**
+     * Initialize trajectory tracking for agent lifecycle
+     * Called automatically when agent starts with a task
+     */
+    initialize(task?: string, taskId?: string, source?: string): Promise<boolean>;
+    /**
+     * Start tracking a trajectory
+     */
+    start(task: string, taskId?: string, source?: string): Promise<boolean>;
+    /**
+     * Check if there's an active trajectory
+     */
+    hasActiveTrajectory(): boolean;
+    /**
+     * Get the current task
+     */
+    getTask(): string | null;
+    /**
+     * Get trajectory ID
+     */
+    getTrajectoryId(): string | null;
+    /**
+     * Record a message
+     */
+    message(direction: 'sent' | 'received', from: string, to: string, body: string): Promise<void>;
+    /**
+     * Transition to a new phase
+     */
+    transition(phase: PDEROPhase, reason?: string): Promise<boolean>;
+    /**
+     * Record a decision
+     */
+    decision(choice: string, options?: Partial<DecisionOptions>): Promise<boolean>;
+    /**
+     * Record an event
+     */
+    event(content: string, type?: 'tool_call' | 'observation' | 'checkpoint' | 'error'): Promise<boolean>;
+    /**
+     * Complete the trajectory
+     */
+    complete(options?: CompleteTrajectoryOptions): Promise<boolean>;
+    /**
+     * Abandon the trajectory
+     */
+    abandon(reason?: string): Promise<boolean>;
+    /**
+     * Get current phase
+     */
+    getPhase(): PDEROPhase | null;
+}
+/**
+ * Get or create a TrajectoryIntegration instance
+ */
+export declare function getTrajectoryIntegration(projectId: string, agentName: string): TrajectoryIntegration;
+/**
+ * Generate trail usage instructions for agents
+ */
+export declare function getTrailInstructions(): string[];
+/**
+ * Get a compact trail instruction string for injection
+ */
+export declare function getCompactTrailInstructions(): string;
+/**
+ * Get environment variables for trail CLI
+ * If dataDir is not provided, uses config-based storage location
+ */
+export declare function getTrailEnvVars(projectId: string, agentName: string, dataDir?: string): Record<string, string>;
+//# sourceMappingURL=integration.d.ts.map

package/dist/trajectory/integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../src/trajectory/integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA4IH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA0CD;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAGzD;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAuB3I;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAqClI;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAY3I;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB5G;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,WAAW,GAAG,aAAa,GAAG,YAAY,GAAG,OAAuB,EAC1E,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAS/C;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,GAAG,UAAU,EAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAG/C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB/H;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAStG;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,GAAG,kBAAkB,CAAC;IAC3F,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;CACtD;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxE,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAqDD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,sBAAsB,EAAE,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAsCD;AAsDD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAoB9E;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4DD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CA2BnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAqC7D;AAED;;;;;;;;GAQG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,IAAI,CAAuB;gBAEvB,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAKhD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAOrC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAS/B;;;OAGG;IACG,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBnF;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB7E;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;OAEG;IACH,OAAO,IAAI,MAAM,GAAG,IAAI;IAIxB;;OAEG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpG;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWtE;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAUpF;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,WAAW,GAAG,aAAa,GAAG,YAAY,GAAG,OAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;IAc1H;;OAEG;IACG,QAAQ,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC;IAUrE;;OAEG;IACG,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUhD;;OAEG;IACH,QAAQ,IAAI,UAAU,GAAG,IAAI;CAG9B;AAOD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,qBAAqB,CAQpG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAgC/C;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAMpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU9G"}