digital-workers 0.1.1 → 2.0.1

package/dist/index.js

@@ -0,0 +1,69 @@
+/**
+ * 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 workflow integration
+export { registerWorkerActions, withWorkers, handleNotify, handleAsk, handleApprove, handleDecide, handleDo, notify as notifyAction, ask as askAction, approve as approveAction, decide as decideAction, } from './actions.js';
+// Export core functions
+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 verb definitions
+export { WorkerVerbs } from './types.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.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAKH,8BAA8B;AAC9B,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;AAErB,wBAAwB;AACxB,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;AAEtC,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAaxC,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"}

package/dist/is.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Type validation and checking functionality for digital workers
+ */
+import { type SimpleSchema } from 'ai-functions';
+import type { TypeCheckResult, IsOptions } from './types.js';
+/**
+ * Check if a value matches an expected type or schema
+ *
+ * Uses AI-powered validation for complex types and schemas.
+ * Can also perform type coercion when enabled.
+ *
+ * @param value - The value to check
+ * @param type - Type name or schema to validate against
+ * @param options - Validation options
+ * @returns Promise resolving to validation result
+ *
+ * @example
+ * ```ts
+ * // Simple type checking
+ * const result = await is('hello@example.com', 'email')
+ * console.log(result.valid) // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Schema validation
+ * const result = await is(
+ *   { name: 'John', age: 30 },
+ *   {
+ *     name: 'Full name',
+ *     age: 'Age in years (number)',
+ *     email: 'Email address',
+ *   }
+ * )
+ * console.log(result.valid) // false - missing email
+ * console.log(result.errors) // ['Missing required field: email']
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With coercion
+ * const result = await is('123', 'number', { coerce: true })
+ * console.log(result.valid) // true
+ * console.log(result.value) // 123 (as number)
+ * ```
+ */
+export declare function is(value: unknown, type: string | SimpleSchema, options?: IsOptions): Promise<TypeCheckResult>;
+export declare namespace is {
+    var email: (value: unknown) => Promise<TypeCheckResult>;
+    var url: (value: unknown) => Promise<TypeCheckResult>;
+    var date: (value: unknown, options?: IsOptions) => Promise<TypeCheckResult>;
+    var custom: (value: unknown, validator: (v: unknown) => boolean | Promise<boolean>) => Promise<TypeCheckResult>;
+}
+//# sourceMappingURL=is.d.ts.map

package/dist/is.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is.d.ts","sourceRoot":"","sources":["../src/is.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAsB,EAAE,CACtB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,GAAG,YAAY,EAC3B,OAAO,GAAE,SAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAU1B;yBAdqB,EAAE;uBAqNC,OAAO,KAAG,OAAO,CAAC,eAAe,CAAC;qBAiBpC,OAAO,KAAG,OAAO,CAAC,eAAe,CAAC;sBA6BjC,OAAO,YAAW,SAAS,KAAQ,OAAO,CAAC,eAAe,CAAC;wBA+C1E,OAAO,aACH,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KACpD,OAAO,CAAC,eAAe,CAAC"}

package/dist/is.js

