digital-workers 0.1.1 → 2.0.1

package/dist/approve.js

@@ -0,0 +1,235 @@
+/**
+ * Approval request functionality for digital workers
+ */
+/**
+ * Request approval from a worker or team
+ *
+ * Routes approval requests through the specified channel and waits for a response.
+ *
+ * @param request - What is being requested for approval
+ * @param target - The worker or team to request approval from
+ * @param options - Approval options
+ * @returns Promise resolving to approval result
+ *
+ * @example
+ * ```ts
+ * // Request approval from a worker
+ * const result = await approve('Expense: $500 for AWS', manager, {
+ *   via: 'slack',
+ *   context: { amount: 500, category: 'Infrastructure' },
+ * })
+ *
+ * if (result.approved) {
+ *   console.log(`Approved by ${result.approvedBy?.name}`)
+ * }
+ *
+ * // Request approval from a team
+ * const result = await approve('Deploy v2.1.0 to production', opsTeam, {
+ *   via: 'slack',
+ * })
+ * ```
+ */
+export async function approve(request, target, options = {}) {
+    const { via, timeout, context, escalate = false } = options;
+    // Resolve target to get contacts and approver info
+    const { contacts, approver } = resolveTarget(target);
+    // Determine which channel to use
+    const channel = resolveChannel(via, contacts);
+    if (!channel) {
+        throw new Error('No valid channel available for approval request');
+    }
+    // Send the approval request and wait for response
+    const response = await sendApprovalRequest(channel, request, contacts, {
+        timeout,
+        context,
+        approver,
+        escalate,
+    });
+    return {
+        approved: response.approved,
+        approvedBy: approver,
+        approvedAt: new Date(),
+        notes: response.notes,
+        via: channel,
+    };
+}
+/**
+ * Request approval with structured decision context
+ *
+ * @example
+ * ```ts
+ * const result = await approve.withContext(
+ *   'Migrate to new database',
+ *   cto,
+ *   {
+ *     pros: ['Better performance', 'Lower cost'],
+ *     cons: ['Migration effort', 'Downtime required'],
+ *     risks: ['Data loss', 'Service disruption'],
+ *     mitigations: ['Backup strategy', 'Staged rollout'],
+ *   },
+ *   { via: 'email' }
+ * )
+ * ```
+ */
+approve.withContext = async (request, target, decision, options = {}) => {
+    return approve(request, target, {
+        ...options,
+        context: {
+            ...options.context,
+            decision,
+        },
+    });
+};
+/**
+ * Request batch approval for multiple items
+ *
+ * @example
+ * ```ts
+ * const results = await approve.batch([
+ *   'Expense: $500 for AWS',
+ *   'Expense: $200 for office supplies',
+ *   'Expense: $1000 for conference ticket',
+ * ], finance, { via: 'email' })
+ *
+ * const approved = results.filter(r => r.approved)
+ * ```
+ */
+approve.batch = async (requests, target, options = {}) => {
+    return Promise.all(requests.map((request) => approve(request, target, options)));
+};
+/**
+ * Request approval with a deadline
+ *
+ * @example
+ * ```ts
+ * const result = await approve.withDeadline(
+ *   'Release v2.0',
+ *   manager,
+ *   new Date('2024-01-15T17:00:00Z'),
+ *   { via: 'slack' }
+ * )
+ * ```
+ */
+approve.withDeadline = async (request, target, deadline, options = {}) => {
+    const timeout = deadline.getTime() - Date.now();
+    return approve(request, target, {
+        ...options,
+        timeout: Math.max(0, timeout),
+        context: {
+            ...options.context,
+            deadline: deadline.toISOString(),
+        },
+    });
+};
+/**
+ * Request approval from multiple approvers (any one can approve)
+ *
+ * @example
+ * ```ts
+ * const result = await approve.any(
+ *   'Urgent: Production fix',
+ *   [alice, bob, charlie],
+ *   { via: 'slack' }
+ * )
+ * ```
+ */
+approve.any = async (request, targets, options = {}) => {
+    // Race all approval requests - first to respond wins
+    return Promise.race(targets.map((target) => approve(request, target, options)));
+};
+/**
+ * Request approval from multiple approvers (all must approve)
+ *
+ * @example
+ * ```ts
+ * const result = await approve.all(
+ *   'Major infrastructure change',
+ *   [cto, vpe, securityLead],
+ *   { via: 'email' }
+ * )
+ * ```
+ */
+approve.all = async (request, targets, options = {}) => {
+    const results = await Promise.all(targets.map((target) => approve(request, target, options)));
+    const allApproved = results.every((r) => r.approved);
+    return {
+        approved: allApproved,
+        approvedAt: new Date(),
+        notes: allApproved
+            ? 'All approvers approved'
+            : `${results.filter((r) => !r.approved).length} rejection(s)`,
+        approvals: results,
+    };
+};
+// ============================================================================
+// Internal Helpers
+// ============================================================================
+/**
+ * Resolve an action target to contacts and approver
+ */
+function resolveTarget(target) {
+    if (typeof target === 'string') {
+        return {
+            contacts: {},
+            approver: { id: target },
+        };
+    }
+    if ('contacts' in target) {
+        // Worker or Team
+        let approver;
+        if ('members' in target) {
+            // Team - use lead or first member
+            approver = target.lead ?? target.members[0] ?? { id: target.id };
+        }
+        else {
+            // Worker
+            approver = { id: target.id, type: target.type, name: target.name };
+        }
+        return {
+            contacts: target.contacts,
+            approver,
+        };
+    }
+    // WorkerRef
+    return {
+        contacts: {},
+        approver: target,
+    };
+}
+/**
+ * Determine which channel to use
+ */
+function resolveChannel(via, contacts) {
+    if (via) {
+        const requested = Array.isArray(via) ? via[0] : via;
+        if (requested && contacts[requested] !== undefined) {
+            return requested;
+        }
+    }
+    // Default to first available
+    const available = Object.keys(contacts);
+    const first = available[0];
+    return first ?? null;
+}
+/**
+ * Send an approval request to a channel and wait for response
+ */
+async function sendApprovalRequest(channel, request, contacts, options) {
+    const contact = contacts[channel];
+    if (!contact) {
+        throw new Error(`No ${channel} contact configured`);
+    }
+    // In a real implementation, this would:
+    // 1. Format the request for the channel (Slack blocks, email HTML, etc.)
+    // 2. Send via the appropriate API
+    // 3. Wait for response (polling, webhook, interactive message, etc.)
+    // 4. Handle timeout and escalation
+    // For now, simulate a pending response
+    await new Promise((resolve) => setTimeout(resolve, 10));
+    // Return a placeholder - real impl would wait for actual response
+    return {
+        approved: false,
+        notes: 'Approval pending - waiting for response',
+    };
+}
+//# sourceMappingURL=approve.js.map

