digital-workers 0.1.1 → 2.0.2

package/dist/kpis.js

@@ -0,0 +1,271 @@
+/**
+ * KPI and OKR tracking functionality for digital workers
+ */
+export function kpis(definition) {
+    return definition;
+}
+/**
+ * Update a KPI's current value
+ *
+ * @param kpi - The KPI to update
+ * @param current - New current value
+ * @returns Updated KPI
+ *
+ * @example
+ * ```ts
+ * const updated = kpis.update(deploymentFrequency, 8)
+ * console.log(updated.current) // 8
+ * console.log(updated.trend) // 'up' (automatically determined)
+ * ```
+ */
+kpis.update = (kpi, current) => {
+    // Determine trend
+    let trend = 'stable';
+    if (current > kpi.current) {
+        trend = 'up';
+    }
+    else if (current < kpi.current) {
+        trend = 'down';
+    }
+    return {
+        ...kpi,
+        current,
+        trend,
+    };
+};
+/**
+ * Calculate progress towards target (0-1)
+ *
+ * @param kpi - The KPI
+ * @returns Progress as a decimal (0-1)
+ *
+ * @example
+ * ```ts
+ * const kpi = { current: 75, target: 100 }
+ * const progress = kpis.progress(kpi) // 0.75
+ * ```
+ */
+kpis.progress = (kpi) => {
+    if (kpi.target === 0)
+        return 0;
+    return Math.min(1, Math.max(0, kpi.current / kpi.target));
+};
+/**
+ * Check if a KPI is on track
+ *
+ * @param kpi - The KPI
+ * @param threshold - Minimum progress to be "on track" (default: 0.8)
+ * @returns Whether the KPI is on track
+ *
+ * @example
+ * ```ts
+ * const kpi = { current: 85, target: 100 }
+ * const onTrack = kpis.onTrack(kpi) // true (85% >= 80%)
+ * ```
+ */
+kpis.onTrack = (kpi, threshold = 0.8) => {
+    return kpis.progress(kpi) >= threshold;
+};
+/**
+ * Get the gap to target
+ *
+ * @param kpi - The KPI
+ * @returns Difference between target and current
+ *
+ * @example
+ * ```ts
+ * const kpi = { current: 75, target: 100 }
+ * const gap = kpis.gap(kpi) // 25
+ * ```
+ */
+kpis.gap = (kpi) => {
+    return kpi.target - kpi.current;
+};
+/**
+ * Format a KPI for display
+ *
+ * @param kpi - The KPI
+ * @returns Formatted string
+ *
+ * @example
+ * ```ts
+ * const kpi = {
+ *   name: 'Deployment Frequency',
+ *   current: 5,
+ *   target: 10,
+ *   unit: 'deploys/week',
+ *   trend: 'up',
+ * }
+ * const formatted = kpis.format(kpi)
+ * // "Deployment Frequency: 5/10 deploys/week (50%, trending up)"
+ * ```
+ */
+kpis.format = (kpi) => {
+    const progress = kpis.progress(kpi);
+    const progressPercent = Math.round(progress * 100);
+    const trendEmoji = kpi.trend === 'up' ? '↑' : kpi.trend === 'down' ? '↓' : '→';
+    return `${kpi.name}: ${kpi.current}/${kpi.target} ${kpi.unit} (${progressPercent}%, trending ${kpi.trend} ${trendEmoji})`;
+};
+/**
+ * Compare two KPI snapshots to see change over time
+ *
+ * @param previous - Previous KPI state
+ * @param current - Current KPI state
+ * @returns Change analysis
+ *
+ * @example
+ * ```ts
+ * const change = kpis.compare(previousKPI, currentKPI)
+ * console.log(change.delta) // 5
+ * console.log(change.percentChange) // 10
+ * console.log(change.improved) // true
+ * ```
+ */
+kpis.compare = (previous, current) => {
+    const delta = current.current - previous.current;
+    const percentChange = previous.current !== 0
+        ? (delta / previous.current) * 100
+        : 0;
+    // Improved if we got closer to the target
+    const previousGap = Math.abs(previous.target - previous.current);
+    const currentGap = Math.abs(current.target - current.current);
+    const improved = currentGap < previousGap;
+    return {
+        delta,
+        percentChange,
+        improved,
+    };
+};
+/**
+ * Define OKRs (Objectives and Key Results)
+ *
+ * @param definition - OKR definition
+ * @returns The defined OKR
+ *
+ * @example
+ * ```ts
+ * const engineeringOKR = okrs({
+ *   objective: 'Improve development velocity',
+ *   keyResults: [
+ *     {
+ *       name: 'Deployment Frequency',
+ *       current: 5,
+ *       target: 10,
+ *       unit: 'deploys/week',
+ *     },
+ *     {
+ *       name: 'Lead Time',
+ *       current: 48,
+ *       target: 24,
+ *       unit: 'hours',
+ *     },
+ *     {
+ *       name: 'Change Failure Rate',
+ *       current: 15,
+ *       target: 5,
+ *       unit: '%',
+ *     },
+ *   ],
+ *   owner: 'engineering-team',
+ *   dueDate: new Date('2024-03-31'),
+ * })
+ * ```
+ */
+export function okrs(definition) {
+    return definition;
+}
+/**
+ * Calculate overall OKR progress
+ *
+ * @param okr - The OKR
+ * @returns Average progress across all key results (0-1)
+ *
+ * @example
+ * ```ts
+ * const progress = okrs.progress(engineeringOKR)
+ * console.log(progress) // 0.67 (67% complete)
+ * ```
+ */
+okrs.progress = (okr) => {
+    if (okr.keyResults.length === 0)
+        return 0;
+    const totalProgress = okr.keyResults.reduce((sum, kr) => {
+        return sum + kpis.progress(kr);
+    }, 0);
+    return totalProgress / okr.keyResults.length;
+};
+/**
+ * Update a key result in an OKR
+ *
+ * @param okr - The OKR
+ * @param keyResultName - Name of key result to update
+ * @param current - New current value
+ * @returns Updated OKR
+ *
+ * @example
+ * ```ts
+ * const updated = okrs.updateKeyResult(
+ *   engineeringOKR,
+ *   'Deployment Frequency',
+ *   8
+ * )
+ * ```
+ */
+okrs.updateKeyResult = (okr, keyResultName, current) => {
+    return {
+        ...okr,
+        keyResults: okr.keyResults.map((kr) => kr.name === keyResultName ? { ...kr, current } : kr),
+        progress: undefined, // Will be recalculated
+    };
+};
+/**
+ * Check if OKR is on track
+ *
+ * @param okr - The OKR
+ * @param threshold - Minimum progress to be "on track" (default: 0.7)
+ * @returns Whether the OKR is on track
+ *
+ * @example
+ * ```ts
+ * const onTrack = okrs.onTrack(engineeringOKR)
+ * ```
+ */
+okrs.onTrack = (okr, threshold = 0.7) => {
+    return okrs.progress(okr) >= threshold;
+};
+/**
+ * Format OKR for display
+ *
+ * @param okr - The OKR
+ * @returns Formatted string
+ *
+ * @example
+ * ```ts
+ * const formatted = okrs.format(engineeringOKR)
+ * console.log(formatted)
+ * // Improve development velocity (67% complete)
+ * // • Deployment Frequency: 5/10 deploys/week (50%)
+ * // • Lead Time: 48/24 hours (200%)
+ * // • Change Failure Rate: 15/5 % (300%)
+ * ```
+ */
+okrs.format = (okr) => {
+    const progress = okrs.progress(okr);
+    const progressPercent = Math.round(progress * 100);
+    const lines = [
+        `${okr.objective} (${progressPercent}% complete)`,
+        ...okr.keyResults.map((kr) => {
+            const krProgress = kpis.progress(kr);
+            const krPercent = Math.round(krProgress * 100);
+            return `  • ${kr.name}: ${kr.current}/${kr.target} ${kr.unit} (${krPercent}%)`;
+        }),
+    ];
+    if (okr.owner) {
+        lines.push(`  Owner: ${okr.owner}`);
+    }
+    if (okr.dueDate) {
+        lines.push(`  Due: ${okr.dueDate.toLocaleDateString()}`);
+    }
+    return lines.join('\n');
+};
+//# sourceMappingURL=kpis.js.map