@@ -0,0 +1,318 @@
+/**
+ * Type validation and checking functionality for digital workers
+ */
+import { generateObject } from 'ai-functions';
+import { schema as convertSchema } from 'ai-functions';
+/**
+ * Check if a value matches an expected type or schema
+ *
+ * Uses AI-powered validation for complex types and schemas.
+ * Can also perform type coercion when enabled.
+ *
+ * @param value - The value to check
+ * @param type - Type name or schema to validate against
+ * @param options - Validation options
+ * @returns Promise resolving to validation result
+ *
+ * @example
+ * ```ts
+ * // Simple type checking
+ * const result = await is('hello@example.com', 'email')
+ * console.log(result.valid) // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Schema validation
+ * const result = await is(
+ *   { name: 'John', age: 30 },
+ *   {
+ *     name: 'Full name',
+ *     age: 'Age in years (number)',
+ *     email: 'Email address',
+ *   }
+ * )
+ * console.log(result.valid) // false - missing email
+ * console.log(result.errors) // ['Missing required field: email']
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With coercion
+ * const result = await is('123', 'number', { coerce: true })
+ * console.log(result.valid) // true
+ * console.log(result.value) // 123 (as number)
+ * ```
+ */
+export async function is(value, type, options = {}) {
+    const { coerce = false, strict = false } = options;
+    // Handle simple type strings
+    if (typeof type === 'string') {
+        return validateSimpleType(value, type, { coerce, strict });
+    }
+    // Handle schema validation
+    return validateSchema(value, type, { coerce, strict });
+}
+/**
+ * Validate against a simple type name
+ */
+async function validateSimpleType(value, type, options) {
+    const { coerce, strict } = options;
+    // Built-in JavaScript types
+    const builtInTypes = {
+        string: (v) => typeof v === 'string',
+        number: (v) => typeof v === 'number' && !isNaN(v),
+        boolean: (v) => typeof v === 'boolean',
+        object: (v) => typeof v === 'object' && v !== null && !Array.isArray(v),
+        array: (v) => Array.isArray(v),
+        null: (v) => v === null,
+        undefined: (v) => v === undefined,
+        function: (v) => typeof v === 'function',
+    };
+    // Check built-in types first
+    if (type in builtInTypes) {
+        const isValid = builtInTypes[type](value);
+        if (!isValid && coerce) {
+            // Try to coerce the value
+            const coerced = coerceValue(value, type);
+            if (coerced.success) {
+                return {
+                    valid: true,
+                    value: coerced.value,
+                };
+            }
+        }
+        return {
+            valid: isValid,
+            value: isValid ? value : undefined,
+            errors: isValid ? undefined : [`Value is not a valid ${type}`],
+        };
+    }
+    // Use AI for complex type validation
+    const result = await generateObject({
+        model: 'sonnet',
+        schema: {
+            valid: 'Whether the value matches the expected type (boolean)',
+            errors: ['List of validation errors if invalid'],
+            coercedValue: coerce ? 'The value coerced to the expected type' : undefined,
+        },
+        system: `You are a type validation expert. Determine if a value matches an expected type.
+
+${coerce ? 'If the value can be coerced to the expected type, provide the coerced value.' : ''}
+${strict ? 'Be strict in your validation - require exact type matches.' : 'Be flexible - allow reasonable type conversions.'}`,
+        prompt: `Validate if this value matches the expected type:
+
+Value: ${JSON.stringify(value)}
+Type: ${type}
+
+Determine if the value is valid for this type.`,
+    });
+    const validation = result.object;
+    return {
+        valid: validation.valid,
+        value: coerce && validation.coercedValue !== undefined ? validation.coercedValue : value,
+        errors: validation.valid ? undefined : validation.errors,
+    };
+}
+/**
+ * Validate against a schema
+ */
+async function validateSchema(value, schema, options) {
+    const { coerce, strict } = options;
+    try {
+        // Convert SimpleSchema to Zod schema
+        const zodSchema = convertSchema(schema);
+        // Parse the value
+        const parsed = zodSchema.parse(value);
+        return {
+            valid: true,
+            value: parsed,
+        };
+    }
+    catch (error) {
+        if (strict) {
+            return {
+                valid: false,
+                errors: [error.message],
+            };
+        }
+        // Use AI for more flexible validation
+        const result = await generateObject({
+            model: 'sonnet',
+            schema: {
+                valid: 'Whether the value matches the schema (boolean)',
+                errors: ['List of validation errors'],
+                coercedValue: coerce ? 'The value with corrections/coercions applied' : undefined,
+            },
+            system: `You are a schema validation expert. Validate a value against a schema.
+
+${coerce ? 'Try to coerce the value to match the schema where reasonable.' : ''}
+Be helpful - provide clear error messages.`,
+            prompt: `Validate this value against the schema:
+
+Value:
+${JSON.stringify(value, null, 2)}
+
+Schema:
+${JSON.stringify(schema, null, 2)}
+
+Check if the value matches the schema structure and types.`,
+        });
+        const validation = result.object;
+        return {
+            valid: validation.valid,
+            value: coerce && validation.coercedValue !== undefined ? validation.coercedValue : value,
+            errors: validation.valid ? undefined : validation.errors,
+        };
+    }
+}
+/**
+ * Try to coerce a value to a specific type
+ */
+function coerceValue(value, type) {
+    try {
+        switch (type) {
+            case 'string':
+                return { success: true, value: String(value) };
+            case 'number':
+                const num = Number(value);
+                return { success: !isNaN(num), value: num };
+            case 'boolean':
+                if (typeof value === 'string') {
+                    const lower = value.toLowerCase();
+                    if (lower === 'true' || lower === '1') {
+                        return { success: true, value: true };
+                    }
+                    if (lower === 'false' || lower === '0') {
+                        return { success: true, value: false };
+                    }
+                }
+                return { success: true, value: Boolean(value) };
+            case 'array':
+                if (Array.isArray(value)) {
+                    return { success: true, value };
+                }
+                return { success: true, value: [value] };
+            default:
+                return { success: false };
+        }
+    }
+    catch {
+        return { success: false };
+    }
+}
+/**
+ * Check if a value is valid email
+ *
+ * @param value - Value to check
+ * @returns Promise resolving to validation result
+ *
+ * @example
+ * ```ts
+ * const result = await is.email('test@example.com')
+ * console.log(result.valid) // true
+ * ```
+ */
+is.email = async (value) => {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    const valid = typeof value === 'string' && emailRegex.test(value);
+    return {
+        valid,
+        value: valid ? value : undefined,
+        errors: valid ? undefined : ['Invalid email format'],
+    };
+};
+/**
+ * Check if a value is a valid URL
+ *
+ * @param value - Value to check
+ * @returns Promise resolving to validation result
+ */
+is.url = async (value) => {
+    try {
+        if (typeof value !== 'string') {
+            return {
+                valid: false,
+                errors: ['Value must be a string'],
+            };
+        }
+        new URL(value);
+        return {
+            valid: true,
+            value,
+        };
+    }
+    catch {
+        return {
+            valid: false,
+            errors: ['Invalid URL format'],
+        };
+    }
+};
+/**
+ * Check if a value is a valid date
+ *
+ * @param value - Value to check
+ * @param options - Validation options
+ * @returns Promise resolving to validation result
+ */
+is.date = async (value, options = {}) => {
+    const { coerce } = options;
+    if (value instanceof Date) {
+        return {
+            valid: !isNaN(value.getTime()),
+            value,
+            errors: isNaN(value.getTime()) ? ['Invalid date'] : undefined,
+        };
+    }
+    if (coerce) {
+        try {
+            const date = new Date(value);
+            if (!isNaN(date.getTime())) {
+                return {
+                    valid: true,
+                    value: date,
+                };
+            }
+        }
+        catch {
+            // Fall through to invalid
+        }
+    }
+    return {
+        valid: false,
+        errors: ['Invalid date'],
+    };
+};
+/**
+ * Check if a value matches a custom validation function
+ *
+ * @param value - Value to check
+ * @param validator - Validation function
+ * @returns Promise resolving to validation result
+ *
+ * @example
+ * ```ts
+ * const result = await is.custom(
+ *   42,
+ *   (v) => typeof v === 'number' && v > 0 && v < 100
+ * )
+ * ```
+ */
+is.custom = async (value, validator) => {
+    try {
+        const valid = await validator(value);
+        return {
+            valid,
+            value: valid ? value : undefined,
+            errors: valid ? undefined : ['Custom validation failed'],
+        };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            errors: [error.message],
+        };
+    }
+};
+//# sourceMappingURL=is.js.map

