digital-workers 2.1.3 → 2.4.0

package/dist/approve.js

@@ -1,33 +1,65 @@
 /**
  * Approval request functionality for digital workers
+ *
+ * IMPORTANT: Worker Routing vs LLM Content Generation
+ * ---------------------------------------------------
+ * This module provides real approval workflows, NOT LLM-generated approval content.
+ *
+ * - `digital-workers.approve()` - Routes approval requests to Workers (Humans
+ *   or AI Agents) via communication channels and waits for actual approval.
+ *
+ * - `ai-functions.approve()` - Generates approval request content via LLM
+ *   for use in human interaction UIs.
+ *
+ * Use digital-workers when you need:
+ * - Real approval workflows with actual approvers
+ * - Routing to specific people via Slack, email, SMS
+ * - Approval audit trails (who, when, via what channel)
+ * - Multi-approver workflows (any/all must approve)
+ *
+ * Use ai-functions when you need:
+ * - LLM-generated approval request content
+ * - Generating UI/UX for approval flows
+ * - Approval request templates
+ *
+ * @module
  */
 /**
- * Request approval from a worker or team
+ * Route an approval request to a Worker (Human or AI Agent) and wait for response.
+ *
+ * **Key Difference from ai-functions.approve():**
+ * Unlike `ai-functions.approve()` which generates approval request content
+ * using the LLM, this function routes the request to an actual approver via
+ * real communication channels (Slack, email, SMS) and waits for their response.
  *
- * Routes approval requests through the specified channel and waits for a response.
+ * This is a **workflow approval primitive**, not a content generation primitive.
  *
  * @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
+ * @param target - The worker or team to request approval from (routes to their channels)
+ * @param options - Approval options including channel, timeout, and context
+ * @returns Promise resolving to approval result with metadata (who approved, when, notes)
  *
  * @example
  * ```ts
- * // Request approval from a worker
+ * // Request approval from a human via Slack
  * 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}`)
+ *   console.log(`Approved by ${result.approvedBy?.name} at ${result.approvedAt}`)
  * }
  *
- * // Request approval from a team
+ * // Request approval from a team (routes to lead or available member)
  * const result = await approve('Deploy v2.1.0 to production', opsTeam, {
  *   via: 'slack',
  * })
  * ```
+ *
+ * @see {@link ai-functions#approve} for LLM-generated approval request content
+ * @see {@link approve.all} for multi-approver workflows (all must approve)
+ * @see {@link approve.any} for multi-approver workflows (any can approve)
  */
 export async function approve(request, target, options = {}) {
     const { via, timeout, context, escalate = false } = options;
@@ -40,8 +72,8 @@ export async function approve(request, target, options = {}) {
     }
     // Send the approval request and wait for response
     const response = await sendApprovalRequest(channel, request, contacts, {
-        timeout,
-        context,
+        ...(timeout !== undefined && { timeout }),
+        ...(context !== undefined && { context }),
         approver,
         escalate,
     });
@@ -49,7 +81,7 @@ export async function approve(request, target, options = {}) {
         approved: response.approved,
         approvedBy: approver,
         approvedAt: new Date(),
-        notes: response.notes,
+        ...(response.notes !== undefined && { notes: response.notes }),
         via: channel,
     };
 }
@@ -219,17 +251,51 @@ async function sendApprovalRequest(channel, request, contacts, options) {
     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
+    // Import transport functions dynamically to avoid circular dependencies
+    const { channelToTransport, sendViaTransport, hasTransport, resolveAddress } = await import('./transports.js');
+    const transport = channelToTransport(channel);
+    const address = resolveAddress(contacts, channel);
+    // If transport is registered, use it for real delivery
+    if (hasTransport(transport) && address) {
+        const { generateRequestId } = await import('./utils/id.js');
+        const requestId = generateRequestId('apr');
+        const payload = {
+            to: address.value,
+            body: request,
+            type: 'approval',
+            priority: 'normal',
+            threadId: requestId,
+            actions: [
+                { id: 'approve', label: 'Approve', style: 'primary', value: true },
+                { id: 'reject', label: 'Reject', style: 'danger', value: false },
+            ],
+            metadata: {
+                ...options.context,
+                approver: options.approver,
+                escalate: options.escalate,
+            },
+            ...(options.timeout !== undefined && { timeout: options.timeout }),
+        };
+        const result = await sendViaTransport(transport, payload);
+        if (result.success) {
+            // For real transports, we need to wait for a response
+            // This would integrate with the runtime's HumanRequestProcessor
+            // For now, return pending state - the response comes via webhook
+            return {
+                approved: false,
+                notes: `Approval request sent via ${transport}. Awaiting response. Request ID: ${requestId}`,
+            };
+        }
+        else {
+            throw new Error(`Failed to send approval request via ${transport}: ${result.error}`);
+        }
+    }
+    // No transport registered - return pending state
+    // In a real workflow, this would be processed when a transport is configured
+    // or the runtime handles the request via HumanRequestProcessor
     return {
         approved: false,
-        notes: 'Approval pending - waiting for response',
+        notes: `Approval request pending - no transport registered for ${channel}. Configure a transport handler to enable real delivery.`,
     };
 }
 //# sourceMappingURL=approve.js.map

