@exaudeus/workrail 0.0.17 → 0.0.18

package/dist/types/session-types.d.ts

@@ -1,354 +0,0 @@
-import { ConditionContext } from '../utils/condition-evaluator';
-/**
- * Represents a unique session for workflow execution.
- * Sessions maintain state across multiple tool calls, enabling stateful workflows.
- */
-export interface SessionState {
-    /** Cryptographically secure session identifier */
-    sessionId: string;
-    /** ID of the workflow being executed */
-    workflowId: string;
-    /** Array of completed step IDs in execution order */
-    completedSteps: string[];
-    /** Context variables for workflow step conditions and state */
-    context: ConditionContext;
-    /** Timestamp when session was created */
-    createdAt: Date;
-    /** Timestamp of last activity (tool call) */
-    lastActivity: Date;
-    /** Current storage tier for tiered cleanup */
-    tier: SessionTier;
-    /** Total number of tool calls made in this session */
-    accessCount: number;
-    /** Total milliseconds spent in inactive state */
-    hibernationTime: number;
-    /** Client-provided hints for session lifecycle management */
-    hints: SessionHints;
-    /** Session metadata for monitoring and analytics */
-    metadata: SessionMetadata;
-}
-/**
- * Storage tiers for session lifecycle management.
- * Sessions migrate through tiers based on activity patterns.
- */
-export type SessionTier = 'memory' | 'disk' | 'archive';
-/**
- * Client-provided hints for session management.
- * Helps optimize cleanup policies and resource allocation.
- */
-export interface SessionHints {
-    /** Expected session duration in milliseconds */
-    expectedDuration?: number;
-    /** Session importance level affects cleanup priority */
-    importance: SessionImportance;
-    /** Whether client expects to pause/resume this session */
-    pauseExpected?: boolean;
-    /** Type of client for different cleanup strategies */
-    clientType: SessionClientType;
-    /** Human-readable description of session purpose */
-    description?: string;
-}
-export type SessionImportance = 'low' | 'medium' | 'high' | 'critical';
-export type SessionClientType = 'human' | 'agent' | 'scheduled' | 'test';
-/**
- * Session metadata for monitoring and analytics.
- */
-export interface SessionMetadata {
-    /** Current workflow progress (0-100) */
-    progress: number;
-    /** Estimated time remaining in milliseconds */
-    estimatedTimeRemaining?: number;
-    /** Recent activity frequency (calls per hour) */
-    activityFrequency: number;
-    /** Session size in bytes for memory management */
-    memoryFootprint: number;
-    /** Number of validation errors encountered */
-    validationErrors: number;
-    /** Custom labels for session categorization */
-    labels: Record<string, string>;
-}
-/**
- * Result of session creation.
- */
-export interface SessionStartResult {
-    /** Created session ID */
-    sessionId: string;
-    /** First step of the workflow */
-    step: {
-        id: string;
-        title: string;
-        prompt: string;
-        agentRole?: string;
-        guidance?: string[];
-    } | null;
-    /** Workflow guidance for first step */
-    guidance: {
-        prompt: string;
-    };
-    /** Whether workflow is complete (empty workflow) */
-    isComplete: boolean;
-    /** Session configuration used */
-    config: SessionConfig;
-}
-/**
- * Session activity tracking for cleanup decisions.
- */
-export interface SessionActivity {
-    /** Most recent activity timestamp */
-    recentActivity: Date;
-    /** Activity frequency in calls per hour */
-    activityFrequency: number;
-    /** Workflow completion percentage */
-    workflowProgress: number;
-    /** Client type for different cleanup strategies */
-    clientType: SessionClientType;
-    /** Session importance level */
-    importance: SessionImportance;
-    /** Whether session is expected to be paused */
-    pauseExpected: boolean;
-}
-/**
- * Result of session validation operations.
- */
-export interface SessionValidationResult {
-    /** Whether validation passed */
-    valid: boolean;
-    /** Array of validation issues */
-    issues: string[];
-    /** Array of suggestions for fixing issues */
-    suggestions: string[];
-    /** Validation warnings that don't prevent operation */
-    warnings: string[];
-}
-/**
- * Parameters for session update operations.
- */
-export interface SessionUpdateParams {
-    /** New completed steps to add */
-    completedSteps?: string[];
-    /** Context updates to apply */
-    context?: Partial<ConditionContext>;
-    /** Update session hints */
-    hints?: Partial<SessionHints>;
-    /** Update session metadata */
-    metadata?: Partial<SessionMetadata>;
-}
-/**
- * Configuration for session management system.
- */
-export interface SessionConfig {
-    /** Memory tier cleanup policy */
-    memoryTTL: number;
-    /** Disk tier cleanup policy */
-    diskTTL: number;
-    /** Archive tier cleanup policy */
-    archiveTTL: number;
-    /** Maximum sessions allowed in memory */
-    maxMemorySessions: number;
-    /** Maximum sessions allowed on disk */
-    maxDiskSessions: number;
-    /** Cleanup task interval in milliseconds */
-    cleanupInterval: number;
-    /** Whether to enable adaptive cleanup policies */
-    adaptiveCleanup: boolean;
-    /** Security settings for session ID generation */
-    security: SessionSecurityConfig;
-}
-/**
- * Security configuration for session management.
- */
-export interface SessionSecurityConfig {
-    /** Length of session ID in bytes */
-    sessionIdLength: number;
-    /** Whether to use cryptographically secure random generation */
-    useSecureRandom: boolean;
-    /** Whether to hash session IDs in logs */
-    hashSessionIds: boolean;
-    /** Maximum session context size in bytes */
-    maxContextSize: number;
-    /** Whether to validate session context values */
-    validateContext: boolean;
-}
-/**
- * Cleanup policy for different session types.
- */
-export interface SessionCleanupPolicy {
-    /** Base TTL for memory tier */
-    memoryTTL: number;
-    /** Base TTL for disk tier */
-    diskTTL: number;
-    /** Base TTL for archive tier */
-    archiveTTL: number;
-    /** Multiplier for high importance sessions */
-    importanceMultiplier: Record<SessionImportance, number>;
-    /** Multiplier for different client types */
-    clientTypeMultiplier: Record<SessionClientType, number>;
-    /** Whether to extend TTL for near-complete workflows */
-    extendForProgress: boolean;
-}
-/**
- * Interface for session storage backends.
- * Supports tiered storage with memory, disk, and archive layers.
- */
-export interface ISessionStorage {
-    /**
-     * Create a new session with the given state.
-     */
-    createSession(sessionState: SessionState): Promise<void>;
-    /**
-     * Retrieve a session by ID, checking all tiers.
-     */
-    getSession(sessionId: string): Promise<SessionState | null>;
-    /**
-     * Update an existing session with partial state.
-     */
-    updateSession(sessionId: string, updates: SessionUpdateParams): Promise<void>;
-    /**
-     * Delete a session from all tiers.
-     */
-    deleteSession(sessionId: string): Promise<void>;
-    /**
-     * List all sessions in a specific tier.
-     */
-    listSessions(tier?: SessionTier): Promise<SessionState[]>;
-    /**
-     * Move a session to a different tier.
-     */
-    migrateSession(sessionId: string, targetTier: SessionTier): Promise<void>;
-    /**
-     * Clean up expired sessions based on policy.
-     */
-    cleanupExpiredSessions(policy: SessionCleanupPolicy): Promise<SessionCleanupResult>;
-    /**
-     * Get storage statistics for monitoring.
-     */
-    getStorageStats(): Promise<SessionStorageStats>;
-}
-/**
- * Result of session cleanup operations.
- */
-export interface SessionCleanupResult {
-    /** Number of sessions cleaned up */
-    sessionsRemoved: number;
-    /** Number of sessions migrated to disk */
-    sessionsMigratedToDisk: number;
-    /** Number of sessions migrated to archive */
-    sessionsMigratedToArchive: number;
-    /** Memory freed in bytes */
-    memoryFreed: number;
-    /** Cleanup duration in milliseconds */
-    duration: number;
-    /** Any errors encountered during cleanup */
-    errors: string[];
-}
-/**
- * Storage statistics for monitoring.
- */
-export interface SessionStorageStats {
-    /** Sessions in each tier */
-    sessionsByTier: Record<SessionTier, number>;
-    /** Total memory usage in bytes */
-    memoryUsage: number;
-    /** Total disk usage in bytes */
-    diskUsage: number;
-    /** Average session size in bytes */
-    averageSessionSize: number;
-    /** Sessions by importance level */
-    sessionsByImportance: Record<SessionImportance, number>;
-    /** Sessions by client type */
-    sessionsByClientType: Record<SessionClientType, number>;
-    /** Last cleanup timestamp */
-    lastCleanup: Date;
-}
-/**
- * Interface for session management service.
- * Provides high-level operations for session lifecycle management.
- */
-export interface SessionService {
-    /**
-     * Create a new session for the given workflow.
-     */
-    createSession(workflowId: string, hints?: SessionHints): Promise<SessionStartResult>;
-    /**
-     * Retrieve a session by ID.
-     */
-    getSession(sessionId: string): Promise<SessionState | null>;
-    /**
-     * Update session state after a workflow step.
-     */
-    updateSession(sessionId: string, updates: SessionUpdateParams): Promise<void>;
-    /**
-     * Validate session update parameters.
-     */
-    validateSessionUpdate(sessionId: string, updates: SessionUpdateParams): Promise<SessionValidationResult>;
-    /**
-     * Delete a session.
-     */
-    deleteSession(sessionId: string): Promise<void>;
-    /**
-     * List active sessions with optional filtering.
-     */
-    listSessions(filter?: SessionFilter): Promise<SessionState[]>;
-    /**
-     * Calculate TTL for a session based on activity.
-     */
-    calculateSessionTTL(activity: SessionActivity): number;
-    /**
-     * Perform cleanup of expired sessions.
-     */
-    cleanupSessions(): Promise<SessionCleanupResult>;
-    /**
-     * Get session service statistics.
-     */
-    getStats(): Promise<SessionStorageStats>;
-}
-/**
- * Filter options for listing sessions.
- */
-export interface SessionFilter {
-    /** Filter by workflow ID */
-    workflowId?: string;
-    /** Filter by client type */
-    clientType?: SessionClientType;
-    /** Filter by importance level */
-    importance?: SessionImportance;
-    /** Filter by storage tier */
-    tier?: SessionTier;
-    /** Filter by minimum last activity */
-    minLastActivity?: Date;
-    /** Filter by maximum last activity */
-    maxLastActivity?: Date;
-}
-/**
- * Session-related error types.
- */
-export declare class SessionError extends Error {
-    readonly code: SessionErrorCode;
-    readonly sessionId?: string | undefined;
-    readonly details?: Record<string, any> | undefined;
-    constructor(message: string, code: SessionErrorCode, sessionId?: string | undefined, details?: Record<string, any> | undefined);
-}
-export declare enum SessionErrorCode {
-    SESSION_NOT_FOUND = "SESSION_NOT_FOUND",
-    SESSION_EXPIRED = "SESSION_EXPIRED",
-    INVALID_SESSION_ID = "INVALID_SESSION_ID",
-    SESSION_ALREADY_EXISTS = "SESSION_ALREADY_EXISTS",
-    INVALID_UPDATE = "INVALID_UPDATE",
-    STORAGE_ERROR = "STORAGE_ERROR",
-    VALIDATION_ERROR = "VALIDATION_ERROR",
-    RESOURCE_EXHAUSTED = "RESOURCE_EXHAUSTED",
-    SECURITY_ERROR = "SECURITY_ERROR"
-}
-/**
- * Default session configuration.
- */
-export declare const DEFAULT_SESSION_CONFIG: SessionConfig;
-/**
- * Default cleanup policy.
- */
-export declare const DEFAULT_CLEANUP_POLICY: SessionCleanupPolicy;
-/**
- * Default session hints.
- */
-export declare const DEFAULT_SESSION_HINTS: SessionHints;
-//# sourceMappingURL=session-types.d.ts.map

