digital-workers 2.1.1 → 2.3.0

package/dist/index.js

@@ -6,7 +6,29 @@
  * defines a unified Worker interface that enables workflows to be designed
  * once and executed by any combination of AI and human workers.
  *
- * Package relationships:
+ * ## Worker Routing vs ai-functions Primitives
+ *
+ * **IMPORTANT:** This package exports functions that overlap in name with
+ * `ai-functions` primitives (do, ask, decide, approve, generate, is) but
+ * serve fundamentally different purposes:
+ *
+ * | Function | digital-workers | ai-functions |
+ * |----------|----------------|--------------|
+ * | `do` | Routes tasks to Workers | Direct LLM task description |
+ * | `ask` | Routes questions via Slack/email | LLM content for human UI |
+ * | `decide` | Multi-criteria decision framework | LLM-as-judge comparison |
+ * | `approve` | Real approval workflow via channels | LLM-generated approval content |
+ * | `generate` | Content generation with metadata | Core LLM generation primitive |
+ * | `is` | Type/schema validation with errors | Boolean assertion via LLM |
+ * | `notify` | Real channel delivery | (no equivalent) |
+ *
+ * **digital-workers functions are worker coordination primitives** that route
+ * work to AI Agents or Humans via real communication channels.
+ *
+ * **ai-functions primitives are direct LLM operations** for text generation,
+ * decision-making, and content creation.
+ *
+ * ## 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
@@ -32,12 +54,13 @@
  *   const worker$ = withWorkers($)
  *
  *   $.on.Expense.submitted(async (expense) => {
+ *     // These route to REAL workers via REAL channels
  *     await worker$.notify(finance, `New expense: ${expense.amount}`)
  *
  *     const approval = await worker$.approve(
  *       `Expense: $${expense.amount}`,
  *       manager,
- *       { via: 'slack' }
+ *       { via: 'slack' }  // Actually sends to Slack!
  *     )
  *
  *     if (approval.approved) {
@@ -55,15 +78,82 @@ export { registerWorkerActions, withWorkers, handleNotify, handleAsk, handleAppr
 export { Role } from './role.js';
 export { Team } from './team.js';
 export { Goals } from './goals.js';
+/**
+ * Worker Routing Functions
+ *
+ * These functions route work to Workers (AI Agents or Humans) via real
+ * communication channels. They are NOT direct LLM primitives.
+ *
+ * For direct LLM primitives, use the identically-named functions from
+ * `ai-functions` instead. See module documentation for comparison table.
+ */
 export { approve } from './approve.js';
 export { ask } from './ask.js';
+export { browse } from './browse.js';
 export { do } from './do.js';
 export { decide } from './decide.js';
 export { generate } from './generate.js';
+export { image } from './image.js';
 export { is } from './is.js';
 export { notify } from './notify.js';
+export { video } from './video.js';
 export { kpis, okrs } from './kpis.js';
 // Export verb definitions
 export { WorkerVerbs } from './types.js';
+// Export capability tiers
+export { CAPABILITY_TIERS, TIER_ORDER, compareTiers, isHigherTier, isLowerTier, getNextTier, getPreviousTier, getTierConfig, getToolsForTier, matchTierToComplexity, canExecuteAtTier, validateTierEscalation, createCapabilityProfile, TierRegistry, } from './capability-tiers.js';
 export { channelToTransport, getWorkerTransports, getTeamTransports, resolveAddress, resolveWorkerAddresses, getPrimaryAddress, registerTransport, getTransportHandler, hasTransport, listTransports, sendViaTransport, sendToMultipleTransports, buildNotifyPayload, buildAskPayload, buildApprovePayload, toDigitalToolsMessage, fromDigitalToolsMessage, MessageTypeMapping, CallTypeMapping, } from './transports.js';
+// Export cascade context for agent coordination
+export { 
+// Functions
+createCascadeContext, validateContext, enrichContext, serializeContext, deserializeContext, mergeContexts, diffContexts, createContextVersion, 
+// Schemas
+AgentCascadeContextSchema, AgentTierSchema, ContextVersionSchema, AgentRefSchema, TaskPrioritySchema, TaskInfoSchema, ExecutionPhaseSchema, ExecutionStateSchema, TraceEntrySchema, } from './cascade-context.js';
+// Export agent-to-agent communication layer
+export { 
+// Message Bus
+AgentMessageBus, createMessageBus, 
+// Core Functions
+sendToAgent, broadcastToGroup, requestFromAgent, onMessage, acknowledge, 
+// Coordination Patterns
+requestResponse, fanOut, fanIn, pipeline, 
+// Handoff Protocol
+initiateHandoff, acceptHandoff, rejectHandoff, completeHandoff, } from './agent-comms.js';
+// Export load balancing and routing for agent coordination
+export { 
+// Balancer Factories
+createRoundRobinBalancer, createLeastBusyBalancer, createCapabilityRouter, createPriorityQueueBalancer, createAgentAvailabilityTracker, createCompositeBalancer, createRoutingRuleEngine, 
+// Metrics
+collectRoutingMetrics, resetRoutingMetrics, } from './load-balancing.js';
+// Export Slack transport adapter
+export { SlackTransport, createSlackTransport, registerSlackTransport, 
+// Block Kit helpers
+slackSection, slackHeader, slackDivider, slackContext, slackButton, slackActions, } from './transports/slack.js';
+// Export Email transport adapter
+export { EmailTransport, createEmailTransport, createEmailTransportWithProvider, createResendProvider, 
+// Template generators
+generateNotificationEmail, generateApprovalEmail, 
+// Reply parsing
+parseApprovalReply, 
+// Type guards
+isEmailTransportConfig, isApproved, isRejected, } from './transports/email.js';
+// Export error escalation for multi-level error handling
+export { 
+// Error Classification
+getErrorSeverity, getErrorCategory, createClassifiedError, classifyError, isEscalatable, preserveContext, buildErrorChain, 
+// Escalation Routing
+createEscalationPolicy, getNextEscalationTier, determineEscalationPath, shouldEscalate, detectCircularEscalation, validateEscalationPath, 
+// Recovery Patterns
+calculateBackoff, createRetryState, shouldRetry, selectFallbackAgent, getDegradationLevel, createRecoveryState, updateRecoveryState, isRecoverable, 
+// Escalation Engine
+createEscalationEngine, } from './error-escalation.js';
+// Export runtime integration for human request processing
+export { 
+// Classes
+HumanRequestProcessor, InMemoryRequestStore, 
+// Factory functions
+createHumanRequestProcessor, } from './runtime.js';
+export { noopLogger, createConsoleLogger } from './logger.js';
+// Export ID generation utilities
+export { generateRequestId } from './utils/id.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/is.d.ts

@@ -1,29 +1,62 @@
 /**
  * Type validation and checking functionality for digital workers
+ *
+ * IMPORTANT: Schema Validation vs Boolean Assertion
+ * --------------------------------------------------
+ * This module provides comprehensive type/schema validation,
+ * NOT simple boolean assertions.
+ *
+ * - `digital-workers.is()` - Validates values against types or schemas,
+ *   returns detailed validation results with errors and optional coercion.
+ *
+ * - `ai-functions.is()` - Boolean assertion via LLM (e.g., `is\`${x} is valid\``)
+ *   returns true/false based on natural language checking.
+ *
+ * Use digital-workers when you need:
+ * - Type validation with error messages
+ * - Schema validation with field-level errors
+ * - Value coercion (string to number, etc.)
+ * - Structured validation results
+ *
+ * Use ai-functions when you need:
+ * - Natural language boolean checks
+ * - LLM-based semantic validation
+ * - Template literal assertions
+ *
+ * @module
  */
 import { type SimpleSchema } from 'ai-functions';
 import type { TypeCheckResult, IsOptions } from './types.js';
 /**
- * Check if a value matches an expected type or schema
+ * Validate a value against a type or schema with detailed results.
  *
- * Uses AI-powered validation for complex types and schemas.
- * Can also perform type coercion when enabled.
+ * **Key Difference from ai-functions.is():**
+ * Unlike `ai-functions.is()` which is a boolean assertion using natural
+ * language (e.g., `is\`${email} is valid\`` returns true/false), this
+ * function performs structured type/schema validation and returns a
+ * `TypeCheckResult` with:
+ * - Validation status
+ * - Error messages for invalid fields
+ * - Optionally coerced values
+ *
+ * This is a **validation primitive**, not a boolean assertion primitive.
  *
  * @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
+ * @param type - Type name ('email', 'url', 'number') or schema to validate against
+ * @param options - Validation options (coerce, strict)
+ * @returns Promise resolving to TypeCheckResult with valid, value, and errors
  *
  * @example
  * ```ts
- * // Simple type checking
+ * // Simple type checking with result object
  * const result = await is('hello@example.com', 'email')
  * console.log(result.valid) // true
+ * console.log(result.errors) // undefined when valid
  * ```
  *
  * @example
  * ```ts
- * // Schema validation
+ * // Schema validation with detailed errors
  * const result = await is(
  *   { name: 'John', age: 30 },
  *   {
@@ -38,11 +71,13 @@ import type { TypeCheckResult, IsOptions } from './types.js';
  *
  * @example
  * ```ts
- * // With coercion
+ * // With coercion - transforms value to target type
  * const result = await is('123', 'number', { coerce: true })
  * console.log(result.valid) // true
- * console.log(result.value) // 123 (as number)
+ * console.log(result.value) // 123 (as number, not string)
  * ```
+ *
+ * @see {@link ai-functions#is} for natural language boolean assertions
  */
 export declare function is(value: unknown, type: string | SimpleSchema, options?: IsOptions): Promise<TypeCheckResult>;
 export declare namespace is {

package/dist/is.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"is.d.ts","sourceRoot":"","sources":["../src/is.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;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;qBAgBpC,OAAO,KAAG,OAAO,CAAC,eAAe,CAAC;sBA6BjC,OAAO,YAAW,SAAS,KAAQ,OAAO,CAAC,eAAe,CAAC;wBAgD1E,OAAO,aACH,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KACpD,OAAO,CAAC,eAAe,CAAC"}

package/dist/is.js

@@ -1,29 +1,62 @@
 /**
  * Type validation and checking functionality for digital workers
+ *
+ * IMPORTANT: Schema Validation vs Boolean Assertion
+ * --------------------------------------------------
+ * This module provides comprehensive type/schema validation,
+ * NOT simple boolean assertions.
+ *
+ * - `digital-workers.is()` - Validates values against types or schemas,
+ *   returns detailed validation results with errors and optional coercion.
+ *
+ * - `ai-functions.is()` - Boolean assertion via LLM (e.g., `is\`${x} is valid\``)
+ *   returns true/false based on natural language checking.
+ *
+ * Use digital-workers when you need:
+ * - Type validation with error messages
+ * - Schema validation with field-level errors
+ * - Value coercion (string to number, etc.)
+ * - Structured validation results
+ *
+ * Use ai-functions when you need:
+ * - Natural language boolean checks
+ * - LLM-based semantic validation
+ * - Template literal assertions
+ *
+ * @module
  */
 import { generateObject } from 'ai-functions';
 import { schema as convertSchema } from 'ai-functions';
 /**
- * Check if a value matches an expected type or schema
+ * Validate a value against a type or schema with detailed results.
  *
- * Uses AI-powered validation for complex types and schemas.
- * Can also perform type coercion when enabled.
+ * **Key Difference from ai-functions.is():**
+ * Unlike `ai-functions.is()` which is a boolean assertion using natural
+ * language (e.g., `is\`${email} is valid\`` returns true/false), this
+ * function performs structured type/schema validation and returns a
+ * `TypeCheckResult` with:
+ * - Validation status
+ * - Error messages for invalid fields
+ * - Optionally coerced values
+ *
+ * This is a **validation primitive**, not a boolean assertion primitive.
  *
  * @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
+ * @param type - Type name ('email', 'url', 'number') or schema to validate against
+ * @param options - Validation options (coerce, strict)
+ * @returns Promise resolving to TypeCheckResult with valid, value, and errors
  *
  * @example
  * ```ts
- * // Simple type checking
+ * // Simple type checking with result object
  * const result = await is('hello@example.com', 'email')
  * console.log(result.valid) // true
+ * console.log(result.errors) // undefined when valid
  * ```
  *
  * @example
  * ```ts
- * // Schema validation
+ * // Schema validation with detailed errors
  * const result = await is(
  *   { name: 'John', age: 30 },
  *   {
@@ -38,11 +71,13 @@ import { schema as convertSchema } from 'ai-functions';
  *
  * @example
  * ```ts
- * // With coercion
+ * // With coercion - transforms value to target type
  * const result = await is('123', 'number', { coerce: true })
  * console.log(result.valid) // true
- * console.log(result.value) // 123 (as number)
+ * console.log(result.value) // 123 (as number, not string)
  * ```
+ *
+ * @see {@link ai-functions#is} for natural language boolean assertions
  */
 export async function is(value, type, options = {}) {
     const { coerce = false, strict = false } = options;
@@ -84,8 +119,7 @@ async function validateSimpleType(value, type, options) {
         }
         return {
             valid: isValid,
-            value: isValid ? value : undefined,
-            errors: isValid ? undefined : [`Value is not a valid ${type}`],
+            ...(isValid ? { value } : { errors: [`Value is not a valid ${type}`] }),
         };
     }
     // Use AI for complex type validation
@@ -99,7 +133,9 @@ async function validateSimpleType(value, type, options) {
         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.'}`,
+${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)}
@@ -111,7 +147,7 @@ Determine if the value is valid for this type.`,
     return {
         valid: validation.valid,
         value: coerce && validation.coercedValue !== undefined ? validation.coercedValue : value,
-        errors: validation.valid ? undefined : validation.errors,
+        ...(!validation.valid && { errors: validation.errors }),
     };
 }
 /**
@@ -162,7 +198,7 @@ Check if the value matches the schema structure and types.`,
         return {
             valid: validation.valid,
             value: coerce && validation.coercedValue !== undefined ? validation.coercedValue : value,
-            errors: validation.valid ? undefined : validation.errors,
+            ...(!validation.valid && { errors: validation.errors }),
         };
     }
 }
@@ -218,8 +254,7 @@ is.email = async (value) => {
     const valid = typeof value === 'string' && emailRegex.test(value);
     return {
         valid,
-        value: valid ? value : undefined,
-        errors: valid ? undefined : ['Invalid email format'],
+        ...(valid ? { value } : { errors: ['Invalid email format'] }),
     };
 };
 /**
@@ -259,10 +294,11 @@ is.url = async (value) => {
 is.date = async (value, options = {}) => {
     const { coerce } = options;
     if (value instanceof Date) {
+        const isValid = !isNaN(value.getTime());
         return {
-            valid: !isNaN(value.getTime()),
+            valid: isValid,
             value,
-            errors: isNaN(value.getTime()) ? ['Invalid date'] : undefined,
+            ...(!isValid && { errors: ['Invalid date'] }),
         };
     }
     if (coerce) {
@@ -304,8 +340,7 @@ is.custom = async (value, validator) => {
         const valid = await validator(value);
         return {
             valid,
-            value: valid ? value : undefined,
-            errors: valid ? undefined : ['Custom validation failed'],
+            ...(valid ? { value } : { errors: ['Custom validation failed'] }),
         };
     }
     catch (error) {

package/dist/is.js.map

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

package/dist/kpis.d.ts

@@ -1,10 +1,15 @@
 /**
  * KPI and OKR tracking functionality for digital workers
  */
-import type { KPI, OKR } from './types.js';
+import type { WorkerKPI, WorkerOKR } from './types.js';
+export type { KPI, OKR, KeyResult } from 'org.ai';
 /**
  * Define and track Key Performance Indicators
  *
+ * Uses WorkerKPI which has a simpler interface with `current` and `target`
+ * as required number fields. For the full org.ai KPI with `id`, `value`,
+ * `category`, and `history`, use the KPI type directly.
+ *
  * @param definition - KPI definition or array of KPIs
  * @returns The defined KPI(s)
  *
@@ -44,15 +49,15 @@ import type { KPI, OKR } from './types.js';
  * ])
  * ```
  */
-export declare function kpis(definition: KPI): KPI;
-export declare function kpis(definition: KPI[]): KPI[];
+export declare function kpis(definition: WorkerKPI): WorkerKPI;
+export declare function kpis(definition: WorkerKPI[]): WorkerKPI[];
 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">) => {
+    var update: (kpi: WorkerKPI, current: number) => WorkerKPI;
+    var progress: (kpi: Pick<WorkerKPI, "current" | "target">) => number;
+    var onTrack: (kpi: Pick<WorkerKPI, "current" | "target">, threshold?: number) => boolean;
+    var gap: (kpi: Pick<WorkerKPI, "current" | "target">) => number;
+    var format: (kpi: WorkerKPI) => string;
+    var compare: (previous: Pick<WorkerKPI, "current" | "target">, current: Pick<WorkerKPI, "current" | "target">) => {
         delta: number;
         percentChange: number;
         improved: boolean;
@@ -61,6 +66,10 @@ export declare namespace kpis {
 /**
  * Define OKRs (Objectives and Key Results)
  *
+ * Uses WorkerOKR which has WorkerRef for owner.
+ * For the full org.ai OKR with `id`, `status`, `period`, etc.,
+ * use the OKR type directly.
+ *
  * @param definition - OKR definition
  * @returns The defined OKR
  *
@@ -88,16 +97,16 @@ export declare namespace kpis {
  *       unit: '%',
  *     },
  *   ],
- *   owner: 'engineering-team',
+ *   owner: { id: 'engineering-team', type: 'agent' },
  *   dueDate: new Date('2024-03-31'),
  * })
  * ```
  */
-export declare function okrs(definition: OKR): OKR;
+export declare function okrs(definition: WorkerOKR): WorkerOKR;
 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;
+    var progress: (okr: WorkerOKR) => number;
+    var updateKeyResult: (okr: WorkerOKR, keyResultName: string, current: number) => WorkerOKR;
+    var onTrack: (okr: WorkerOKR, threshold?: number) => boolean;
+    var format: (okr: WorkerOKR) => string;
 }
 //# sourceMappingURL=kpis.d.ts.map

package/dist/kpis.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"kpis.d.ts","sourceRoot":"","sources":["../src/kpis.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAGtD,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,CAAA;AACtD,wBAAgB,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAAA;yBAA1C,IAAI;sBAmBA,SAAS,WAAW,MAAM,KAAG,SAAS;wBA4BpC,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAAC,KAAG,MAAM;uBAiB/C,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAAC,yBAAoB,OAAO;mBAgBpE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAAC,KAAG,MAAM;sBAuB3C,SAAS,KAAG,MAAM;4BAwB1B,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAAC,WACtC,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAAC,KAC7C;QACD,KAAK,EAAE,MAAM,CAAA;QACb,aAAa,EAAE,MAAM,CAAA;QACrB,QAAQ,EAAE,OAAO,CAAA;KAClB;;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,CAErD;yBAFe,IAAI;wBAgBE,SAAS,KAAG,MAAM;+BA2BX,SAAS,iBAAiB,MAAM,WAAW,MAAM,KAAG,SAAS;uBAoBrE,SAAS,yBAAoB,OAAO;sBAoBrC,SAAS,KAAG,MAAM"}

package/dist/kpis.js

@@ -1,6 +1,7 @@
 /**
  * KPI and OKR tracking functionality for digital workers
  */
+import { calculateProgress, isOnTrack, calculateGap } from 'org.ai';
 export function kpis(definition) {
     return definition;
 }
@@ -46,9 +47,7 @@ kpis.update = (kpi, current) => {
  * ```
  */
 kpis.progress = (kpi) => {
-    if (kpi.target === 0)
-        return 0;
-    return Math.min(1, Math.max(0, kpi.current / kpi.target));
+    return calculateProgress(kpi);
 };
 /**
  * Check if a KPI is on track
@@ -64,7 +63,7 @@ kpis.progress = (kpi) => {
  * ```
  */
 kpis.onTrack = (kpi, threshold = 0.8) => {
-    return kpis.progress(kpi) >= threshold;
+    return isOnTrack(kpi, threshold);
 };
 /**
  * Get the gap to target
@@ -79,7 +78,7 @@ kpis.onTrack = (kpi, threshold = 0.8) => {
  * ```
  */
 kpis.gap = (kpi) => {
-    return kpi.target - kpi.current;
+    return calculateGap(kpi);
 };
 /**
  * Format a KPI for display
@@ -123,9 +122,7 @@ kpis.format = (kpi) => {
  */
 kpis.compare = (previous, current) => {
     const delta = current.current - previous.current;
-    const percentChange = previous.current !== 0
-        ? (delta / previous.current) * 100
-        : 0;
+    const percentChange = previous.current !== 0 ? (delta / previous.current) * 100 : 0;
     // Improved if we got closer to the target
     const previousGap = Math.abs(previous.target - previous.current);
     const currentGap = Math.abs(current.target - current.current);
@@ -139,6 +136,10 @@ kpis.compare = (previous, current) => {
 /**
  * Define OKRs (Objectives and Key Results)
  *
+ * Uses WorkerOKR which has WorkerRef for owner.
+ * For the full org.ai OKR with `id`, `status`, `period`, etc.,
+ * use the OKR type directly.
+ *
  * @param definition - OKR definition
  * @returns The defined OKR
  *
@@ -166,7 +167,7 @@ kpis.compare = (previous, current) => {
  *       unit: '%',
  *     },
  *   ],
- *   owner: 'engineering-team',
+ *   owner: { id: 'engineering-team', type: 'agent' },
  *   dueDate: new Date('2024-03-31'),
  * })
  * ```
@@ -212,10 +213,10 @@ okrs.progress = (okr) => {
  * ```
  */
 okrs.updateKeyResult = (okr, keyResultName, current) => {
+    const { progress: _progress, ...rest } = okr;
     return {
-        ...okr,
-        keyResults: okr.keyResults.map((kr) => kr.name === keyResultName ? { ...kr, current } : kr),
-        progress: undefined, // Will be recalculated
+        ...rest,
+        keyResults: okr.keyResults.map((kr) => (kr.name === keyResultName ? { ...kr, current } : kr)),
     };
 };
 /**
@@ -257,11 +258,12 @@ okrs.format = (okr) => {
         ...okr.keyResults.map((kr) => {
             const krProgress = kpis.progress(kr);
             const krPercent = Math.round(krProgress * 100);
-            return `  • ${kr.name}: ${kr.current}/${kr.target} ${kr.unit} (${krPercent}%)`;
+            return `  - ${kr.name}: ${kr.current}/${kr.target} ${kr.unit} (${krPercent}%)`;
         }),
     ];
     if (okr.owner) {
-        lines.push(`  Owner: ${okr.owner}`);
+        const ownerDisplay = typeof okr.owner === 'string' ? okr.owner : okr.owner.id;
+        lines.push(`  Owner: ${ownerDisplay}`);
     }
     if (okr.dueDate) {
         lines.push(`  Due: ${okr.dueDate.toLocaleDateString()}`);

package/dist/kpis.js.map

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