digital-workers 0.1.1 → 2.0.2

package/dist/generate.js

@@ -0,0 +1,299 @@
+/**
+ * Content generation functionality for digital workers
+ */
+import { generateObject, generateText } from 'ai-functions';
+/**
+ * Generate content
+ *
+ * Uses AI to generate various types of content including text,
+ * code, structured data, images, video, and audio.
+ *
+ * @param prompt - What to generate
+ * @param options - Generation options
+ * @returns Promise resolving to generated content
+ *
+ * @example
+ * ```ts
+ * // Generate text content
+ * const result = await generate('Write a product description for wireless earbuds', {
+ *   type: 'text',
+ *   instructions: 'Focus on sound quality and battery life. Keep it under 100 words.',
+ * })
+ * console.log(result.content)
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Generate structured data
+ * const result = await generate('Create a user profile', {
+ *   type: 'structured',
+ *   schema: {
+ *     name: 'User full name',
+ *     email: 'Email address',
+ *     role: 'admin | user | guest',
+ *     preferences: {
+ *       theme: 'light | dark',
+ *       notifications: 'Whether to receive notifications (boolean)',
+ *     },
+ *   },
+ * })
+ * console.log(result.content) // { name: '...', email: '...', ... }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Generate code
+ * const result = await generate('Create a React component for a todo list', {
+ *   type: 'code',
+ *   instructions: 'Use TypeScript and hooks. Include prop types.',
+ * })
+ * console.log(result.content) // TypeScript React component code
+ * ```
+ */
+export async function generate(prompt, options = {}) {
+    const { type = 'text', schema, instructions, model = 'sonnet', } = options;
+    const startTime = Date.now();
+    switch (type) {
+        case 'text': {
+            const systemPrompt = instructions
+                ? `You are an expert content generator. ${instructions}`
+                : 'You are an expert content generator.';
+            const result = await generateText({
+                model,
+                prompt,
+                system: systemPrompt,
+            });
+            return {
+                content: result.text,
+                type: 'text',
+                metadata: {
+                    model,
+                    tokens: result.usage?.totalTokens,
+                    duration: Date.now() - startTime,
+                },
+            };
+        }
+        case 'structured': {
+            if (!schema) {
+                throw new Error('Schema is required for structured content generation');
+            }
+            const systemPrompt = instructions
+                ? `You are an expert at generating structured data. ${instructions}`
+                : 'You are an expert at generating structured data.';
+            const result = await generateObject({
+                model,
+                schema,
+                prompt,
+                system: systemPrompt,
+            });
+            return {
+                content: result.object,
+                type: 'structured',
+                metadata: {
+                    model,
+                    tokens: result.usage?.totalTokens,
+                    duration: Date.now() - startTime,
+                },
+            };
+        }
+        case 'code': {
+            const systemPrompt = instructions
+                ? `You are an expert programmer. Generate clean, well-documented code. ${instructions}`
+                : 'You are an expert programmer. Generate clean, well-documented code.';
+            const result = await generateObject({
+                model,
+                schema: {
+                    code: 'The generated code',
+                    language: 'Programming language used',
+                    explanation: 'Brief explanation of the code',
+                },
+                prompt,
+                system: systemPrompt,
+            });
+            const codeResult = result.object;
+            return {
+                content: codeResult.code,
+                type: 'code',
+                metadata: {
+                    model,
+                    tokens: result.usage?.totalTokens,
+                    duration: Date.now() - startTime,
+                    language: codeResult.language,
+                    explanation: codeResult.explanation,
+                },
+            };
+        }
+        case 'image': {
+            // Image generation would integrate with image generation APIs
+            // For now, return a placeholder
+            throw new Error('Image generation not yet implemented');
+        }
+        case 'video': {
+            // Video generation would integrate with video generation APIs
+            throw new Error('Video generation not yet implemented');
+        }
+        case 'audio': {
+            // Audio generation would integrate with audio generation APIs
+            throw new Error('Audio generation not yet implemented');
+        }
+        default:
+            throw new Error(`Unknown content type: ${type}`);
+    }
+}
+/**
+ * Generate multiple variations of content
+ *
+ * @param prompt - What to generate
+ * @param count - Number of variations to generate
+ * @param options - Generation options
+ * @returns Promise resolving to array of generated content
+ *
+ * @example
+ * ```ts
+ * const variations = await generate.variations(
+ *   'Write a catchy headline for a coffee shop',
+ *   5,
+ *   { type: 'text' }
+ * )
+ *
+ * variations.forEach((v, i) => {
+ *   console.log(`${i + 1}. ${v.content}`)
+ * })
+ * ```
+ */
+generate.variations = async (prompt, count, options = {}) => {
+    return Promise.all(Array.from({ length: count }, () => generate(prompt, options)));
+};
+/**
+ * Generate content with a specific tone
+ *
+ * @param prompt - What to generate
+ * @param tone - The desired tone
+ * @param options - Generation options
+ * @returns Promise resolving to generated content
+ *
+ * @example
+ * ```ts
+ * const professional = await generate.withTone(
+ *   'Write an email declining a meeting',
+ *   'professional',
+ *   { type: 'text' }
+ * )
+ *
+ * const friendly = await generate.withTone(
+ *   'Write an email declining a meeting',
+ *   'friendly',
+ *   { type: 'text' }
+ * )
+ * ```
+ */
+generate.withTone = async (prompt, tone, options = {}) => {
+    const toneInstructions = {
+        professional: 'Use a professional, business-appropriate tone.',
+        casual: 'Use a casual, conversational tone.',
+        friendly: 'Use a warm, friendly tone.',
+        formal: 'Use a formal, ceremonious tone.',
+        humorous: 'Use a light, humorous tone.',
+        empathetic: 'Use an empathetic, understanding tone.',
+    };
+    return generate(prompt, {
+        ...options,
+        instructions: `${toneInstructions[tone]} ${options.instructions || ''}`,
+    });
+};
+/**
+ * Generate content for a specific audience
+ *
+ * @param prompt - What to generate
+ * @param audience - Target audience
+ * @param options - Generation options
+ * @returns Promise resolving to generated content
+ *
+ * @example
+ * ```ts
+ * const technical = await generate.forAudience(
+ *   'Explain how OAuth works',
+ *   'software engineers',
+ *   { type: 'text' }
+ * )
+ *
+ * const nonTechnical = await generate.forAudience(
+ *   'Explain how OAuth works',
+ *   'non-technical business users',
+ *   { type: 'text' }
+ * )
+ * ```
+ */
+generate.forAudience = async (prompt, audience, options = {}) => {
+    return generate(prompt, {
+        ...options,
+        instructions: `Write for ${audience}. ${options.instructions || ''}`,
+    });
+};
+/**
+ * Generate content with specific length
+ *
+ * @param prompt - What to generate
+ * @param length - Desired length
+ * @param options - Generation options
+ * @returns Promise resolving to generated content
+ *
+ * @example
+ * ```ts
+ * const short = await generate.withLength(
+ *   'Describe our company',
+ *   'short',
+ *   { type: 'text' }
+ * )
+ *
+ * const detailed = await generate.withLength(
+ *   'Describe our company',
+ *   'detailed',
+ *   { type: 'text' }
+ * )
+ * ```
+ */
+generate.withLength = async (prompt, length, options = {}) => {
+    const lengthInstructions = {
+        brief: 'Keep it very brief - 1-2 sentences maximum.',
+        short: 'Keep it short - around 50-100 words.',
+        medium: 'Use a medium length - around 150-300 words.',
+        long: 'Write a longer piece - around 400-600 words.',
+        detailed: 'Write a detailed, comprehensive piece - 800+ words.',
+    };
+    return generate(prompt, {
+        ...options,
+        instructions: `${lengthInstructions[length]} ${options.instructions || ''}`,
+    });
+};
+/**
+ * Generate content by iteratively refining it
+ *
+ * @param prompt - What to generate
+ * @param refinements - Refinement prompts to apply
+ * @param options - Generation options
+ * @returns Promise resolving to refined content
+ *
+ * @example
+ * ```ts
+ * const refined = await generate.refine(
+ *   'Write a product tagline',
+ *   [
+ *     'Make it more memorable',
+ *     'Add a sense of urgency',
+ *     'Emphasize the value proposition',
+ *   ],
+ *   { type: 'text' }
+ * )
+ * ```
+ */
+generate.refine = async (prompt, refinements, options = {}) => {
+    // Generate initial content
+    let result = await generate(prompt, options);
+    // Apply refinements iteratively
+    for (const refinement of refinements) {
+        result = await generate(`Refine the following content: ${result.content}\n\nRefinement: ${refinement}`, options);
+    }
+    return result;
+};
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/goals.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Goals definition for digital workers
+ */
+import type { WorkerGoals, KPI } from './types.js';
+/**
+ * Define worker goals
+ *
+ * Goals provide direction and metrics for workers and teams.
+ * Supports short-term, long-term, and strategic objectives with KPIs.
+ *
+ * @param definition - Goals definition
+ * @returns The defined goals
+ *
+ * @example
+ * ```ts
+ * const engineeringGoals = Goals({
+ *   shortTerm: [
+ *     'Complete Q1 roadmap features',
+ *     'Reduce bug backlog by 30%',
+ *     'Improve test coverage to 80%',
+ *   ],
+ *   longTerm: [
+ *     'Migrate to microservices architecture',
+ *     'Achieve 99.9% uptime',
+ *     'Build scalable platform for 1M users',
+ *   ],
+ *   strategic: [
+ *     'Become industry leader in performance',
+ *     'Enable product innovation through technology',
+ *   ],
+ *   metrics: [
+ *     {
+ *       name: 'Deployment Frequency',
+ *       description: 'Number of deployments per week',
+ *       current: 5,
+ *       target: 10,
+ *       unit: 'deploys/week',
+ *       trend: 'up',
+ *       period: 'weekly',
+ *     },
+ *     {
+ *       name: 'Mean Time to Recovery',
+ *       description: 'Average time to recover from incidents',
+ *       current: 45,
+ *       target: 30,
+ *       unit: 'minutes',
+ *       trend: 'down',
+ *       period: 'monthly',
+ *     },
+ *   ],
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * const supportGoals = Goals({
+ *   shortTerm: [
+ *     'Achieve 95% customer satisfaction',
+ *     'Reduce average response time to < 5 min',
+ *   ],
+ *   longTerm: [
+ *     'Build comprehensive knowledge base',
+ *     'Implement AI-first support workflow',
+ *   ],
+ *   metrics: [
+ *     {
+ *       name: 'Customer Satisfaction',
+ *       description: 'CSAT score from surveys',
+ *       current: 92,
+ *       target: 95,
+ *       unit: '%',
+ *       trend: 'up',
+ *       period: 'monthly',
+ *     },
+ *   ],
+ * })
+ * ```
+ */
+export declare function Goals(definition: WorkerGoals): WorkerGoals;
+export declare namespace Goals {
+    var addShortTerm: (goals: WorkerGoals, goal: string) => WorkerGoals;
+    var addLongTerm: (goals: WorkerGoals, goal: string) => WorkerGoals;
+    var addStrategic: (goals: WorkerGoals, goal: string) => WorkerGoals;
+    var addMetric: (goals: WorkerGoals, kpi: KPI) => WorkerGoals;
+    var updateMetric: (goals: WorkerGoals, name: string, updates: Partial<Omit<KPI, "name">>) => WorkerGoals;
+    var progress: (kpi: Pick<KPI, "current" | "target">) => number;
+    var onTrack: (kpi: Pick<KPI, "current" | "target">, threshold?: number) => boolean;
+}
+//# sourceMappingURL=goals.d.ts.map