package/dist/types/session-types.d.ts.map

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

package/dist/types/session-types.js

@@ -1,89 +0,0 @@
-"use strict";
-// =============================================================================
-// SESSION MANAGEMENT TYPES
-// =============================================================================
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_SESSION_HINTS = exports.DEFAULT_CLEANUP_POLICY = exports.DEFAULT_SESSION_CONFIG = exports.SessionErrorCode = exports.SessionError = void 0;
-// =============================================================================
-// SESSION ERROR TYPES
-// =============================================================================
-/**
- * Session-related error types.
- */
-class SessionError extends Error {
-    code;
-    sessionId;
-    details;
-    constructor(message, code, sessionId, details) {
-        super(message);
-        this.code = code;
-        this.sessionId = sessionId;
-        this.details = details;
-        this.name = 'SessionError';
-    }
-}
-exports.SessionError = SessionError;
-var SessionErrorCode;
-(function (SessionErrorCode) {
-    SessionErrorCode["SESSION_NOT_FOUND"] = "SESSION_NOT_FOUND";
-    SessionErrorCode["SESSION_EXPIRED"] = "SESSION_EXPIRED";
-    SessionErrorCode["INVALID_SESSION_ID"] = "INVALID_SESSION_ID";
-    SessionErrorCode["SESSION_ALREADY_EXISTS"] = "SESSION_ALREADY_EXISTS";
-    SessionErrorCode["INVALID_UPDATE"] = "INVALID_UPDATE";
-    SessionErrorCode["STORAGE_ERROR"] = "STORAGE_ERROR";
-    SessionErrorCode["VALIDATION_ERROR"] = "VALIDATION_ERROR";
-    SessionErrorCode["RESOURCE_EXHAUSTED"] = "RESOURCE_EXHAUSTED";
-    SessionErrorCode["SECURITY_ERROR"] = "SECURITY_ERROR";
-})(SessionErrorCode || (exports.SessionErrorCode = SessionErrorCode = {}));
-// =============================================================================
-// DEFAULT CONFIGURATIONS
-// =============================================================================
-/**
- * Default session configuration.
- */
-exports.DEFAULT_SESSION_CONFIG = {
-    memoryTTL: 2 * 60 * 60 * 1000, // 2 hours
-    diskTTL: 24 * 60 * 60 * 1000, // 24 hours
-    archiveTTL: 7 * 24 * 60 * 60 * 1000, // 7 days
-    maxMemorySessions: 1000,
-    maxDiskSessions: 10000,
-    cleanupInterval: 15 * 60 * 1000, // 15 minutes
-    adaptiveCleanup: true,
-    security: {
-        sessionIdLength: 32,
-        useSecureRandom: true,
-        hashSessionIds: true,
-        maxContextSize: 1024 * 1024, // 1MB
-        validateContext: true
-    }
-};
-/**
- * Default cleanup policy.
- */
-exports.DEFAULT_CLEANUP_POLICY = {
-    memoryTTL: 2 * 60 * 60 * 1000, // 2 hours
-    diskTTL: 24 * 60 * 60 * 1000, // 24 hours
-    archiveTTL: 7 * 24 * 60 * 60 * 1000, // 7 days
-    importanceMultiplier: {
-        low: 0.5,
-        medium: 1.0,
-        high: 2.0,
-        critical: 4.0
-    },
-    clientTypeMultiplier: {
-        human: 1.0,
-        agent: 1.5,
-        scheduled: 2.0,
-        test: 0.1
-    },
-    extendForProgress: true
-};
-/**
- * Default session hints.
- */
-exports.DEFAULT_SESSION_HINTS = {
-    importance: 'medium',
-    pauseExpected: false,
-    clientType: 'human'
-};
-//# sourceMappingURL=session-types.js.map