package/dist/kpis.js.map

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

package/dist/notify.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Notification functionality for digital workers
+ */
+import type { ActionTarget, NotifyResult, NotifyOptions } from './types.js';
+/**
+ * Send a notification to a worker or team
+ *
+ * Routes notifications through the specified channel(s), falling back
+ * to the target's preferred channel if not specified.
+ *
+ * @param target - The worker or team to notify
+ * @param message - The notification message
+ * @param options - Notification options
+ * @returns Promise resolving to notification result
+ *
+ * @example
+ * ```ts
+ * // Notify a worker via their preferred channel
+ * await notify(alice, 'Deployment completed successfully')
+ *
+ * // Notify via specific channel
+ * await notify(alice, 'Urgent: Server down!', { via: 'slack' })
+ *
+ * // Notify via multiple channels
+ * await notify(alice, 'Critical alert', { via: ['slack', 'sms'] })
+ *
+ * // Notify a team
+ * await notify(engineering, 'Sprint planning tomorrow', { via: 'slack' })
+ * ```
+ */
+export declare function notify(target: ActionTarget, message: string, options?: NotifyOptions): Promise<NotifyResult>;
+export declare namespace notify {
+    var alert: (target: ActionTarget, message: string, options?: NotifyOptions) => Promise<NotifyResult>;
+    var info: (target: ActionTarget, message: string, options?: NotifyOptions) => Promise<NotifyResult>;
+    var rich: (target: ActionTarget, title: string, body: string, options?: NotifyOptions) => Promise<NotifyResult>;
+    var batch: (notifications: Array<{
+        target: ActionTarget;
+        message: string;
+        options?: NotifyOptions;
+    }>) => Promise<NotifyResult[]>;
+    var schedule: (target: ActionTarget, message: string, when: Date | number, options?: NotifyOptions) => Promise<{
+        scheduled: true;
+        scheduledFor: Date;
+        messageId: string;
+    }>;
+}
+//# sourceMappingURL=notify.d.ts.map

