digital-workers 2.1.1 → 2.3.0

package/dist/capability-tiers.d.ts

@@ -0,0 +1,230 @@
+/**
+ * Capability Tiers
+ *
+ * Agent capability tiers with complexity levels and toolsets.
+ * Follows the cascade pattern: code < generative < agentic < human
+ *
+ * ## Tier Hierarchy
+ *
+ * 1. **Code** (complexity 1-2): Deterministic, pure functions
+ *    - Tools: calculate, lookup, validate, transform
+ *    - No AI, predictable outputs
+ *
+ * 2. **Generative** (complexity 3-5): LLM-powered generation
+ *    - Tools: generate, summarize, analyze, classify
+ *    - Uses AI but no autonomous actions
+ *
+ * 3. **Agentic** (complexity 6-8): Autonomous AI agents
+ *    - Tools: browse, execute, plan, delegate
+ *    - Can take actions, make decisions
+ *
+ * 4. **Human** (complexity 9-10): Human-in-the-loop
+ *    - Tools: approve, review, decide, escalate
+ *    - Requires human judgment
+ *
+ * @packageDocumentation
+ */
+/**
+ * Capability tier levels following cascade pattern
+ */
+export type CapabilityTier = 'code' | 'generative' | 'agentic' | 'human';
+/**
+ * Task complexity rating (1-10 scale)
+ */
+export type TaskComplexity = number;
+/**
+ * Capability profile defining an agent's abilities
+ */
+export interface CapabilityProfile {
+    /** Unique profile name */
+    name: string;
+    /** Tier level */
+    tier: CapabilityTier;
+    /** Complexity rating this profile can handle (1-10) */
+    complexityRating: number;
+    /** Available tools for this profile */
+    tools: string[];
+    /** Optional description */
+    description?: string;
+    /** Optional constraints */
+    constraints?: ProfileConstraints;
+}
+/**
+ * Profile constraints
+ */
+export interface ProfileConstraints {
+    maxTokens?: number;
+    allowedDomains?: string[];
+    requiresApproval?: boolean;
+    timeout?: number;
+    maxRetries?: number;
+}
+/**
+ * Tier configuration
+ */
+export interface TierConfig {
+    tier: CapabilityTier;
+    minComplexity: number;
+    maxComplexity: number;
+    description: string;
+    allowedTools: string[];
+    defaultTimeout: number;
+}
+/**
+ * Toolset for a tier
+ */
+export interface TierToolset {
+    tier: CapabilityTier;
+    tools: string[];
+    includesLowerTiers: boolean;
+}
+/**
+ * Result of matching a tier to complexity
+ */
+export interface TierMatchResult {
+    tier: CapabilityTier;
+    confidence: number;
+    suggestedTools: string[];
+}
+/**
+ * Tier escalation request
+ */
+export interface TierEscalation {
+    fromTier: CapabilityTier;
+    toTier: CapabilityTier;
+    reason: string;
+    skipJustification?: string;
+    allowDeescalation?: boolean;
+}
+/**
+ * Escalation validation result
+ */
+export interface EscalationValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * All capability tiers in order
+ */
+export declare const CAPABILITY_TIERS: readonly CapabilityTier[];
+/**
+ * Tier order for comparison
+ */
+export declare const TIER_ORDER: Record<CapabilityTier, number>;
+/**
+ * Compare two tiers
+ * @returns negative if a < b, positive if a > b, 0 if equal
+ */
+export declare function compareTiers(a: CapabilityTier, b: CapabilityTier): number;
+/**
+ * Check if tier A is higher than tier B
+ */
+export declare function isHigherTier(a: CapabilityTier, b: CapabilityTier): boolean;
+/**
+ * Check if tier A is lower than tier B
+ */
+export declare function isLowerTier(a: CapabilityTier, b: CapabilityTier): boolean;
+/**
+ * Get the next tier in escalation order
+ * @returns next tier or null if at highest tier
+ */
+export declare function getNextTier(tier: CapabilityTier): CapabilityTier | null;
+/**
+ * Get the previous tier in de-escalation order
+ * @returns previous tier or null if at lowest tier
+ */
+export declare function getPreviousTier(tier: CapabilityTier): CapabilityTier | null;
+/**
+ * Get configuration for a tier
+ */
+export declare function getTierConfig(tier: CapabilityTier): TierConfig;
+/**
+ * Get tools available for a tier (includes inherited tools from lower tiers)
+ */
+export declare function getToolsForTier(tier: CapabilityTier): string[];
+/**
+ * Match a complexity rating to the appropriate tier
+ */
+export declare function matchTierToComplexity(complexity: TaskComplexity): TierMatchResult;
+/**
+ * Check if a tier can execute a task of given complexity
+ */
+export declare function canExecuteAtTier(tier: CapabilityTier, complexity: TaskComplexity): boolean;
+/**
+ * Validate a tier escalation request
+ */
+export declare function validateTierEscalation(escalation: TierEscalation): EscalationValidationResult;
+/**
+ * Create a capability profile with validation
+ */
+export declare function createCapabilityProfile(input: {
+    name: string;
+    tier: CapabilityTier;
+    complexityRating: number;
+    tools: string[];
+    description?: string;
+    constraints?: ProfileConstraints;
+}): CapabilityProfile;
+/**
+ * Registry for managing capability profiles
+ */
+export declare class TierRegistry {
+    private profiles;
+    /**
+     * Register a capability profile
+     */
+    register(input: {
+        name: string;
+        tier: CapabilityTier;
+        complexityRating: number;
+        tools: string[];
+        description?: string;
+        constraints?: ProfileConstraints;
+    }): void;
+    /**
+     * Get a profile by name
+     */
+    get(name: string): CapabilityProfile | undefined;
+    /**
+     * Unregister a profile
+     */
+    unregister(name: string): boolean;
+    /**
+     * List all profiles for a tier
+     */
+    listByTier(tier: CapabilityTier): CapabilityProfile[];
+    /**
+     * Find profiles that can handle a given complexity
+     */
+    findByComplexity(complexity: TaskComplexity): CapabilityProfile[];
+    /**
+     * Find profiles with the required tools
+     */
+    findByTools(requiredTools: string[]): CapabilityProfile[];
+    /**
+     * List all registered profiles
+     */
+    listAll(): CapabilityProfile[];
+    /**
+     * Clear all profiles
+     */
+    clear(): void;
+}
+declare const _default: {
+    CAPABILITY_TIERS: readonly CapabilityTier[];
+    TIER_ORDER: Record<CapabilityTier, number>;
+    compareTiers: typeof compareTiers;
+    isHigherTier: typeof isHigherTier;
+    isLowerTier: typeof isLowerTier;
+    getNextTier: typeof getNextTier;
+    getPreviousTier: typeof getPreviousTier;
+    getTierConfig: typeof getTierConfig;
+    getToolsForTier: typeof getToolsForTier;
+    matchTierToComplexity: typeof matchTierToComplexity;
+    canExecuteAtTier: typeof canExecuteAtTier;
+    validateTierEscalation: typeof validateTierEscalation;
+    createCapabilityProfile: typeof createCapabilityProfile;
+    TierRegistry: typeof TierRegistry;
+};
+export default _default;
+//# sourceMappingURL=capability-tiers.d.ts.map