package/dist/goals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goals.d.ts","sourceRoot":"","sources":["../src/goals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,wBAAgB,KAAK,CAAC,UAAU,EAAE,WAAW,GAAG,WAAW,CAE1D;yBAFe,KAAK;8BAgBQ,WAAW,QAAQ,MAAM,KAAG,WAAW;6BAiBxC,WAAW,QAAQ,MAAM,KAAG,WAAW;8BAiBtC,WAAW,QAAQ,MAAM,KAAG,WAAW;2BAyB1C,WAAW,OAAO,GAAG,KAAG,WAAW;8BAsBpD,WAAW,QACZ,MAAM,WACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,KAClC,WAAW;wBAmBS,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,QAAQ,CAAC,KAAG,MAAM;uBAkBzC,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,QAAQ,CAAC,yBAAoB,OAAO"}

package/dist/goals.js

@@ -0,0 +1,206 @@
+/**
+ * Goals definition for digital workers
+ */
+/**
+ * Define worker goals
+ *
+ * Goals provide direction and metrics for workers and teams.
+ * Supports short-term, long-term, and strategic objectives with KPIs.
+ *
+ * @param definition - Goals definition
+ * @returns The defined goals
+ *
+ * @example
+ * ```ts
+ * const engineeringGoals = Goals({
+ *   shortTerm: [
+ *     'Complete Q1 roadmap features',
+ *     'Reduce bug backlog by 30%',
+ *     'Improve test coverage to 80%',
+ *   ],
+ *   longTerm: [
+ *     'Migrate to microservices architecture',
+ *     'Achieve 99.9% uptime',
+ *     'Build scalable platform for 1M users',
+ *   ],
+ *   strategic: [
+ *     'Become industry leader in performance',
+ *     'Enable product innovation through technology',
+ *   ],
+ *   metrics: [
+ *     {
+ *       name: 'Deployment Frequency',
+ *       description: 'Number of deployments per week',
+ *       current: 5,
+ *       target: 10,
+ *       unit: 'deploys/week',
+ *       trend: 'up',
+ *       period: 'weekly',
+ *     },
+ *     {
+ *       name: 'Mean Time to Recovery',
+ *       description: 'Average time to recover from incidents',
+ *       current: 45,
+ *       target: 30,
+ *       unit: 'minutes',
+ *       trend: 'down',
+ *       period: 'monthly',
+ *     },
+ *   ],
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * const supportGoals = Goals({
+ *   shortTerm: [
+ *     'Achieve 95% customer satisfaction',
+ *     'Reduce average response time to < 5 min',
+ *   ],
+ *   longTerm: [
+ *     'Build comprehensive knowledge base',
+ *     'Implement AI-first support workflow',
+ *   ],
+ *   metrics: [
+ *     {
+ *       name: 'Customer Satisfaction',
+ *       description: 'CSAT score from surveys',
+ *       current: 92,
+ *       target: 95,
+ *       unit: '%',
+ *       trend: 'up',
+ *       period: 'monthly',
+ *     },
+ *   ],
+ * })
+ * ```
+ */
+export function Goals(definition) {
+    return definition;
+}
+/**
+ * Add a short-term goal
+ *
+ * @param goals - The goals object
+ * @param goal - Goal to add
+ * @returns Updated goals
+ *
+ * @example
+ * ```ts
+ * const updated = Goals.addShortTerm(engineeringGoals, 'Complete security audit')
+ * ```
+ */
+Goals.addShortTerm = (goals, goal) => ({
+    ...goals,
+    shortTerm: [...goals.shortTerm, goal],
+});
+/**
+ * Add a long-term goal
+ *
+ * @param goals - The goals object
+ * @param goal - Goal to add
+ * @returns Updated goals
+ *
+ * @example
+ * ```ts
+ * const updated = Goals.addLongTerm(engineeringGoals, 'Build ML platform')
+ * ```
+ */
+Goals.addLongTerm = (goals, goal) => ({
+    ...goals,
+    longTerm: [...goals.longTerm, goal],
+});
+/**
+ * Add a strategic goal
+ *
+ * @param goals - The goals object
+ * @param goal - Goal to add
+ * @returns Updated goals
+ *
+ * @example
+ * ```ts
+ * const updated = Goals.addStrategic(engineeringGoals, 'Become carbon neutral')
+ * ```
+ */
+Goals.addStrategic = (goals, goal) => ({
+    ...goals,
+    strategic: [...(goals.strategic || []), goal],
+});
+/**
+ * Add a KPI metric
+ *
+ * @param goals - The goals object
+ * @param kpi - KPI to add
+ * @returns Updated goals
+ *
+ * @example
+ * ```ts
+ * const updated = Goals.addMetric(engineeringGoals, {
+ *   name: 'Code Quality',
+ *   description: 'Code quality score from SonarQube',
+ *   current: 85,
+ *   target: 90,
+ *   unit: 'score',
+ *   trend: 'up',
+ *   period: 'weekly',
+ * })
+ * ```
+ */
+Goals.addMetric = (goals, kpi) => ({
+    ...goals,
+    metrics: [...(goals.metrics || []), kpi],
+});
+/**
+ * Update a KPI metric
+ *
+ * @param goals - The goals object
+ * @param name - Name of KPI to update
+ * @param updates - Fields to update
+ * @returns Updated goals
+ *
+ * @example
+ * ```ts
+ * const updated = Goals.updateMetric(engineeringGoals, 'Deployment Frequency', {
+ *   current: 8,
+ *   trend: 'up',
+ * })
+ * ```
+ */
+Goals.updateMetric = (goals, name, updates) => ({
+    ...goals,
+    metrics: goals.metrics?.map((kpi) => kpi.name === name ? { ...kpi, ...updates } : kpi),
+});
+/**
+ * Get progress for a KPI (0-1)
+ *
+ * @param kpi - The KPI
+ * @returns Progress value between 0 and 1
+ *
+ * @example
+ * ```ts
+ * const kpi = { current: 75, target: 100 }
+ * const progress = Goals.progress(kpi) // 0.75
+ * ```
+ */
+Goals.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 considered "on track" (default: 0.8)
+ * @returns Whether the KPI is on track
+ *
+ * @example
+ * ```ts
+ * const kpi = { current: 85, target: 100 }
+ * const onTrack = Goals.onTrack(kpi) // true (85% >= 80% threshold)
+ * ```
+ */
+Goals.onTrack = (kpi, threshold = 0.8) => {
+    return Goals.progress(kpi) >= threshold;
+};
+//# sourceMappingURL=goals.js.map