package/dist/notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAIV,YAAY,EAEZ,YAAY,EACZ,aAAa,EAEd,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA6CvB;yBAjDqB,MAAM;wBA4DlB,YAAY,WACX,MAAM,YACN,aAAa,KACrB,OAAO,CAAC,YAAY,CAAC;uBAad,YAAY,WACX,MAAM,YACN,aAAa,KACrB,OAAO,CAAC,YAAY,CAAC;uBAgBd,YAAY,SACb,MAAM,QACP,MAAM,YACH,aAAa,KACrB,OAAO,CAAC,YAAY,CAAC;+BAkBP,KAAK,CAAC;QACnB,MAAM,EAAE,YAAY,CAAA;QACpB,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,CAAC,EAAE,aAAa,CAAA;KACxB,CAAC,KACD,OAAO,CAAC,YAAY,EAAE,CAAC;2BAmBhB,YAAY,WACX,MAAM,QACT,IAAI,GAAG,MAAM,YACV,aAAa,KACrB,OAAO,CAAC;QAAE,SAAS,EAAE,IAAI,CAAC;QAAC,YAAY,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC"}

package/dist/notify.js

@@ -0,0 +1,220 @@
+/**
+ * Notification functionality for digital workers
+ */
+/**
+ * Send a notification to a worker or team
+ *
+ * Routes notifications through the specified channel(s), falling back
+ * to the target's preferred channel if not specified.
+ *
+ * @param target - The worker or team to notify
+ * @param message - The notification message
+ * @param options - Notification options
+ * @returns Promise resolving to notification result
+ *
+ * @example
+ * ```ts
+ * // Notify a worker via their preferred channel
+ * await notify(alice, 'Deployment completed successfully')
+ *
+ * // Notify via specific channel
+ * await notify(alice, 'Urgent: Server down!', { via: 'slack' })
+ *
+ * // Notify via multiple channels
+ * await notify(alice, 'Critical alert', { via: ['slack', 'sms'] })
+ *
+ * // Notify a team
+ * await notify(engineering, 'Sprint planning tomorrow', { via: 'slack' })
+ * ```
+ */
+export async function notify(target, message, options = {}) {
+    const { via, priority = 'normal', fallback = false, timeout, context, metadata } = options;
+    // Resolve target to get contacts
+    const { contacts, recipients } = resolveTarget(target);
+    // Determine which channels to use
+    const channels = resolveChannels(via, contacts, priority);
+    if (channels.length === 0) {
+        return {
+            sent: false,
+            via: [],
+            sentAt: new Date(),
+            messageId: generateMessageId(),
+            delivery: [],
+        };
+    }
+    // Send to each channel
+    const delivery = await Promise.all(channels.map(async (channel) => {
+        try {
+            await sendToChannel(channel, message, contacts, { priority, metadata });
+            return { channel, status: 'sent' };
+        }
+        catch (error) {
+            return {
+                channel,
+                status: 'failed',
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }));
+    const sent = delivery.some((d) => d.status === 'sent');
+    return {
+        sent,
+        via: channels,
+        recipients,
+        sentAt: new Date(),
+        messageId: generateMessageId(),
+        delivery,
+    };
+}
+/**
+ * Send a high-priority alert notification
+ *
+ * @example
+ * ```ts
+ * await notify.alert(oncallEngineer, 'Production is down!')
+ * ```
+ */
+notify.alert = async (target, message, options = {}) => {
+    return notify(target, message, { ...options, priority: 'urgent' });
+};
+/**
+ * Send a low-priority info notification
+ *
+ * @example
+ * ```ts
+ * await notify.info(team, 'Weekly sync notes posted')
+ * ```
+ */
+notify.info = async (target, message, options = {}) => {
+    return notify(target, message, { ...options, priority: 'low' });
+};
+/**
+ * Send a rich notification with title and body
+ *
+ * @example
+ * ```ts
+ * await notify.rich(alice, 'Deployment Complete', 'Version 2.1.0 deployed to production', {
+ *   via: 'slack',
+ *   metadata: { version: '2.1.0', environment: 'production' },
+ * })
+ * ```
+ */
+notify.rich = async (target, title, body, options = {}) => {
+    const message = `**${title}**\n\n${body}`;
+    return notify(target, message, options);
+};
+/**
+ * Send notifications in batch
+ *
+ * @example
+ * ```ts
+ * await notify.batch([
+ *   { target: alice, message: 'Task 1 complete' },
+ *   { target: bob, message: 'Task 2 complete' },
+ *   { target: team, message: 'All tasks done', options: { via: 'slack' } },
+ * ])
+ * ```
+ */
+notify.batch = async (notifications) => {
+    return Promise.all(notifications.map(({ target, message, options }) => notify(target, message, options)));
+};
+/**
+ * Schedule a notification for later
+ *
+ * @example
+ * ```ts
+ * // Schedule for specific time
+ * await notify.schedule(alice, 'Meeting in 15 minutes', new Date('2024-01-15T14:45:00Z'))
+ *
+ * // Schedule with delay
+ * await notify.schedule(alice, 'Reminder', 60000)  // 1 minute
+ * ```
+ */
+notify.schedule = async (target, message, when, options = {}) => {
+    const scheduledFor = when instanceof Date ? when : new Date(Date.now() + when);
+    // In a real implementation, this would store the scheduled notification
+    return {
+        scheduled: true,
+        scheduledFor,
+        messageId: generateMessageId('scheduled'),
+    };
+};
+// ============================================================================
+// Internal Helpers
+// ============================================================================
+/**
+ * Resolve an action target to contacts and recipients
+ */
+function resolveTarget(target) {
+    if (typeof target === 'string') {
+        // Just an ID - return empty contacts, would need to look up
+        return {
+            contacts: {},
+            recipients: [{ id: target }],
+        };
+    }
+    if ('contacts' in target) {
+        // Worker or Team
+        const recipients = 'members' in target
+            ? target.members // Team
+            : [{ id: target.id, type: target.type, name: target.name }]; // Worker
+        return {
+            contacts: target.contacts,
+            recipients,
+        };
+    }
+    // WorkerRef - no contacts available
+    return {
+        contacts: {},
+        recipients: [target],
+    };
+}
+/**
+ * Determine which channels to use based on options and contacts
+ */
+function resolveChannels(via, contacts, priority) {
+    // If specific channels requested, use those
+    if (via) {
+        const requested = Array.isArray(via) ? via : [via];
+        // Filter to only channels that exist in contacts
+        return requested.filter((channel) => contacts[channel] !== undefined);
+    }
+    // Otherwise, use available channels based on priority
+    const available = Object.keys(contacts);
+    if (available.length === 0) {
+        return [];
+    }
+    const firstChannel = available[0];
+    if (!firstChannel) {
+        return [];
+    }
+    // For urgent, try multiple channels
+    if (priority === 'urgent') {
+        const urgentChannels = ['slack', 'sms', 'phone'];
+        return available.filter((c) => urgentChannels.includes(c));
+    }
+    // Default to first available
+    return [firstChannel];
+}
+/**
+ * Send a notification to a specific channel
+ */
+async function sendToChannel(channel, message, contacts, options) {
+    const contact = contacts[channel];
+    if (!contact) {
+        throw new Error(`No ${channel} contact configured`);
+    }
+    // In a real implementation, this would:
+    // 1. Format the message for the channel
+    // 2. Send via the appropriate API (Slack, SendGrid, Twilio, etc.)
+    // 3. Handle delivery confirmation
+    // For now, simulate success
+    await new Promise((resolve) => setTimeout(resolve, 10));
+}
+/**
+ * Generate a unique message ID
+ */
+function generateMessageId(prefix = 'msg') {
+    return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+//# sourceMappingURL=notify.js.map

package/dist/notify.js.map

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

package/dist/role.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Role definition for digital workers
+ */
+import type { WorkerRole } from './types.js';
+/**
+ * Define a worker role
+ *
+ * Roles define responsibilities, skills, and permissions for workers
+ * (both AI agents and humans) within an organization.
+ *
+ * @param definition - Role definition
+ * @returns The defined role
+ *
+ * @example
+ * ```ts
+ * const engineer = Role({
+ *   name: 'Software Engineer',
+ *   description: 'Builds and maintains software systems',
+ *   responsibilities: [
+ *     'Write clean, maintainable code',
+ *     'Review pull requests',
+ *     'Fix bugs and issues',
+ *     'Participate in architecture decisions',
+ *   ],
+ *   skills: ['TypeScript', 'React', 'Node.js'],
+ *   type: 'hybrid', // Can be filled by AI or human
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * const supportAgent = Role({
+ *   name: 'Customer Support Agent',
+ *   description: 'Assists customers with inquiries and issues',
+ *   responsibilities: [
+ *     'Respond to customer inquiries',
+ *     'Troubleshoot issues',
+ *     'Escalate complex problems',
+ *     'Maintain customer satisfaction',
+ *   ],
+ *   type: 'ai', // AI-first role
+ * })
+ * ```
+ */
+export declare function Role(definition: Omit<WorkerRole, 'type'> & {
+    type?: WorkerRole['type'];
+}): WorkerRole;
+export declare namespace Role {
+    var ai: (definition: Omit<WorkerRole, "type">) => WorkerRole;
+    var human: (definition: Omit<WorkerRole, "type">) => WorkerRole;
+    var hybrid: (definition: Omit<WorkerRole, "type">) => WorkerRole;
+}
+//# sourceMappingURL=role.d.ts.map

package/dist/role.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../src/role.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;CAAE,GAAG,UAAU,CAKrG;yBALe,IAAI;yBAuBG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,KAAG,UAAU;4BAsBlC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,KAAG,UAAU;6BAqBpC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,KAAG,UAAU"}