package/dist/approve.js.map

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

package/dist/ask.d.ts

@@ -1,27 +1,56 @@
 /**
  * Question/answer functionality for digital workers
+ *
+ * IMPORTANT: Worker Routing vs Direct LLM Calls
+ * ---------------------------------------------
+ * This module provides worker-routed question handling, NOT direct LLM queries.
+ *
+ * - `digital-workers.ask()` - Routes questions to Workers (AI Agents or Humans)
+ *   via communication channels (Slack, email, SMS, etc.) and waits for response.
+ *
+ * - `ai-functions.ask()` - Generates content for human interaction via LLM.
+ *
+ * Use digital-workers when you need:
+ * - To ask a specific person or team via real channels
+ * - Human responses with accountability (who answered)
+ * - Channel-based communication (Slack, email, SMS)
+ * - Team coordination and escalation
+ *
+ * Use ai-functions when you need:
+ * - LLM-generated question/answer content
+ * - Generating UI for human input
+ * - Direct AI text generation
+ *
+ * @module
  */
 import type { SimpleSchema } from 'ai-functions';
 import type { ActionTarget, AskResult, AskOptions } from './types.js';
 /**
- * Ask a question to a worker or team
+ * Route a question to a Worker (AI Agent or Human) via communication channels.
  *
- * Routes questions through the specified channel and waits for a response.
+ * **Key Difference from ai-functions.ask():**
+ * Unlike `ai-functions.ask()` which generates content for human interaction
+ * using the LLM, this function routes the question to an actual Worker (person
+ * or AI agent) via real communication channels (Slack, email, SMS, etc.) and
+ * waits for their response.
  *
- * @param target - The worker or team to ask
+ * This is a **worker communication primitive**, not a direct LLM primitive.
+ *
+ * @param target - The worker or team to ask (routes to their configured channels)
  * @param question - The question to ask
- * @param options - Ask options
- * @returns Promise resolving to the answer
+ * @param options - Ask options including channel, schema, and timeout
+ * @returns Promise resolving to the answer with metadata (who answered, when, via what channel)
  *
  * @example
  * ```ts
- * // Ask a simple question
+ * // Ask a human via Slack
  * const result = await ask(alice, 'What is the company holiday policy?', {
  *   via: 'slack',
  * })
  * console.log(result.answer)
+ * console.log(`Answered by ${result.answeredBy.name} at ${result.answeredAt}`)
  *
- * // Ask with structured response
+ * // Ask with structured response schema
  * const result = await ask(ceo, 'What are our Q1 priorities?', {
  *   via: 'email',
  *   schema: {
@@ -30,6 +59,8 @@ import type { ActionTarget, AskResult, AskOptions } from './types.js';
  *   },
  * })
  * ```
+ *
+ * @see {@link ai-functions#ask} for LLM-generated human interaction content
  */
 export declare function ask<T = string>(target: ActionTarget, question: string, options?: AskOptions): Promise<AskResult<T>>;
 export declare namespace ask {

package/dist/ask.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../src/ask.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,EAIV,YAAY,EAEZ,SAAS,EACT,UAAU,EAEX,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;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;gBA6CM,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

@@ -1,26 +1,55 @@
 /**
  * Question/answer functionality for digital workers
+ *
+ * IMPORTANT: Worker Routing vs Direct LLM Calls
+ * ---------------------------------------------
+ * This module provides worker-routed question handling, NOT direct LLM queries.
+ *
+ * - `digital-workers.ask()` - Routes questions to Workers (AI Agents or Humans)
+ *   via communication channels (Slack, email, SMS, etc.) and waits for response.
+ *
+ * - `ai-functions.ask()` - Generates content for human interaction via LLM.
+ *
+ * Use digital-workers when you need:
+ * - To ask a specific person or team via real channels
+ * - Human responses with accountability (who answered)
+ * - Channel-based communication (Slack, email, SMS)
+ * - Team coordination and escalation
+ *
+ * Use ai-functions when you need:
+ * - LLM-generated question/answer content
+ * - Generating UI for human input
+ * - Direct AI text generation
+ *
+ * @module
  */
 import { generateObject } from 'ai-functions';
 /**
- * Ask a question to a worker or team
+ * Route a question to a Worker (AI Agent or Human) via communication channels.
+ *
+ * **Key Difference from ai-functions.ask():**
+ * Unlike `ai-functions.ask()` which generates content for human interaction
+ * using the LLM, this function routes the question to an actual Worker (person
+ * or AI agent) via real communication channels (Slack, email, SMS, etc.) and
+ * waits for their response.
  *
- * Routes questions through the specified channel and waits for a response.
+ * This is a **worker communication primitive**, not a direct LLM primitive.
  *
- * @param target - The worker or team to ask
+ * @param target - The worker or team to ask (routes to their configured channels)
  * @param question - The question to ask
- * @param options - Ask options
- * @returns Promise resolving to the answer
+ * @param options - Ask options including channel, schema, and timeout
+ * @returns Promise resolving to the answer with metadata (who answered, when, via what channel)
  *
  * @example
  * ```ts
- * // Ask a simple question
+ * // Ask a human via Slack
  * const result = await ask(alice, 'What is the company holiday policy?', {
  *   via: 'slack',
  * })
  * console.log(result.answer)
+ * console.log(`Answered by ${result.answeredBy.name} at ${result.answeredAt}`)
  *
- * // Ask with structured response
+ * // Ask with structured response schema
  * const result = await ask(ceo, 'What are our Q1 priorities?', {
  *   via: 'email',
  *   schema: {
@@ -29,6 +58,8 @@ import { generateObject } from 'ai-functions';
  *   },
  * })
  * ```
+ *
+ * @see {@link ai-functions#ask} for LLM-generated human interaction content
  */
 export async function ask(target, question, options = {}) {
     const { via, schema, timeout, context } = options;
@@ -41,9 +72,9 @@ export async function ask(target, question, options = {}) {
     }
     // Send the question and wait for response
     const response = await sendQuestion(channel, question, contacts, {
-        schema,
-        timeout,
-        context,
+        ...(schema !== undefined && { schema }),
+        ...(timeout !== undefined && { timeout }),
+        ...(context !== undefined && { context }),
         recipient,
     });
     return {
@@ -70,9 +101,9 @@ ask.ai = async (question, context, schema) => {
             model: 'sonnet',
             schema,
             prompt: question,
-            system: context
-                ? `Use the following context to answer the question:\n\n${JSON.stringify(context, null, 2)}`
-                : undefined,
+            ...(context !== undefined && {
+                system: `Use the following context to answer the question:\n\n${JSON.stringify(context, null, 2)}`,
+            }),
         });
         return result.object;
     }
@@ -80,9 +111,9 @@ ask.ai = async (question, context, schema) => {
         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,
+        ...(context !== undefined && {
+            system: `Use the following context to answer the question:\n\n${JSON.stringify(context, null, 2)}`,
+        }),
     });
     return result.object.answer;
 };