package/dist/approve.js.map

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

package/dist/ask.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Question/answer functionality for digital workers
+ */
+import type { SimpleSchema } from 'ai-functions';
+import type { ActionTarget, AskResult, AskOptions } from './types.js';
+/**
+ * Ask a question to a worker or team
+ *
+ * Routes questions through the specified channel and waits for a response.
+ *
+ * @param target - The worker or team to ask
+ * @param question - The question to ask
+ * @param options - Ask options
+ * @returns Promise resolving to the answer
+ *
+ * @example
+ * ```ts
+ * // Ask a simple question
+ * const result = await ask(alice, 'What is the company holiday policy?', {
+ *   via: 'slack',
+ * })
+ * console.log(result.answer)
+ *
+ * // Ask with structured response
+ * const result = await ask(ceo, 'What are our Q1 priorities?', {
+ *   via: 'email',
+ *   schema: {
+ *     priorities: ['List of priorities'],
+ *     reasoning: 'Why these priorities were chosen',
+ *   },
+ * })
+ * ```
+ */
+export declare function ask<T = string>(target: ActionTarget, question: string, options?: AskOptions): Promise<AskResult<T>>;
+export declare namespace ask {
+    var ai: <T = string>(question: string, context?: Record<string, unknown>, schema?: SimpleSchema) => Promise<T>;
+    var batch: <T = string>(target: ActionTarget, questions: string[], options?: AskOptions) => Promise<Array<AskResult<T>>>;
+    var clarify: (target: ActionTarget, topic: string, options?: AskOptions) => Promise<AskResult<string>>;
+    var yesNo: (target: ActionTarget, question: string, options?: AskOptions) => Promise<AskResult<"yes" | "no">>;
+    var choose: <T extends string>(target: ActionTarget, question: string, choices: T[], options?: AskOptions) => Promise<AskResult<T>>;
+}
+//# sourceMappingURL=ask.d.ts.map

package/dist/ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../src/ask.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,EAIV,YAAY,EAEZ,SAAS,EACT,UAAU,EAEX,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,GAAG,CAAC,CAAC,GAAG,MAAM,EAClC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CA2BvB;yBA/BqB,GAAG;aA4CT,CAAC,qBACL,MAAM,YACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WACxB,YAAY,KACpB,OAAO,CAAC,CAAC,CAAC;gBAqCM,CAAC,mBACV,YAAY,aACT,MAAM,EAAE,YACV,UAAU,KAClB,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;0BAarB,YAAY,SACb,MAAM,YACJ,UAAU,KAClB,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;wBAkBnB,YAAY,YACV,MAAM,YACP,UAAU,KAClB,OAAO,CAAC,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;iBAoBf,CAAC,SAAS,MAAM,UAC1B,YAAY,YACV,MAAM,WACP,CAAC,EAAE,YACH,UAAU,KAClB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC"}

