autonomous-agents 0.1.0 → 2.0.1

package/dist/metrics.d.ts

@@ -0,0 +1,245 @@
+/**
+ * Metrics - KPIs and OKRs for autonomous agents
+ *
+ * Track key performance indicators and objectives/key results to measure
+ * agent and team performance.
+ *
+ * @packageDocumentation
+ */
+import type { KPI, OKR, KeyResult } from './types.js';
+/**
+ * Create a KPI (Key Performance Indicator)
+ *
+ * @example
+ * ```ts
+ * import { kpi } from 'autonomous-agents'
+ *
+ * const revenueKPI = kpi({
+ *   name: 'Monthly Recurring Revenue',
+ *   description: 'Total MRR from subscriptions',
+ *   value: 125000,
+ *   target: 150000,
+ *   unit: 'USD',
+ *   frequency: 'monthly',
+ *   trend: 'up',
+ * })
+ *
+ * // Update the value
+ * revenueKPI.update(130000)
+ *
+ * // Add historical data
+ * revenueKPI.addHistory(125000)
+ *
+ * // Get progress
+ * const progress = revenueKPI.getProgress() // 86.67%
+ * ```
+ */
+export declare function kpi(config: {
+    name: string;
+    description?: string;
+    value: number | string;
+    target?: number | string;
+    unit?: string;
+    frequency?: 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly';
+}): KPIInstance;
+/**
+ * KPI instance with methods
+ */
+export interface KPIInstance extends KPI {
+    /** Update the current value */
+    update(value: number | string): void;
+    /** Add historical data point */
+    addHistory(value: number | string, timestamp?: Date): void;
+    /** Get progress towards target */
+    getProgress(): number | null;
+    /** Get trend direction */
+    getTrend(): 'up' | 'down' | 'stable';
+    /** Get historical data */
+    getHistory(): Array<{
+        timestamp: Date;
+        value: number | string;
+    }>;
+    /** Convert to plain JSON */
+    toJSON(): KPI;
+}
+/**
+ * Create multiple KPIs
+ *
+ * @example
+ * ```ts
+ * import { kpis } from 'autonomous-agents'
+ *
+ * const metrics = kpis([
+ *   { name: 'Revenue', value: 100000, target: 150000, unit: 'USD' },
+ *   { name: 'Active Users', value: 5000, target: 10000, unit: 'users' },
+ *   { name: 'NPS Score', value: 72, target: 80, unit: 'points' },
+ * ])
+ *
+ * // Access individual KPIs
+ * metrics.revenue.update(110000)
+ *
+ * // Get all KPIs
+ * const all = metrics.getAll()
+ *
+ * // Get progress summary
+ * const summary = metrics.getSummary()
+ * ```
+ */
+export declare function kpis(configs: Array<{
+    name: string;
+    description?: string;
+    value: number | string;
+    target?: number | string;
+    unit?: string;
+    frequency?: 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly';
+}>): KPIsCollection;
+/**
+ * KPIs collection with dynamic access
+ */
+export interface KPIsCollection {
+    /** Get all KPIs */
+    getAll(): KPIInstance[];
+    /** Get a specific KPI by name */
+    get(name: string): KPIInstance | undefined;
+    /** Get summary of all KPIs */
+    getSummary(): {
+        total: number;
+        onTrack: number;
+        atRisk: number;
+        averageProgress: number;
+    };
+    /** Convert all KPIs to JSON */
+    toJSON(): KPI[];
+    /** Dynamic access to KPIs by name */
+    [key: string]: KPIInstance | ((...args: any[]) => any);
+}
+/**
+ * Create an OKR (Objectives and Key Results)
+ *
+ * @example
+ * ```ts
+ * import { okr } from 'autonomous-agents'
+ *
+ * const growthOKR = okr({
+ *   objective: 'Accelerate revenue growth',
+ *   description: 'Drive sustainable revenue growth through product expansion and market penetration',
+ *   keyResults: [
+ *     {
+ *       id: 'kr1',
+ *       description: 'Increase MRR from $100k to $150k',
+ *       current: 100000,
+ *       target: 150000,
+ *       unit: 'USD',
+ *     },
+ *     {
+ *       id: 'kr2',
+ *       description: 'Launch in 3 new markets',
+ *       current: 0,
+ *       target: 3,
+ *       unit: 'markets',
+ *     },
+ *   ],
+ *   period: 'Q1 2024',
+ *   owner: 'CEO',
+ * })
+ *
+ * // Update a key result
+ * growthOKR.updateKeyResult('kr1', { current: 125000 })
+ *
+ * // Get overall progress
+ * const progress = growthOKR.getProgress() // 58.33%
+ * ```
+ */
+export declare function okr(config: {
+    objective: string;
+    description?: string;
+    keyResults: KeyResult[];
+    period?: string;
+    owner?: string;
+}): OKRInstance;
+/**
+ * OKR instance with methods
+ */
+export interface OKRInstance extends OKR {
+    /** Update a key result */
+    updateKeyResult(keyResultId: string, updates: Partial<Omit<KeyResult, 'id'>>): void;
+    /** Get overall progress */
+    getProgress(): number;
+    /** Get a specific key result */
+    getKeyResult(keyResultId: string): KeyResult | undefined;
+    /** Get all key results */
+    getKeyResults(): KeyResult[];
+    /** Get OKR status */
+    getStatus(): 'active' | 'completed' | 'at-risk' | 'cancelled';
+    /** Convert to plain JSON */
+    toJSON(): OKR;
+}
+/**
+ * Create multiple OKRs
+ *
+ * @example
+ * ```ts
+ * import { okrs } from 'autonomous-agents'
+ *
+ * const objectives = okrs([
+ *   {
+ *     objective: 'Accelerate revenue growth',
+ *     keyResults: [
+ *       { id: 'kr1', description: 'Increase MRR to $150k', current: 100000, target: 150000 },
+ *     ],
+ *   },
+ *   {
+ *     objective: 'Improve product quality',
+ *     keyResults: [
+ *       { id: 'kr2', description: 'Reduce bug count to 10', current: 25, target: 10 },
+ *     ],
+ *   },
+ * ])
+ *
+ * const all = objectives.getAll()
+ * const summary = objectives.getSummary()
+ * ```
+ */
+export declare function okrs(configs: Array<{
+    objective: string;
+    description?: string;
+    keyResults: KeyResult[];
+    period?: string;
+    owner?: string;
+}>): OKRsCollection;
+/**
+ * OKRs collection
+ */
+export interface OKRsCollection {
+    /** Get all OKRs */
+    getAll(): OKRInstance[];
+    /** Get a specific OKR by ID */
+    get(id: string): OKRInstance | undefined;
+    /** Get OKRs by owner */
+    getByOwner(owner: string): OKRInstance[];
+    /** Get summary of all OKRs */
+    getSummary(): {
+        total: number;
+        onTrack: number;
+        atRisk: number;
+        completed: number;
+        averageProgress: number;
+    };
+    /** Convert all OKRs to JSON */
+    toJSON(): OKR[];
+}
+/**
+ * Update key result status based on progress
+ */
+export declare function updateKeyResultStatus(kr: KeyResult): void;
+/**
+ * Create a key result
+ */
+export declare function createKeyResult(config: {
+    id: string;
+    description: string;
+    current: number | string;
+    target: number | string;
+    unit?: string;
+}): KeyResult;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

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