@@ -212,16 +243,45 @@ async function sendQuestion(channel, question, contacts, options) {
     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
+    // Import transport functions dynamically to avoid circular dependencies
+    const { channelToTransport, sendViaTransport, hasTransport, resolveAddress } = await import('./transports.js');
+    const transport = channelToTransport(channel);
+    const address = resolveAddress(contacts, channel);
+    // If transport is registered, use it for real delivery
+    if (hasTransport(transport) && address) {
+        const { generateRequestId } = await import('./utils/id.js');
+        const requestId = generateRequestId('ask');
+        const payload = {
+            to: address.value,
+            body: question,
+            type: 'question',
+            priority: 'normal',
+            threadId: requestId,
+            ...(options.schema !== undefined && { schema: options.schema }),
+            ...(options.timeout !== undefined && { timeout: options.timeout }),
+            metadata: {
+                ...options.context,
+                recipient: options.recipient,
+            },
+        };
+        const result = await sendViaTransport(transport, payload);
+        if (result.success) {
+            // For real transports, we need to wait for a response
+            // This would integrate with the runtime's HumanRequestProcessor
+            // For now, return pending state - the response comes via webhook
+            return {
+                answer: `Question sent via ${transport}. Awaiting response. Request ID: ${requestId}`,
+            };
+        }
+        else {
+            throw new Error(`Failed to send question via ${transport}: ${result.error}`);
+        }
+    }
+    // No transport registered - return pending state
+    // In a real workflow, this would be processed when a transport is configured
+    // or the runtime handles the request via HumanRequestProcessor
     return {
-        answer: 'Waiting for response...',
+        answer: `Question pending - no transport registered for ${channel}. Configure a transport handler to enable real delivery.`,
     };
 }
 //# sourceMappingURL=ask.js.map

package/dist/ask.js.map

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