package/dist/ask.js

@@ -0,0 +1,227 @@
+/**
+ * Question/answer functionality for digital workers
+ */
+import { generateObject } from 'ai-functions';
+/**
+ * Ask a question to a worker or team
+ *
+ * Routes questions through the specified channel and waits for a response.
+ *
+ * @param target - The worker or team to ask
+ * @param question - The question to ask
+ * @param options - Ask options
+ * @returns Promise resolving to the answer
+ *
+ * @example
+ * ```ts
+ * // Ask a simple question
+ * const result = await ask(alice, 'What is the company holiday policy?', {
+ *   via: 'slack',
+ * })
+ * console.log(result.answer)
+ *
+ * // Ask with structured response
+ * const result = await ask(ceo, 'What are our Q1 priorities?', {
+ *   via: 'email',
+ *   schema: {
+ *     priorities: ['List of priorities'],
+ *     reasoning: 'Why these priorities were chosen',
+ *   },
+ * })
+ * ```
+ */
+export async function ask(target, question, options = {}) {
+    const { via, schema, timeout, context } = options;
+    // Resolve target to get contacts and recipient info
+    const { contacts, recipient } = resolveTarget(target);
+    // Determine which channel to use
+    const channel = resolveChannel(via, contacts);
+    if (!channel) {
+        throw new Error('No valid channel available to ask question');
+    }
+    // Send the question and wait for response
+    const response = await sendQuestion(channel, question, contacts, {
+        schema,
+        timeout,
+        context,
+        recipient,
+    });
+    return {
+        answer: response.answer,
+        answeredBy: recipient,
+        answeredAt: new Date(),
+        via: channel,
+    };
+}
+/**
+ * Ask an AI agent directly (no human routing)
+ *
+ * @example
+ * ```ts
+ * const answer = await ask.ai('What is our refund policy?', {
+ *   policies: [...],
+ *   customerContext: {...},
+ * })
+ * ```
+ */
+ask.ai = async (question, context, schema) => {
+    if (schema) {
+        const result = await generateObject({
+            model: 'sonnet',
+            schema,
+            prompt: question,
+            system: context
+                ? `Use the following context to answer the question:\n\n${JSON.stringify(context, null, 2)}`
+                : undefined,
+        });
+        return result.object;
+    }
+    const result = await generateObject({
+        model: 'sonnet',
+        schema: { answer: 'The answer to the question' },
+        prompt: question,
+        system: context
+            ? `Use the following context to answer the question:\n\n${JSON.stringify(context, null, 2)}`
+            : undefined,
+    });
+    return result.object.answer;
+};
+/**
+ * Ask multiple questions at once
+ *
+ * @example
+ * ```ts
+ * const results = await ask.batch(hr, [
+ *   'What is the vacation policy?',
+ *   'What is the remote work policy?',
+ *   'What is the expense policy?',
+ * ], { via: 'email' })
+ * ```
+ */
+ask.batch = async (target, questions, options = {}) => {
+    return Promise.all(questions.map((q) => ask(target, q, options)));
+};
+/**
+ * Ask for clarification on something
+ *
+ * @example
+ * ```ts
+ * const clarification = await ask.clarify(devops, 'The deployment process')
+ * ```
+ */
+ask.clarify = async (target, topic, options = {}) => {
+    return ask(target, `Can you clarify: ${topic}`, options);
+};
+/**
+ * Ask a yes/no question
+ *
+ * @example
+ * ```ts
+ * const result = await ask.yesNo(manager, 'Should we proceed with the release?', {
+ *   via: 'slack',
+ * })
+ * if (result.answer === 'yes') {
+ *   // proceed
+ * }
+ * ```
+ */
+ask.yesNo = async (target, question, options = {}) => {
+    return ask(target, question, {
+        ...options,
+        schema: {
+            answer: 'Answer: yes or no',
+        },
+    });
+};
+/**
+ * Ask for a choice from options
+ *
+ * @example
+ * ```ts
+ * const result = await ask.choose(designer, 'Which color scheme?', {
+ *   choices: ['Light', 'Dark', 'System'],
+ *   via: 'slack',
+ * })
+ * ```
+ */
+ask.choose = async (target, question, choices, options = {}) => {
+    const choiceList = choices.map((c, i) => `${i + 1}. ${c}`).join('\n');
+    const fullQuestion = `${question}\n\nOptions:\n${choiceList}`;
+    return ask(target, fullQuestion, {
+        ...options,
+        schema: {
+            answer: `One of: ${choices.join(', ')}`,
+        },
+    });
+};
+// ============================================================================
+// Internal Helpers
+// ============================================================================
+/**
+ * Resolve an action target to contacts and recipient
+ */
+function resolveTarget(target) {
+    if (typeof target === 'string') {
+        return {
+            contacts: {},
+            recipient: { id: target },
+        };
+    }
+    if ('contacts' in target) {
+        // Worker or Team
+        let recipient;
+        if ('members' in target) {
+            // Team - ask lead or first member
+            recipient = target.lead ?? target.members[0] ?? { id: target.id };
+        }
+        else {
+            // Worker
+            recipient = { id: target.id, type: target.type, name: target.name };
+        }
+        return {
+            contacts: target.contacts,
+            recipient,
+        };
+    }
+    // WorkerRef
+    return {
+        contacts: {},
+        recipient: target,
+    };
+}
+/**
+ * Determine which channel to use
+ */
+function resolveChannel(via, contacts) {
+    if (via) {
+        const requested = Array.isArray(via) ? via[0] : via;
+        if (requested && contacts[requested] !== undefined) {
+            return requested;
+        }
+    }
+    // Default to first available
+    const available = Object.keys(contacts);
+    const first = available[0];
+    return first ?? null;
+}
+/**
+ * Send a question to a channel and wait for response
+ */
+async function sendQuestion(channel, question, contacts, options) {
+    const contact = contacts[channel];
+    if (!contact) {
+        throw new Error(`No ${channel} contact configured`);
+    }
+    // In a real implementation, this would:
+    // 1. Format the question for the channel
+    // 2. Send via the appropriate API
+    // 3. Wait for response (polling, webhook, etc.)
+    // 4. Parse and validate the response
+    // For now, simulate a pending response
+    await new Promise((resolve) => setTimeout(resolve, 10));
+    // Return a placeholder - real impl would wait for actual response
+    return {
+        answer: 'Waiting for response...',
+    };
+}
+//# sourceMappingURL=ask.js.map

