digital-workers 2.1.3 → 2.3.0

package/dist/notify.d.ts

@@ -1,32 +1,61 @@
 /**
  * Notification functionality for digital workers
+ *
+ * IMPORTANT: Real Channel Delivery vs LLM Generation
+ * ---------------------------------------------------
+ * This module sends real notifications via communication channels,
+ * NOT LLM-generated notification content.
+ *
+ * - `digital-workers.notify()` - Sends actual notifications to Workers
+ *   via real channels (Slack, email, SMS, etc.) with delivery tracking.
+ *
+ * - ai-functions does not have an equivalent `notify` primitive since
+ *   it focuses on LLM operations, not communication channel delivery.
+ *
+ * Use digital-workers.notify() when you need:
+ * - Real notification delivery to people/agents
+ * - Multi-channel delivery (Slack + SMS for urgent)
+ * - Delivery tracking and confirmation
+ * - Priority-based channel selection
+ * - Scheduled notifications
+ *
+ * @module
  */
 import type { ActionTarget, NotifyResult, NotifyOptions } from './types.js';
 /**
- * Send a notification to a worker or team
+ * Send a notification to a Worker (Human or AI Agent) via communication channels.
+ *
+ * **Unique to digital-workers:**
+ * This function sends real notifications via actual communication channels
+ * (Slack, email, SMS, phone, etc.). There is no equivalent in ai-functions
+ * since ai-functions focuses on LLM operations rather than external delivery.
  *
- * Routes notifications through the specified channel(s), falling back
- * to the target's preferred channel if not specified.
+ * This is a **communication delivery primitive** for worker coordination.
  *
- * @param target - The worker or team to notify
+ * @param target - The worker or team to notify (routes to their configured channels)
  * @param message - The notification message
- * @param options - Notification options
- * @returns Promise resolving to notification result
+ * @param options - Notification options (channel, priority, metadata)
+ * @returns Promise resolving to NotifyResult with delivery status and metadata
  *
  * @example
  * ```ts
  * // Notify a worker via their preferred channel
- * await notify(alice, 'Deployment completed successfully')
+ * const result = await notify(alice, 'Deployment completed successfully')
+ * console.log(result.sent) // true
+ * console.log(result.via) // ['slack']
  *
  * // Notify via specific channel
  * await notify(alice, 'Urgent: Server down!', { via: 'slack' })
  *
- * // Notify via multiple channels
+ * // Notify via multiple channels (for urgent messages)
  * await notify(alice, 'Critical alert', { via: ['slack', 'sms'] })
  *
- * // Notify a team
+ * // Notify a team (reaches all members via their channels)
  * await notify(engineering, 'Sprint planning tomorrow', { via: 'slack' })
  * ```
+ *
+ * @see {@link notify.alert} for high-priority urgent notifications
+ * @see {@link notify.schedule} for delayed/scheduled notifications
  */
 export declare function notify(target: ActionTarget, message: string, options?: NotifyOptions): Promise<NotifyResult>;
 export declare namespace notify {

package/dist/notify.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAIV,YAAY,EAEZ,YAAY,EACZ,aAAa,EAEd,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAgDvB;yBApDqB,MAAM;wBA+DlB,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

@@ -1,31 +1,61 @@
 /**
  * Notification functionality for digital workers
+ *
+ * IMPORTANT: Real Channel Delivery vs LLM Generation
+ * ---------------------------------------------------
+ * This module sends real notifications via communication channels,
+ * NOT LLM-generated notification content.
+ *
+ * - `digital-workers.notify()` - Sends actual notifications to Workers
+ *   via real channels (Slack, email, SMS, etc.) with delivery tracking.
+ *
+ * - ai-functions does not have an equivalent `notify` primitive since
+ *   it focuses on LLM operations, not communication channel delivery.
+ *
+ * Use digital-workers.notify() when you need:
+ * - Real notification delivery to people/agents
+ * - Multi-channel delivery (Slack + SMS for urgent)
+ * - Delivery tracking and confirmation
+ * - Priority-based channel selection
+ * - Scheduled notifications
+ *
+ * @module
  */
+import { generateRequestId } from './utils/id.js';
 /**
- * Send a notification to a worker or team
+ * Send a notification to a Worker (Human or AI Agent) via communication channels.
  *
- * Routes notifications through the specified channel(s), falling back
- * to the target's preferred channel if not specified.
+ * **Unique to digital-workers:**
+ * This function sends real notifications via actual communication channels
+ * (Slack, email, SMS, phone, etc.). There is no equivalent in ai-functions
+ * since ai-functions focuses on LLM operations rather than external delivery.
  *
- * @param target - The worker or team to notify
+ * This is a **communication delivery primitive** for worker coordination.
+ *
+ * @param target - The worker or team to notify (routes to their configured channels)
  * @param message - The notification message
- * @param options - Notification options
- * @returns Promise resolving to notification result
+ * @param options - Notification options (channel, priority, metadata)
+ * @returns Promise resolving to NotifyResult with delivery status and metadata
  *
  * @example
  * ```ts
  * // Notify a worker via their preferred channel
- * await notify(alice, 'Deployment completed successfully')
+ * const result = await notify(alice, 'Deployment completed successfully')
+ * console.log(result.sent) // true
+ * console.log(result.via) // ['slack']
  *
  * // Notify via specific channel
  * await notify(alice, 'Urgent: Server down!', { via: 'slack' })
  *
- * // Notify via multiple channels
+ * // Notify via multiple channels (for urgent messages)
  * await notify(alice, 'Critical alert', { via: ['slack', 'sms'] })
  *
- * // Notify a team
+ * // Notify a team (reaches all members via their channels)
  * await notify(engineering, 'Sprint planning tomorrow', { via: 'slack' })
  * ```
+ *
+ * @see {@link notify.alert} for high-priority urgent notifications
+ * @see {@link notify.schedule} for delayed/scheduled notifications
  */
 export async function notify(target, message, options = {}) {
     const { via, priority = 'normal', fallback = false, timeout, context, metadata } = options;
@@ -45,7 +75,10 @@ export async function notify(target, message, options = {}) {
     // Send to each channel
     const delivery = await Promise.all(channels.map(async (channel) => {
         try {
-            await sendToChannel(channel, message, contacts, { priority, metadata });
+            await sendToChannel(channel, message, contacts, {
+                priority,
+                ...(metadata !== undefined && { metadata }),
+            });
             return { channel, status: 'sent' };
         }
         catch (error) {
@@ -204,17 +237,39 @@ async function sendToChannel(channel, message, contacts, options) {
     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));
+    // 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 payload = {
+            to: address.value,
+            body: message,
+            type: 'notification',
+            priority: (options.priority || 'normal'),
+            ...(options.metadata !== undefined && { metadata: options.metadata }),
+        };
+        const result = await sendViaTransport(transport, payload);
+        if (!result.success) {
+            throw new Error(`Failed to send notification via ${transport}: ${result.error}`);
+        }
+        return;
+    }
+    // No transport registered - log to console for development/testing
+    // This provides visibility into what would be sent
+    console.log(`[digital-workers] Notification (${channel}):`, {
+        to: typeof contact === 'string' ? contact : JSON.stringify(contact),
+        message,
+        priority: options.priority || 'normal',
+        metadata: options.metadata,
+        note: `No transport registered for '${transport}'. Register a transport handler to enable real delivery.`,
+    });
 }
 /**
  * Generate a unique message ID
  */
 function generateMessageId(prefix = 'msg') {
-    return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    return generateRequestId(prefix);
 }
 //# sourceMappingURL=notify.js.map

package/dist/notify.js.map

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

package/dist/role.d.ts

@@ -13,7 +13,7 @@ import type { WorkerRole } from './types.js';
  *
  * @example
  * ```ts
- * const engineer = Role({
+ * const engineer = defineRole({
  *   name: 'Software Engineer',
  *   description: 'Builds and maintains software systems',
  *   responsibilities: [
@@ -29,7 +29,7 @@ import type { WorkerRole } from './types.js';
  *
  * @example
  * ```ts
- * const supportAgent = Role({
+ * const supportAgent = defineRole({
  *   name: 'Customer Support Agent',
  *   description: 'Assists customers with inquiries and issues',
  *   responsibilities: [
@@ -42,12 +42,13 @@ import type { WorkerRole } from './types.js';
  * })
  * ```
  */
-export declare function Role(definition: Omit<WorkerRole, 'type'> & {
+export declare function defineRole(definition: Omit<WorkerRole, 'type'> & {
     type?: WorkerRole['type'];
 }): WorkerRole;
-export declare namespace Role {
+export declare namespace defineRole {
     var ai: (definition: Omit<WorkerRole, "type">) => WorkerRole;
     var human: (definition: Omit<WorkerRole, "type">) => WorkerRole;
     var hybrid: (definition: Omit<WorkerRole, "type">) => WorkerRole;
 }
+export { defineRole as Role };
 //# sourceMappingURL=role.d.ts.map

package/dist/role.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../src/role.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAI5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;CAAE,GACnE,UAAU,CAKZ;yBAPe,UAAU;yBAyBG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,KAAG,UAAU;4BAuBlC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,KAAG,UAAU;6BAsBpC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,KAAG,UAAU;;AAOtE,OAAO,EAAE,UAAU,IAAI,IAAI,EAAE,CAAA"}

package/dist/role.js

@@ -1,6 +1,7 @@
 /**
  * Role definition for digital workers
  */
+// Note: Role type is re-exported from types.ts which imports from org.ai
 /**
  * Define a worker role
  *
@@ -12,7 +13,7 @@
  *
  * @example
  * ```ts
- * const engineer = Role({
+ * const engineer = defineRole({
  *   name: 'Software Engineer',
  *   description: 'Builds and maintains software systems',
  *   responsibilities: [
@@ -28,7 +29,7 @@
  *
  * @example
  * ```ts
- * const supportAgent = Role({
+ * const supportAgent = defineRole({
  *   name: 'Customer Support Agent',
  *   description: 'Assists customers with inquiries and issues',
  *   responsibilities: [
@@ -41,10 +42,10 @@
  * })
  * ```
  */
-export function Role(definition) {
+export function defineRole(definition) {
     return {
-        type: 'hybrid', // Default to hybrid (can be AI or human)
         ...definition,
+        type: definition.type ?? 'hybrid',
     };
 }
 /**
@@ -52,7 +53,7 @@ export function Role(definition) {
  *
  * @example
  * ```ts
- * const dataAnalyst = Role.ai({
+ * const dataAnalyst = defineRole.ai({
  *   name: 'Data Analyst',
  *   description: 'Analyzes data and generates insights',
  *   responsibilities: [
@@ -63,7 +64,7 @@ export function Role(definition) {
  * })
  * ```
  */
-Role.ai = (definition) => ({
+defineRole.ai = (definition) => ({
     ...definition,
     type: 'ai',
 });
@@ -72,7 +73,7 @@ Role.ai = (definition) => ({
  *
  * @example
  * ```ts
- * const manager = Role.human({
+ * const manager = defineRole.human({
  *   name: 'Engineering Manager',
  *   description: 'Leads engineering team and makes strategic decisions',
  *   responsibilities: [
@@ -84,7 +85,7 @@ Role.ai = (definition) => ({
  * })
  * ```
  */
-Role.human = (definition) => ({
+defineRole.human = (definition) => ({
     ...definition,
     type: 'human',
 });
@@ -93,7 +94,7 @@ Role.human = (definition) => ({
  *
  * @example
  * ```ts
- * const contentWriter = Role.hybrid({
+ * const contentWriter = defineRole.hybrid({
  *   name: 'Content Writer',
  *   description: 'Creates written content for various channels',
  *   responsibilities: [
@@ -104,8 +105,10 @@ Role.human = (definition) => ({
  * })
  * ```
  */
-Role.hybrid = (definition) => ({
+defineRole.hybrid = (definition) => ({
     ...definition,
     type: 'hybrid',
 });
+// Legacy alias for backward compatibility
+export { defineRole as Role };
 //# sourceMappingURL=role.js.map

package/dist/role.js.map

@@ -1 +1 @@
-{"version":3,"file":"role.js","sourceRoot":"","sources":["../src/role.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,IAAI,CAAC,UAAoE;IACvF,OAAO;QACL,IAAI,EAAE,QAAQ,EAAE,yCAAyC;QACzD,GAAG,UAAU;KACd,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,IAAI,CAAC,EAAE,GAAG,CAAC,UAAoC,EAAc,EAAE,CAAC,CAAC;IAC/D,GAAG,UAAU;IACb,IAAI,EAAE,IAAI;CACX,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,IAAI,CAAC,KAAK,GAAG,CAAC,UAAoC,EAAc,EAAE,CAAC,CAAC;IAClE,GAAG,UAAU;IACb,IAAI,EAAE,OAAO;CACd,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;GAeG;AACH,IAAI,CAAC,MAAM,GAAG,CAAC,UAAoC,EAAc,EAAE,CAAC,CAAC;IACnE,GAAG,UAAU;IACb,IAAI,EAAE,QAAQ;CACf,CAAC,CAAA"}
+{"version":3,"file":"role.js","sourceRoot":"","sources":["../src/role.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,yEAAyE;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,UAAU,CACxB,UAAoE;IAEpE,OAAO;QACL,GAAG,UAAU;QACb,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,QAAQ;KACpB,CAAA;AACjB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,UAAU,CAAC,EAAE,GAAG,CAAC,UAAoC,EAAc,EAAE,CACnE,CAAC;IACC,GAAG,UAAU;IACb,IAAI,EAAE,IAAI;CACI,CAAA,CAAA;AAElB;;;;;;;;;;;;;;;;GAgBG;AACH,UAAU,CAAC,KAAK,GAAG,CAAC,UAAoC,EAAc,EAAE,CACtE,CAAC;IACC,GAAG,UAAU;IACb,IAAI,EAAE,OAAO;CACC,CAAA,CAAA;AAElB;;;;;;;;;;;;;;;GAeG;AACH,UAAU,CAAC,MAAM,GAAG,CAAC,UAAoC,EAAc,EAAE,CACvE,CAAC;IACC,GAAG,UAAU;IACb,IAAI,EAAE,QAAQ;CACA,CAAA,CAAA;AAElB,0CAA0C;AAC1C,OAAO,EAAE,UAAU,IAAI,IAAI,EAAE,CAAA"}