package/dist/is.js.map

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

package/dist/kpis.d.ts

@@ -0,0 +1,103 @@
+/**
+ * KPI and OKR tracking functionality for digital workers
+ */
+import type { KPI, OKR } from './types.js';
+/**
+ * Define and track Key Performance Indicators
+ *
+ * @param definition - KPI definition or array of KPIs
+ * @returns The defined KPI(s)
+ *
+ * @example
+ * ```ts
+ * const deploymentFrequency = kpis({
+ *   name: 'Deployment Frequency',
+ *   description: 'Number of deployments per week',
+ *   current: 5,
+ *   target: 10,
+ *   unit: 'deploys/week',
+ *   trend: 'up',
+ *   period: 'weekly',
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Define multiple KPIs
+ * const teamKPIs = kpis([
+ *   {
+ *     name: 'Code Quality',
+ *     description: 'SonarQube quality score',
+ *     current: 85,
+ *     target: 90,
+ *     unit: 'score',
+ *     trend: 'up',
+ *   },
+ *   {
+ *     name: 'Test Coverage',
+ *     description: 'Percentage of code covered by tests',
+ *     current: 75,
+ *     target: 80,
+ *     unit: '%',
+ *     trend: 'up',
+ *   },
+ * ])
+ * ```
+ */
+export declare function kpis(definition: KPI): KPI;
+export declare function kpis(definition: KPI[]): KPI[];
+export declare namespace kpis {
+    var update: (kpi: KPI, current: number) => KPI;
+    var progress: (kpi: Pick<KPI, "current" | "target">) => number;
+    var onTrack: (kpi: Pick<KPI, "current" | "target">, threshold?: number) => boolean;
+    var gap: (kpi: Pick<KPI, "current" | "target">) => number;
+    var format: (kpi: KPI) => string;
+    var compare: (previous: Pick<KPI, "current" | "target">, current: Pick<KPI, "current" | "target">) => {
+        delta: number;
+        percentChange: number;
+        improved: boolean;
+    };
+}
+/**
+ * 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 declare function okrs(definition: OKR): OKR;
+export declare namespace okrs {
+    var progress: (okr: OKR) => number;
+    var updateKeyResult: (okr: OKR, keyResultName: string, current: number) => OKR;
+    var onTrack: (okr: OKR, threshold?: number) => boolean;
+    var format: (okr: OKR) => string;
+}
+//# sourceMappingURL=kpis.d.ts.map

package/dist/kpis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kpis.d.ts","sourceRoot":"","sources":["../src/kpis.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,GAAG,GAAG,GAAG,CAAA;AAC1C,wBAAgB,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAAA;yBAA9B,IAAI;sBAmBA,GAAG,WAAW,MAAM,KAAG,GAAG;wBA4BxB,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,QAAQ,CAAC,KAAG,MAAM;uBAkBzC,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,QAAQ,CAAC,yBAAoB,OAAO;mBAgB9D,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,QAAQ,CAAC,KAAG,MAAM;sBAuBrC,GAAG,KAAG,MAAM;4BAwBpB,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,QAAQ,CAAC,WAChC,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,QAAQ,CAAC,KACvC;QACD,KAAK,EAAE,MAAM,CAAA;QACb,aAAa,EAAE,MAAM,CAAA;QACrB,QAAQ,EAAE,OAAO,CAAA;KAClB;;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,GAAG,GAAG,GAAG,CAEzC;yBAFe,IAAI;wBAgBE,GAAG,KAAG,MAAM;+BA4B3B,GAAG,iBACO,MAAM,WACZ,MAAM,KACd,GAAG;uBAsBe,GAAG,yBAAoB,OAAO;sBAoB/B,GAAG,KAAG,MAAM"}