package/dist/capability-tiers.d.ts.map

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

package/dist/capability-tiers.js

@@ -0,0 +1,388 @@
+/**
+ * Capability Tiers
+ *
+ * Agent capability tiers with complexity levels and toolsets.
+ * Follows the cascade pattern: code < generative < agentic < human
+ *
+ * ## Tier Hierarchy
+ *
+ * 1. **Code** (complexity 1-2): Deterministic, pure functions
+ *    - Tools: calculate, lookup, validate, transform
+ *    - No AI, predictable outputs
+ *
+ * 2. **Generative** (complexity 3-5): LLM-powered generation
+ *    - Tools: generate, summarize, analyze, classify
+ *    - Uses AI but no autonomous actions
+ *
+ * 3. **Agentic** (complexity 6-8): Autonomous AI agents
+ *    - Tools: browse, execute, plan, delegate
+ *    - Can take actions, make decisions
+ *
+ * 4. **Human** (complexity 9-10): Human-in-the-loop
+ *    - Tools: approve, review, decide, escalate
+ *    - Requires human judgment
+ *
+ * @packageDocumentation
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * All capability tiers in order
+ */
+export const CAPABILITY_TIERS = [
+    'code',
+    'generative',
+    'agentic',
+    'human',
+];
+/**
+ * Tier order for comparison
+ */
+export const TIER_ORDER = {
+    code: 0,
+    generative: 1,
+    agentic: 2,
+    human: 3,
+};
+/**
+ * Tools specific to each tier (not including inherited tools)
+ */
+const TIER_SPECIFIC_TOOLS = {
+    code: ['calculate', 'lookup', 'validate', 'transform'],
+    generative: ['generate', 'summarize', 'analyze', 'classify'],
+    agentic: ['browse', 'execute', 'plan', 'delegate'],
+    human: ['approve', 'review', 'decide', 'escalate'],
+};
+/**
+ * Tier configurations
+ */
+const TIER_CONFIGS = {
+    code: {
+        tier: 'code',
+        minComplexity: 1,
+        maxComplexity: 2,
+        description: 'Deterministic code execution with predictable outputs',
+        allowedTools: TIER_SPECIFIC_TOOLS.code,
+        defaultTimeout: 5000, // 5 seconds
+    },
+    generative: {
+        tier: 'generative',
+        minComplexity: 3,
+        maxComplexity: 5,
+        description: 'LLM-powered generation and analysis without autonomous actions',
+        allowedTools: [...TIER_SPECIFIC_TOOLS.code, ...TIER_SPECIFIC_TOOLS.generative],
+        defaultTimeout: 30000, // 30 seconds
+    },
+    agentic: {
+        tier: 'agentic',
+        minComplexity: 6,
+        maxComplexity: 8,
+        description: 'Autonomous AI agents that can take actions and make decisions',
+        allowedTools: [
+            ...TIER_SPECIFIC_TOOLS.code,
+            ...TIER_SPECIFIC_TOOLS.generative,
+            ...TIER_SPECIFIC_TOOLS.agentic,
+        ],
+        defaultTimeout: 300000, // 5 minutes
+    },
+    human: {
+        tier: 'human',
+        minComplexity: 9,
+        maxComplexity: 10,
+        description: 'Human-in-the-loop for tasks requiring human judgment',
+        allowedTools: [
+            ...TIER_SPECIFIC_TOOLS.code,
+            ...TIER_SPECIFIC_TOOLS.generative,
+            ...TIER_SPECIFIC_TOOLS.agentic,
+            ...TIER_SPECIFIC_TOOLS.human,
+        ],
+        defaultTimeout: 86400000, // 24 hours
+    },
+};
+// ============================================================================
+// Tier Comparison Functions
+// ============================================================================
+/**
+ * Compare two tiers
+ * @returns negative if a < b, positive if a > b, 0 if equal
+ */
+export function compareTiers(a, b) {
+    return TIER_ORDER[a] - TIER_ORDER[b];
+}
+/**
+ * Check if tier A is higher than tier B
+ */
+export function isHigherTier(a, b) {
+    return TIER_ORDER[a] > TIER_ORDER[b];
+}
+/**
+ * Check if tier A is lower than tier B
+ */
+export function isLowerTier(a, b) {
+    return TIER_ORDER[a] < TIER_ORDER[b];
+}
+/**
+ * Get the next tier in escalation order
+ * @returns next tier or null if at highest tier
+ */
+export function getNextTier(tier) {
+    const index = TIER_ORDER[tier];
+    if (index >= CAPABILITY_TIERS.length - 1) {
+        return null;
+    }
+    return CAPABILITY_TIERS[index + 1] ?? null;
+}
+/**
+ * Get the previous tier in de-escalation order
+ * @returns previous tier or null if at lowest tier
+ */
+export function getPreviousTier(tier) {
+    const index = TIER_ORDER[tier];
+    if (index <= 0) {
+        return null;
+    }
+    return CAPABILITY_TIERS[index - 1] ?? null;
+}
+// ============================================================================
+// Tier Configuration Functions
+// ============================================================================
+/**
+ * Get configuration for a tier
+ */
+export function getTierConfig(tier) {
+    return TIER_CONFIGS[tier];
+}
+/**
+ * Get tools available for a tier (includes inherited tools from lower tiers)
+ */
+export function getToolsForTier(tier) {
+    return TIER_CONFIGS[tier].allowedTools;
+}
+// ============================================================================
+// Complexity Matching Functions
+// ============================================================================
+/**
+ * Match a complexity rating to the appropriate tier
+ */
+export function matchTierToComplexity(complexity) {
+    // Validate complexity is in range
+    const clampedComplexity = Math.max(1, Math.min(10, complexity));
+    // Find the matching tier
+    for (const tier of CAPABILITY_TIERS) {
+        const config = TIER_CONFIGS[tier];
+        if (clampedComplexity >= config.minComplexity && clampedComplexity <= config.maxComplexity) {
+            // Calculate confidence based on how centered in the range
+            const range = config.maxComplexity - config.minComplexity;
+            const center = config.minComplexity + range / 2;
+            const distance = Math.abs(clampedComplexity - center);
+            const confidence = 1 - (distance / (range + 1)) * 0.2; // 0.8-1.0 range
+            return {
+                tier,
+                confidence,
+                suggestedTools: config.allowedTools,
+            };
+        }
+    }
+    // Handle boundary cases (between tiers)
+    // Find which tier is closest
+    let bestTier = 'code';
+    let bestDistance = Infinity;
+    for (const tier of CAPABILITY_TIERS) {
+        const config = TIER_CONFIGS[tier];
+        const center = (config.minComplexity + config.maxComplexity) / 2;
+        const distance = Math.abs(clampedComplexity - center);
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            bestTier = tier;
+        }
+    }
+    return {
+        tier: bestTier,
+        confidence: 0.7, // Lower confidence for boundary cases
+        suggestedTools: TIER_CONFIGS[bestTier].allowedTools,
+    };
+}
+/**
+ * Check if a tier can execute a task of given complexity
+ */
+export function canExecuteAtTier(tier, complexity) {
+    const config = TIER_CONFIGS[tier];
+    // A tier can handle its own complexity range or any lower complexity
+    return complexity <= config.maxComplexity;
+}
+// ============================================================================
+// Escalation Functions
+// ============================================================================
+/**
+ * Validate a tier escalation request
+ */
+export function validateTierEscalation(escalation) {
+    const { fromTier, toTier, reason, skipJustification, allowDeescalation } = escalation;
+    // Require a reason
+    if (!reason || reason.trim() === '') {
+        return {
+            valid: false,
+            error: 'Escalation reason is required',
+        };
+    }
+    const fromOrder = TIER_ORDER[fromTier];
+    const toOrder = TIER_ORDER[toTier];
+    // Check for de-escalation
+    if (toOrder < fromOrder) {
+        if (!allowDeescalation) {
+            return {
+                valid: false,
+                error: 'de-escalation not allowed without explicit allowDeescalation flag',
+            };
+        }
+        return { valid: true };
+    }
+    // Check for same tier (no-op)
+    if (fromOrder === toOrder) {
+        return { valid: true };
+    }
+    // Check for multi-level escalation (skipping tiers)
+    const tierDifference = toOrder - fromOrder;
+    if (tierDifference > 1) {
+        if (!skipJustification || skipJustification.trim() === '') {
+            return {
+                valid: false,
+                error: 'skipJustification is required when skipping tiers',
+            };
+        }
+    }
+    return { valid: true };
+}
+// ============================================================================
+// Profile Creation and Validation
+// ============================================================================
+/**
+ * Create a capability profile with validation
+ */
+export function createCapabilityProfile(input) {
+    const { name, tier, complexityRating, tools, description, constraints } = input;
+    const config = TIER_CONFIGS[tier];
+    // Validate complexity rating is within tier bounds
+    if (complexityRating < config.minComplexity || complexityRating > config.maxComplexity) {
+        throw new Error(`Complexity rating ${complexityRating} is outside bounds for ${tier} tier ` +
+            `(${config.minComplexity}-${config.maxComplexity})`);
+    }
+    // Validate tools are appropriate for tier
+    const allowedTools = new Set(config.allowedTools);
+    for (const tool of tools) {
+        if (!allowedTools.has(tool)) {
+            throw new Error(`Tool '${tool}' is not allowed at ${tier} tier. ` +
+                `Allowed tools: ${config.allowedTools.join(', ')}`);
+        }
+    }
+    return {
+        name,
+        tier,
+        complexityRating,
+        tools,
+        ...(description !== undefined && { description }),
+        ...(constraints !== undefined && { constraints }),
+    };
+}
+// ============================================================================
+// Tier Registry
+// ============================================================================
+/**
+ * Registry for managing capability profiles
+ */
+export class TierRegistry {
+    profiles = new Map();
+    /**
+     * Register a capability profile
+     */
+    register(input) {
+        if (this.profiles.has(input.name)) {
+            throw new Error(`Profile '${input.name}' is already registered`);
+        }
+        const profile = createCapabilityProfile(input);
+        this.profiles.set(profile.name, profile);
+    }
+    /**
+     * Get a profile by name
+     */
+    get(name) {
+        return this.profiles.get(name);
+    }
+    /**
+     * Unregister a profile
+     */
+    unregister(name) {
+        return this.profiles.delete(name);
+    }
+    /**
+     * List all profiles for a tier
+     */
+    listByTier(tier) {
+        const result = [];
+        for (const profile of this.profiles.values()) {
+            if (profile.tier === tier) {
+                result.push(profile);
+            }
+        }
+        return result;
+    }
+    /**
+     * Find profiles that can handle a given complexity
+     */
+    findByComplexity(complexity) {
+        const result = [];
+        for (const profile of this.profiles.values()) {
+            if (canExecuteAtTier(profile.tier, complexity)) {
+                result.push(profile);
+            }
+        }
+        return result;
+    }
+    /**
+     * Find profiles with the required tools
+     */
+    findByTools(requiredTools) {
+        const result = [];
+        for (const profile of this.profiles.values()) {
+            const profileTools = new Set(profile.tools);
+            const hasAllTools = requiredTools.every((tool) => profileTools.has(tool));
+            if (hasAllTools) {
+                result.push(profile);
+            }
+        }
+        return result;
+    }
+    /**
+     * List all registered profiles
+     */
+    listAll() {
+        return Array.from(this.profiles.values());
+    }
+    /**
+     * Clear all profiles
+     */
+    clear() {
+        this.profiles.clear();
+    }
+}
+// ============================================================================
+// Default Export
+// ============================================================================
+export default {
+    CAPABILITY_TIERS,
+    TIER_ORDER,
+    compareTiers,
+    isHigherTier,
+    isLowerTier,
+    getNextTier,
+    getPreviousTier,
+    getTierConfig,
+    getToolsForTier,
+    matchTierToComplexity,
+    canExecuteAtTier,
+    validateTierEscalation,
+    createCapabilityProfile,
+    TierRegistry,
+};
+//# sourceMappingURL=capability-tiers.js.map

package/dist/capability-tiers.js.map

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