package/dist/metrics.js

@@ -0,0 +1,436 @@
+/**
+ * Metrics - KPIs and OKRs for autonomous agents
+ *
+ * Track key performance indicators and objectives/key results to measure
+ * agent and team performance.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Create a KPI (Key Performance Indicator)
+ *
+ * @example
+ * ```ts
+ * import { kpi } from 'autonomous-agents'
+ *
+ * const revenueKPI = kpi({
+ *   name: 'Monthly Recurring Revenue',
+ *   description: 'Total MRR from subscriptions',
+ *   value: 125000,
+ *   target: 150000,
+ *   unit: 'USD',
+ *   frequency: 'monthly',
+ *   trend: 'up',
+ * })
+ *
+ * // Update the value
+ * revenueKPI.update(130000)
+ *
+ * // Add historical data
+ * revenueKPI.addHistory(125000)
+ *
+ * // Get progress
+ * const progress = revenueKPI.getProgress() // 86.67%
+ * ```
+ */
+export function kpi(config) {
+    const state = {
+        id: generateKPIId(config.name),
+        name: config.name,
+        description: config.description,
+        value: config.value,
+        target: config.target,
+        unit: config.unit,
+        frequency: config.frequency,
+        history: [],
+    };
+    return {
+        ...state,
+        update,
+        addHistory,
+        getProgress,
+        getTrend,
+        getHistory,
+        toJSON,
+    };
+    /**
+     * Update the current value
+     */
+    function update(newValue) {
+        // Store old value in history
+        if (state.value !== undefined) {
+            addHistory(state.value);
+        }
+        state.value = newValue;
+        state.trend = calculateTrend();
+    }
+    /**
+     * Add a historical data point
+     */
+    function addHistory(value, timestamp) {
+        if (!state.history) {
+            state.history = [];
+        }
+        state.history.push({
+            timestamp: timestamp || new Date(),
+            value,
+        });
+    }
+    /**
+     * Get progress towards target
+     */
+    function getProgress() {
+        if (!state.target)
+            return null;
+        if (typeof state.value === 'number' && typeof state.target === 'number') {
+            return Math.min(100, (state.value / state.target) * 100);
+        }
+        return null;
+    }
+    /**
+     * Get trend direction
+     */
+    function getTrend() {
+        return state.trend || calculateTrend();
+    }
+    /**
+     * Calculate trend from history
+     */
+    function calculateTrend() {
+        if (!state.history || state.history.length < 2)
+            return 'stable';
+        const recent = state.history.slice(-2);
+        const prev = recent[0].value;
+        const curr = recent[1].value;
+        if (typeof prev === 'number' && typeof curr === 'number') {
+            if (curr > prev)
+                return 'up';
+            if (curr < prev)
+                return 'down';
+        }
+        return 'stable';
+    }
+    /**
+     * Get historical data
+     */
+    function getHistory() {
+        return state.history || [];
+    }
+    /**
+     * Convert to plain JSON
+     */
+    function toJSON() {
+        return { ...state };
+    }
+}
+/**
+ * Create multiple KPIs
+ *
+ * @example
+ * ```ts
+ * import { kpis } from 'autonomous-agents'
+ *
+ * const metrics = kpis([
+ *   { name: 'Revenue', value: 100000, target: 150000, unit: 'USD' },
+ *   { name: 'Active Users', value: 5000, target: 10000, unit: 'users' },
+ *   { name: 'NPS Score', value: 72, target: 80, unit: 'points' },
+ * ])
+ *
+ * // Access individual KPIs
+ * metrics.revenue.update(110000)
+ *
+ * // Get all KPIs
+ * const all = metrics.getAll()
+ *
+ * // Get progress summary
+ * const summary = metrics.getSummary()
+ * ```
+ */
+export function kpis(configs) {
+    const kpiMap = new Map();
+    // Create KPI instances
+    configs.forEach(config => {
+        const instance = kpi(config);
+        const key = config.name.toLowerCase().replace(/\s+/g, '');
+        kpiMap.set(key, instance);
+    });
+    // Create proxy for direct access
+    const proxy = new Proxy({}, {
+        get(_target, prop) {
+            if (prop === 'getAll')
+                return getAll;
+            if (prop === 'get')
+                return get;
+            if (prop === 'getSummary')
+                return getSummary;
+            if (prop === 'toJSON')
+                return toJSON;
+            return kpiMap.get(prop);
+        },
+    });
+    function getAll() {
+        return Array.from(kpiMap.values());
+    }
+    function get(name) {
+        return kpiMap.get(name.toLowerCase().replace(/\s+/g, ''));
+    }
+    function getSummary() {
+        const all = getAll();
+        const withTargets = all.filter(k => k.target !== undefined);
+        const onTrack = withTargets.filter(k => {
+            const progress = k.getProgress();
+            return progress !== null && progress >= 70;
+        });
+        const atRisk = withTargets.filter(k => {
+            const progress = k.getProgress();
+            return progress !== null && progress < 70;
+        });
+        const totalProgress = withTargets.reduce((sum, k) => {
+            const progress = k.getProgress();
+            return sum + (progress || 0);
+        }, 0);
+        return {
+            total: all.length,
+            onTrack: onTrack.length,
+            atRisk: atRisk.length,
+            averageProgress: withTargets.length > 0 ? totalProgress / withTargets.length : 0,
+        };
+    }
+    function toJSON() {
+        return getAll().map(k => k.toJSON());
+    }
+    return proxy;
+}
+/**
+ * Create an OKR (Objectives and Key Results)
+ *
+ * @example
+ * ```ts
+ * import { okr } from 'autonomous-agents'
+ *
+ * const growthOKR = okr({
+ *   objective: 'Accelerate revenue growth',
+ *   description: 'Drive sustainable revenue growth through product expansion and market penetration',
+ *   keyResults: [
+ *     {
+ *       id: 'kr1',
+ *       description: 'Increase MRR from $100k to $150k',
+ *       current: 100000,
+ *       target: 150000,
+ *       unit: 'USD',
+ *     },
+ *     {
+ *       id: 'kr2',
+ *       description: 'Launch in 3 new markets',
+ *       current: 0,
+ *       target: 3,
+ *       unit: 'markets',
+ *     },
+ *   ],
+ *   period: 'Q1 2024',
+ *   owner: 'CEO',
+ * })
+ *
+ * // Update a key result
+ * growthOKR.updateKeyResult('kr1', { current: 125000 })
+ *
+ * // Get overall progress
+ * const progress = growthOKR.getProgress() // 58.33%
+ * ```
+ */
+export function okr(config) {
+    const state = {
+        id: generateOKRId(config.objective),
+        objective: config.objective,
+        description: config.description,
+        keyResults: config.keyResults,
+        period: config.period,
+        owner: config.owner,
+        status: 'active',
+    };
+    return {
+        ...state,
+        updateKeyResult,
+        getProgress,
+        getKeyResult,
+        getKeyResults,
+        getStatus,
+        toJSON,
+    };
+    /**
+     * Update a key result
+     */
+    function updateKeyResult(keyResultId, updates) {
+        const kr = state.keyResults.find(k => k.id === keyResultId);
+        if (!kr) {
+            throw new Error(`Key result with id ${keyResultId} not found`);
+        }
+        Object.assign(kr, updates);
+        // Recalculate progress
+        kr.progress = calculateKeyResultProgress(kr);
+        state.progress = calculateOKRProgress();
+    }
+    /**
+     * Get overall OKR progress
+     */
+    function getProgress() {
+        if (state.progress !== undefined)
+            return state.progress;
+        return calculateOKRProgress();
+    }
+    /**
+     * Calculate OKR progress from key results
+     */
+    function calculateOKRProgress() {
+        if (state.keyResults.length === 0)
+            return 0;
+        const totalProgress = state.keyResults.reduce((sum, kr) => {
+            return sum + (kr.progress || calculateKeyResultProgress(kr));
+        }, 0);
+        return totalProgress / state.keyResults.length;
+    }
+    /**
+     * Get a specific key result
+     */
+    function getKeyResult(keyResultId) {
+        return state.keyResults.find(k => k.id === keyResultId);
+    }
+    /**
+     * Get all key results
+     */
+    function getKeyResults() {
+        return [...state.keyResults];
+    }
+    /**
+     * Get OKR status
+     */
+    function getStatus() {
+        if (state.status)
+            return state.status;
+        const progress = getProgress();
+        if (progress >= 100)
+            return 'completed';
+        if (progress < 50)
+            return 'at-risk';
+        return 'active';
+    }
+    /**
+     * Convert to plain JSON
+     */
+    function toJSON() {
+        return { ...state };
+    }
+}
+/**
+ * Create multiple OKRs
+ *
+ * @example
+ * ```ts
+ * import { okrs } from 'autonomous-agents'
+ *
+ * const objectives = okrs([
+ *   {
+ *     objective: 'Accelerate revenue growth',
+ *     keyResults: [
+ *       { id: 'kr1', description: 'Increase MRR to $150k', current: 100000, target: 150000 },
+ *     ],
+ *   },
+ *   {
+ *     objective: 'Improve product quality',
+ *     keyResults: [
+ *       { id: 'kr2', description: 'Reduce bug count to 10', current: 25, target: 10 },
+ *     ],
+ *   },
+ * ])
+ *
+ * const all = objectives.getAll()
+ * const summary = objectives.getSummary()
+ * ```
+ */
+export function okrs(configs) {
+    const okrList = configs.map(config => okr(config));
+    return {
+        getAll() {
+            return okrList;
+        },
+        get(id) {
+            return okrList.find(o => o.id === id);
+        },
+        getByOwner(owner) {
+            return okrList.filter(o => o.owner === owner);
+        },
+        getSummary() {
+            const totalProgress = okrList.reduce((sum, o) => sum + o.getProgress(), 0);
+            return {
+                total: okrList.length,
+                onTrack: okrList.filter(o => o.getProgress() >= 70).length,
+                atRisk: okrList.filter(o => o.getProgress() < 50).length,
+                completed: okrList.filter(o => o.status === 'completed').length,
+                averageProgress: okrList.length > 0 ? totalProgress / okrList.length : 0,
+            };
+        },
+        toJSON() {
+            return okrList.map(o => o.toJSON());
+        },
+    };
+}
+/**
+ * Generate a KPI ID from name
+ */
+function generateKPIId(name) {
+    return `kpi-${name.toLowerCase().replace(/\s+/g, '-')}`;
+}
+/**
+ * Generate an OKR ID from objective
+ */
+function generateOKRId(objective) {
+    return `okr-${objective.toLowerCase().replace(/\s+/g, '-').slice(0, 30)}`;
+}
+/**
+ * Calculate progress for a key result
+ */
+function calculateKeyResultProgress(kr) {
+    if (typeof kr.current === 'number' && typeof kr.target === 'number') {
+        return Math.min(100, (kr.current / kr.target) * 100);
+    }
+    return 0;
+}
+/**
+ * Update key result status based on progress
+ */
+export function updateKeyResultStatus(kr) {
+    const progress = kr.progress || calculateKeyResultProgress(kr);
+    if (progress >= 100) {
+        kr.status = 'completed';
+    }
+    else if (progress >= 70) {
+        kr.status = 'on-track';
+    }
+    else if (progress >= 30) {
+        kr.status = 'at-risk';
+    }
+    else {
+        kr.status = 'off-track';
+    }
+}
+/**
+ * Create a key result
+ */
+export function createKeyResult(config) {
+    const kr = {
+        id: config.id,
+        description: config.description,
+        current: config.current,
+        target: config.target,
+        unit: config.unit,
+        progress: calculateKeyResultProgress({
+            id: config.id,
+            description: config.description,
+            current: config.current,
+            target: config.target,
+        }),
+    };
+    updateKeyResultStatus(kr);
+    return kr;
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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