package/dist/types/session-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-types.js","sourceRoot":"","sources":["../../src/types/session-types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;;;AA8bhF,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IAGnB;IACA;IACA;IAJlB,YACE,OAAe,EACC,IAAsB,EACtB,SAAkB,EAClB,OAA6B;QAE7C,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAkB;QACtB,cAAS,GAAT,SAAS,CAAS;QAClB,YAAO,GAAP,OAAO,CAAsB;QAG7C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAVD,oCAUC;AAED,IAAY,gBAUX;AAVD,WAAY,gBAAgB;IAC1B,2DAAuC,CAAA;IACvC,uDAAmC,CAAA;IACnC,6DAAyC,CAAA;IACzC,qEAAiD,CAAA;IACjD,qDAAiC,CAAA;IACjC,mDAA+B,CAAA;IAC/B,yDAAqC,CAAA;IACrC,6DAAyC,CAAA;IACzC,qDAAiC,CAAA;AACnC,CAAC,EAVW,gBAAgB,gCAAhB,gBAAgB,QAU3B;AAED,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;GAEG;AACU,QAAA,sBAAsB,GAAkB;IACnD,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,UAAU;IACzC,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW;IACzC,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;IAC9C,iBAAiB,EAAE,IAAI;IACvB,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;IAC9C,eAAe,EAAE,IAAI;IACrB,QAAQ,EAAE;QACR,eAAe,EAAE,EAAE;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM;QACnC,eAAe,EAAE,IAAI;KACtB;CACF,CAAC;AAEF;;GAEG;AACU,QAAA,sBAAsB,GAAyB;IAC1D,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,UAAU;IACzC,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW;IACzC,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;IAC9C,oBAAoB,EAAE;QACpB,GAAG,EAAE,GAAG;QACR,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,GAAG;KACd;IACD,oBAAoB,EAAE;QACpB,KAAK,EAAE,GAAG;QACV,KAAK,EAAE,GAAG;QACV,SAAS,EAAE,GAAG;QACd,IAAI,EAAE,GAAG;KACV;IACD,iBAAiB,EAAE,IAAI;CACxB,CAAC;AAEF;;GAEG;AACU,QAAA,qBAAqB,GAAiB;IACjD,UAAU,EAAE,QAAQ;IACpB,aAAa,EAAE,KAAK;IACpB,UAAU,EAAE,OAAO;CACpB,CAAC"}