package/dist/goals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goals.js","sourceRoot":"","sources":["../src/goals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,MAAM,UAAU,KAAK,CAAC,UAAuB;IAC3C,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,KAAK,CAAC,YAAY,GAAG,CAAC,KAAkB,EAAE,IAAY,EAAe,EAAE,CAAC,CAAC;IACvE,GAAG,KAAK;IACR,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC;CACtC,CAAC,CAAA;AAEF;;;;;;;;;;;GAWG;AACH,KAAK,CAAC,WAAW,GAAG,CAAC,KAAkB,EAAE,IAAY,EAAe,EAAE,CAAC,CAAC;IACtE,GAAG,KAAK;IACR,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC;CACpC,CAAC,CAAA;AAEF;;;;;;;;;;;GAWG;AACH,KAAK,CAAC,YAAY,GAAG,CAAC,KAAkB,EAAE,IAAY,EAAe,EAAE,CAAC,CAAC;IACvE,GAAG,KAAK;IACR,SAAS,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC;CAC9C,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,KAAK,CAAC,SAAS,GAAG,CAAC,KAAkB,EAAE,GAAQ,EAAe,EAAE,CAAC,CAAC;IAChE,GAAG,KAAK;IACR,OAAO,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC;CACzC,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;GAeG;AACH,KAAK,CAAC,YAAY,GAAG,CACnB,KAAkB,EAClB,IAAY,EACZ,OAAmC,EACtB,EAAE,CAAC,CAAC;IACjB,GAAG,KAAK;IACR,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAClC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CACjD;CACF,CAAC,CAAA;AAEF;;;;;;;;;;;GAWG;AACH,KAAK,CAAC,QAAQ,GAAG,CAAC,GAAoC,EAAU,EAAE;IAChE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;AAC3D,CAAC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,KAAK,CAAC,OAAO,GAAG,CAAC,GAAoC,EAAE,SAAS,GAAG,GAAG,EAAW,EAAE;IACjF,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS,CAAA;AACzC,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * digital-workers - Abstract interface for organizing digital work
+ *
+ * This package provides the foundational abstraction for structuring work
+ * independent of whether AI agents or humans perform individual tasks. It
+ * defines a unified Worker interface that enables workflows to be designed
+ * once and executed by any combination of AI and human workers.
+ *
+ * Package relationships:
+ * - `autonomous-agents` - Implements Worker for AI agents
+ * - `human-in-the-loop` - Implements Worker for humans
+ * - `ai-workflows` - Uses digital-workers to orchestrate execution
+ *
+ * The key insight: define WHAT work needs to happen, not WHO does it.
+ *
+ * ## Worker Actions
+ *
+ * Worker actions (notify, ask, approve, decide, do) are durable workflow actions
+ * that integrate with ai-workflows. They can be invoked via:
+ *
+ * 1. `$.do('Worker.notify', data)` - Durable action
+ * 2. `$.send('Worker.notify', data)` - Fire and forget
+ * 3. `$.notify(target, message)` - Convenience method (when using withWorkers)
+ *
+ * @example
+ * ```ts
+ * import { Workflow } from 'ai-workflows'
+ * import { registerWorkerActions, withWorkers } from 'digital-workers'
+ *
+ * const workflow = Workflow($ => {
+ *   registerWorkerActions($)
+ *   const worker$ = withWorkers($)
+ *
+ *   $.on.Expense.submitted(async (expense) => {
+ *     await worker$.notify(finance, `New expense: ${expense.amount}`)
+ *
+ *     const approval = await worker$.approve(
+ *       `Expense: $${expense.amount}`,
+ *       manager,
+ *       { via: 'slack' }
+ *     )
+ *
+ *     if (approval.approved) {
+ *       await worker$.notify(expense.submitter, 'Expense approved!')
+ *     }
+ *   })
+ * })
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type * from './types.js';
+export { registerWorkerActions, withWorkers, handleNotify, handleAsk, handleApprove, handleDecide, handleDo, notify as notifyAction, ask as askAction, approve as approveAction, decide as decideAction, } from './actions.js';
+export { Role } from './role.js';
+export { Team } from './team.js';
+export { Goals } from './goals.js';
+export { approve } from './approve.js';
+export { ask } from './ask.js';
+export { do } from './do.js';
+export { decide } from './decide.js';
+export { generate } from './generate.js';
+export { is } from './is.js';
+export { notify } from './notify.js';
+export { kpis, okrs } from './kpis.js';
+export { WorkerVerbs } from './types.js';
+export type { Transport, TransportConfig, MessagePayload, MessageAction, DeliveryResult, Address, TransportHandler, } from './transports.js';
+export { channelToTransport, getWorkerTransports, getTeamTransports, resolveAddress, resolveWorkerAddresses, getPrimaryAddress, registerTransport, getTransportHandler, hasTransport, listTransports, sendViaTransport, sendToMultipleTransports, buildNotifyPayload, buildAskPayload, buildApprovePayload, toDigitalToolsMessage, fromDigitalToolsMessage, MessageTypeMapping, CallTypeMapping, } from './transports.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAGH,mBAAmB,YAAY,CAAA;AAG/B,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,MAAM,IAAI,YAAY,EACtB,GAAG,IAAI,SAAS,EAChB,OAAO,IAAI,aAAa,EACxB,MAAM,IAAI,YAAY,GACvB,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,YAAY,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,EACd,OAAO,EACP,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,GAChB,MAAM,iBAAiB,CAAA"}