package/dist/ask.js.map

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

package/dist/decide.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Decision-making functionality for digital workers
+ */
+import type { Decision, DecideOptions } from './types.js';
+/**
+ * Make a decision from a set of options
+ *
+ * Uses AI to evaluate options and make a reasoned decision,
+ * or can route to human decision-makers for critical choices.
+ *
+ * @param options - Decision options with configuration
+ * @returns Promise resolving to decision result
+ *
+ * @example
+ * ```ts
+ * const decision = await decide({
+ *   options: ['Option A', 'Option B', 'Option C'],
+ *   context: 'We need to choose a technology stack for our new project',
+ *   criteria: [
+ *     'Developer experience',
+ *     'Performance',
+ *     'Community support',
+ *     'Long-term viability',
+ *   ],
+ * })
+ *
+ * console.log(`Decision: ${decision.choice}`)
+ * console.log(`Reasoning: ${decision.reasoning}`)
+ * console.log(`Confidence: ${decision.confidence}`)
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Complex decision with structured options
+ * const decision = await decide({
+ *   options: [
+ *     { id: 'migrate', label: 'Migrate to new platform' },
+ *     { id: 'refactor', label: 'Refactor existing system' },
+ *     { id: 'rebuild', label: 'Rebuild from scratch' },
+ *   ],
+ *   context: {
+ *     budget: '$500k',
+ *     timeline: '6 months',
+ *     teamSize: 5,
+ *     currentSystem: 'Legacy monolith',
+ *   },
+ *   criteria: ['Cost', 'Time to market', 'Risk', 'Scalability'],
+ * })
+ * ```
+ */
+export declare function decide<T = string>(options: DecideOptions<T>): Promise<Decision<T>>;
+export declare namespace decide {
+    var yesNo: (question: string, context?: string | Record<string, unknown>) => Promise<Decision<"yes" | "no">>;
+    var prioritize: <T = string>(items: T[], context?: string | Record<string, unknown>, criteria?: string[]) => Promise<Array<Decision<T> & {
+        rank: number;
+    }>>;
+    var withApproval: <T = string>(options: DecideOptions<T>, approver: string) => Promise<Decision<T> & {
+        approved: boolean;
+        approvedBy?: string;
+    }>;
+}
+//# sourceMappingURL=decide.d.ts.map

package/dist/decide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../src/decide.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAsB,MAAM,CAAC,CAAC,GAAG,MAAM,EACrC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAyEtB;yBA3EqB,MAAM;0BAqGhB,MAAM,YACN,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;qBA8BP,CAAC,kBACnB,CAAC,EAAE,YACA,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,aAChC,MAAM,EAAE,KACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;uBA6EpB,CAAC,oBACnB,aAAa,CAAC,CAAC,CAAC,YACf,MAAM,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC"}