package/workflows/example-agent-role-workflow.json

@@ -1,83 +0,0 @@
-{
-  "id": "example-agent-role-workflow",
-  "name": "Example Agent Role Workflow",
-  "description": "Demonstrates agentRole functionality with a practical code review workflow",
-  "version": "1.0.0",
-  "preconditions": [
-    "Code changes are ready for review",
-    "All tests are passing"
-  ],
-  "clarificationPrompts": [
-    "What type of code review is needed? (security, performance, style, functionality)",
-    "Are there specific areas of concern?"
-  ],
-  "steps": [
-    {
-      "id": "initial-analysis",
-      "title": "Initial Code Analysis",
-      "prompt": "Please provide the code you'd like reviewed. Include any specific areas of concern or the type of review needed.",
-      "agentRole": "You are an expert code reviewer with 10+ years of experience. Focus on identifying potential issues, security vulnerabilities, and opportunities for improvement. Be thorough but constructive in your feedback.",
-      "guidance": [
-        "Ask for the code to be reviewed",
-        "Clarify the type of review needed",
-        "Note any specific concerns mentioned"
-      ],
-      "askForFiles": true,
-      "requireConfirmation": false
-    },
-    {
-      "id": "security-review",
-      "title": "Security Analysis",
-      "prompt": "Based on the code provided, perform a comprehensive security review.",
-      "agentRole": "You are a cybersecurity expert specializing in code security. Look for common vulnerabilities like SQL injection, XSS, authentication bypasses, data exposure, and insecure dependencies. Provide specific remediation steps for any issues found.",
-      "guidance": [
-        "Check for common security vulnerabilities",
-        "Review authentication and authorization logic",
-        "Examine data handling and validation",
-        "Look for potential injection attacks"
-      ]
-    },
-    {
-      "id": "performance-review",
-      "title": "Performance Analysis",
-      "prompt": "Analyze the code for performance issues and optimization opportunities.",
-      "agentRole": "You are a performance optimization specialist. Focus on algorithmic complexity, memory usage, database queries, caching opportunities, and scalability concerns. Suggest specific optimizations with measurable impact.",
-      "guidance": [
-        "Analyze algorithmic complexity",
-        "Review database query efficiency",
-        "Check for memory leaks or excessive allocations",
-        "Identify caching opportunities"
-      ]
-    },
-    {
-      "id": "code-quality-review",
-      "title": "Code Quality & Style Review",
-      "prompt": "Review the code for quality, maintainability, and adherence to best practices.",
-      "agentRole": "You are a senior software architect focused on code quality and maintainability. Evaluate code structure, naming conventions, documentation, error handling, and adherence to SOLID principles. Suggest improvements that enhance readability and maintainability.",
-      "guidance": [
-        "Check naming conventions and clarity",
-        "Review code structure and organization",
-        "Evaluate error handling patterns",
-        "Assess documentation quality"
-      ]
-    },
-    {
-      "id": "final-recommendations",
-      "title": "Final Recommendations",
-      "prompt": "Provide a summary of findings and prioritized recommendations for improvement.",
-      "agentRole": "You are a technical lead providing final recommendations. Synthesize all previous findings into actionable priorities. Categorize issues by severity (critical, high, medium, low) and provide a clear action plan with estimated effort for each recommendation.",
-      "guidance": [
-        "Summarize all findings from previous steps",
-        "Prioritize issues by severity and impact",
-        "Provide clear action items",
-        "Estimate effort for each recommendation"
-      ],
-      "requireConfirmation": true
-    }
-  ],
-  "metaGuidance": [
-    "This workflow demonstrates how agentRole separates behavioral instructions from user-facing prompts",
-    "Each step has specific agent expertise while maintaining clear user communication",
-    "The agentRole field guides the AI's approach without cluttering the user interface"
-  ]
-}