digital-workers 2.1.3 → 2.4.0

package/dist/generate.d.ts

@@ -1,25 +1,62 @@
 /**
  * Content generation functionality for digital workers
+ *
+ * IMPORTANT: Worker-Context Generation vs Direct LLM Generation
+ * --------------------------------------------------------------
+ * This module provides content generation within a worker context,
+ * with rich metadata about the generation process.
+ *
+ * - `digital-workers.generate()` - Generates content with full metadata
+ *   (tokens used, duration, model info) and supports multiple content types
+ *   including text, code, structured, image, video, and audio.
+ *
+ * - `ai-functions.generate()` - Core generation primitive that powers all
+ *   ai-functions; lower-level function with type-based dispatch.
+ *
+ * The key difference is context and metadata:
+ * - digital-workers returns `GenerateResult<T>` with content + metadata
+ * - ai-functions returns just the generated content
+ *
+ * Use digital-workers when you need:
+ * - Rich metadata about generation (tokens, duration, model)
+ * - Content type variants (text, code, structured, media)
+ * - Tone, audience, and length modifiers
+ * - Iterative refinement workflows
+ *
+ * Use ai-functions when you need:
+ * - Direct LLM generation without metadata
+ * - Template literal syntax (`ai\`prompt\``)
+ * - Promise pipelining and schema inference
+ *
+ * @module
  */
 import type { GenerateResult, GenerateOptions } from './types.js';
 /**
- * Generate content
+ * Generate content with rich metadata and multiple content type support.
  *
- * Uses AI to generate various types of content including text,
- * code, structured data, images, video, and audio.
+ * **Key Difference from ai-functions.generate():**
+ * Unlike `ai-functions.generate()` which is a lower-level type-dispatch
+ * function, this function returns a `GenerateResult` wrapper with:
+ * - The generated content
+ * - Generation metadata (model, tokens, duration)
+ * - Content type information
+ *
+ * This provides better observability for worker-based content generation.
  *
  * @param prompt - What to generate
- * @param options - Generation options
- * @returns Promise resolving to generated content
+ * @param options - Generation options (type, schema, instructions, model)
+ * @returns Promise resolving to GenerateResult with content and metadata
  *
  * @example
  * ```ts
- * // Generate text content
+ * // Generate text content with metadata
  * 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)
+ * console.log(result.content) // The generated text
+ * console.log(result.metadata.tokens) // Tokens used
+ * console.log(result.metadata.duration) // Generation time in ms
  * ```
  *
  * @example
@@ -48,7 +85,11 @@ import type { GenerateResult, GenerateOptions } from './types.js';
  *   instructions: 'Use TypeScript and hooks. Include prop types.',
  * })
  * console.log(result.content) // TypeScript React component code
+ * console.log(result.metadata.language) // 'typescript'
  * ```
+ *
+ * @see {@link ai-functions#generate} for lower-level type-dispatch generation
+ * @see {@link ai-functions#ai} for template literal generation syntax
  */
 export declare function generate<T = string>(prompt: string, options?: GenerateOptions): Promise<GenerateResult<T>>;
 export declare namespace generate {

package/dist/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,MAAM,EACvC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAkH5B;yBArHqB,QAAQ;qBA4ID,CAAC,mBACpB,MAAM,SACP,MAAM,YACJ,eAAe,KACvB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;mBA6BT,CAAC,mBAClB,MAAM,QACR,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,YAC1E,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;sBAuCC,CAAC,mBACrB,MAAM,YACJ,MAAM,YACP,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;qBA8BA,CAAC,mBACpB,MAAM,UACN,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,YACjD,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;iBAoCJ,CAAC,mBAChB,MAAM,eACD,MAAM,EAAE,YACZ,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,MAAM,EACvC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CA6G5B;yBAhHqB,QAAQ;qBAuID,CAAC,mBACpB,MAAM,SACP,MAAM,YACJ,eAAe,KACvB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;mBA2BT,CAAC,mBAClB,MAAM,QACR,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,YAC1E,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;sBAuCC,CAAC,mBACrB,MAAM,YACJ,MAAM,YACP,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;qBA8BA,CAAC,mBACpB,MAAM,UACN,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,YACjD,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;iBAoCJ,CAAC,mBAChB,MAAM,eACD,MAAM,EAAE,YACZ,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC"}

package/dist/generate.js

@@ -1,25 +1,62 @@
 /**
  * Content generation functionality for digital workers
+ *
+ * IMPORTANT: Worker-Context Generation vs Direct LLM Generation
+ * --------------------------------------------------------------
+ * This module provides content generation within a worker context,
+ * with rich metadata about the generation process.
+ *
+ * - `digital-workers.generate()` - Generates content with full metadata
+ *   (tokens used, duration, model info) and supports multiple content types
+ *   including text, code, structured, image, video, and audio.
+ *
+ * - `ai-functions.generate()` - Core generation primitive that powers all
+ *   ai-functions; lower-level function with type-based dispatch.
+ *
+ * The key difference is context and metadata:
+ * - digital-workers returns `GenerateResult<T>` with content + metadata
+ * - ai-functions returns just the generated content
+ *
+ * Use digital-workers when you need:
+ * - Rich metadata about generation (tokens, duration, model)
+ * - Content type variants (text, code, structured, media)
+ * - Tone, audience, and length modifiers
+ * - Iterative refinement workflows
+ *
+ * Use ai-functions when you need:
+ * - Direct LLM generation without metadata
+ * - Template literal syntax (`ai\`prompt\``)
+ * - Promise pipelining and schema inference
+ *
+ * @module
  */
 import { generateObject, generateText } from 'ai-functions';
 /**
- * Generate content
+ * Generate content with rich metadata and multiple content type support.
+ *
+ * **Key Difference from ai-functions.generate():**
+ * Unlike `ai-functions.generate()` which is a lower-level type-dispatch
+ * function, this function returns a `GenerateResult` wrapper with:
+ * - The generated content
+ * - Generation metadata (model, tokens, duration)
+ * - Content type information
  *
- * Uses AI to generate various types of content including text,
- * code, structured data, images, video, and audio.
+ * This provides better observability for worker-based content generation.
  *
  * @param prompt - What to generate
- * @param options - Generation options
- * @returns Promise resolving to generated content
+ * @param options - Generation options (type, schema, instructions, model)
+ * @returns Promise resolving to GenerateResult with content and metadata
  *
  * @example
  * ```ts
- * // Generate text content
+ * // Generate text content with metadata
  * 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)
+ * console.log(result.content) // The generated text
+ * console.log(result.metadata.tokens) // Tokens used
+ * console.log(result.metadata.duration) // Generation time in ms
  * ```
  *
  * @example
@@ -48,10 +85,14 @@ import { generateObject, generateText } from 'ai-functions';
  *   instructions: 'Use TypeScript and hooks. Include prop types.',
  * })
  * console.log(result.content) // TypeScript React component code
+ * console.log(result.metadata.language) // 'typescript'
  * ```
+ *
+ * @see {@link ai-functions#generate} for lower-level type-dispatch generation
+ * @see {@link ai-functions#ai} for template literal generation syntax
  */
 export async function generate(prompt, options = {}) {
-    const { type = 'text', schema, instructions, model = 'sonnet', } = options;
+    const { type = 'text', schema, instructions, model = 'sonnet' } = options;
     const startTime = Date.now();
     switch (type) {
         case 'text': {

package/dist/generate.js.map

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

package/dist/goals.d.ts

@@ -1,7 +1,7 @@
 /**
  * Goals definition for digital workers
  */
-import type { WorkerGoals, KPI } from './types.js';
+import type { WorkerGoals, WorkerKPI } from './types.js';
 /**
  * Define worker goals
  *
@@ -13,7 +13,7 @@ import type { WorkerGoals, KPI } from './types.js';
  *
  * @example
  * ```ts
- * const engineeringGoals = Goals({
+ * const engineeringGoals = defineGoals({
  *   shortTerm: [
  *     'Complete Q1 roadmap features',
  *     'Reduce bug backlog by 30%',
@@ -53,7 +53,7 @@ import type { WorkerGoals, KPI } from './types.js';
  *
  * @example
  * ```ts
- * const supportGoals = Goals({
+ * const supportGoals = defineGoals({
  *   shortTerm: [
  *     'Achieve 95% customer satisfaction',
  *     'Reduce average response time to < 5 min',
@@ -76,14 +76,15 @@ import type { WorkerGoals, KPI } from './types.js';
  * })
  * ```
  */
-export declare function Goals(definition: WorkerGoals): WorkerGoals;
-export declare namespace Goals {
+export declare function defineGoals(definition: WorkerGoals): WorkerGoals;
+export declare namespace defineGoals {
     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;
+    var addMetric: (goals: WorkerGoals, kpi: WorkerKPI) => WorkerGoals;
+    var updateMetric: (goals: WorkerGoals, name: string, updates: Partial<Omit<WorkerKPI, "name">>) => WorkerGoals;
+    var progress: (kpi: Pick<WorkerKPI, "current" | "target">) => number;
+    var onTrack: (kpi: Pick<WorkerKPI, "current" | "target">, threshold?: number) => boolean;
 }
+export { defineGoals as Goals };
 //# sourceMappingURL=goals.d.ts.map

package/dist/goals.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"goals.d.ts","sourceRoot":"","sources":["../src/goals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAIxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,WAAW,GAAG,WAAW,CAEhE;yBAFe,WAAW;8BAgBQ,WAAW,QAAQ,MAAM,KAAG,WAAW;6BAiBxC,WAAW,QAAQ,MAAM,KAAG,WAAW;8BAiBtC,WAAW,QAAQ,MAAM,KAAG,WAAW;2BAyB1C,WAAW,OAAO,SAAS,KAAG,WAAW;8BAsBhE,WAAW,QACZ,MAAM,WACH,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,KACxC,WAAW;wBAuBe,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAAC,KAAG,MAAM;uBAiB/C,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAAC,yBAAoB,OAAO;;AAK5F,OAAO,EAAE,WAAW,IAAI,KAAK,EAAE,CAAA"}

package/dist/goals.js

@@ -1,6 +1,8 @@
 /**
  * Goals definition for digital workers
  */
+import { calculateProgress, isOnTrack } from 'org.ai';
+// Note: Goal, Goals types are re-exported from types.ts which imports from org.ai
 /**
  * Define worker goals
  *
@@ -12,7 +14,7 @@
  *
  * @example
  * ```ts
- * const engineeringGoals = Goals({
+ * const engineeringGoals = defineGoals({
  *   shortTerm: [
  *     'Complete Q1 roadmap features',
  *     'Reduce bug backlog by 30%',
@@ -52,7 +54,7 @@
  *
  * @example
  * ```ts
- * const supportGoals = Goals({
+ * const supportGoals = defineGoals({
  *   shortTerm: [
  *     'Achieve 95% customer satisfaction',
  *     'Reduce average response time to < 5 min',
@@ -75,7 +77,7 @@
  * })
  * ```
  */
-export function Goals(definition) {
+export function defineGoals(definition) {
     return definition;
 }
 /**
@@ -87,10 +89,10 @@ export function Goals(definition) {
  *
  * @example
  * ```ts
- * const updated = Goals.addShortTerm(engineeringGoals, 'Complete security audit')
+ * const updated = defineGoals.addShortTerm(engineeringGoals, 'Complete security audit')
  * ```
  */
-Goals.addShortTerm = (goals, goal) => ({
+defineGoals.addShortTerm = (goals, goal) => ({
     ...goals,
     shortTerm: [...goals.shortTerm, goal],
 });
@@ -103,10 +105,10 @@ Goals.addShortTerm = (goals, goal) => ({
  *
  * @example
  * ```ts
- * const updated = Goals.addLongTerm(engineeringGoals, 'Build ML platform')
+ * const updated = defineGoals.addLongTerm(engineeringGoals, 'Build ML platform')
  * ```
  */
-Goals.addLongTerm = (goals, goal) => ({
+defineGoals.addLongTerm = (goals, goal) => ({
     ...goals,
     longTerm: [...goals.longTerm, goal],
 });
@@ -119,10 +121,10 @@ Goals.addLongTerm = (goals, goal) => ({
  *
  * @example
  * ```ts
- * const updated = Goals.addStrategic(engineeringGoals, 'Become carbon neutral')
+ * const updated = defineGoals.addStrategic(engineeringGoals, 'Become carbon neutral')
  * ```
  */
-Goals.addStrategic = (goals, goal) => ({
+defineGoals.addStrategic = (goals, goal) => ({
     ...goals,
     strategic: [...(goals.strategic || []), goal],
 });
@@ -135,7 +137,7 @@ Goals.addStrategic = (goals, goal) => ({
  *
  * @example
  * ```ts
- * const updated = Goals.addMetric(engineeringGoals, {
+ * const updated = defineGoals.addMetric(engineeringGoals, {
  *   name: 'Code Quality',
  *   description: 'Code quality score from SonarQube',
  *   current: 85,
@@ -146,7 +148,7 @@ Goals.addStrategic = (goals, goal) => ({
  * })
  * ```
  */
-Goals.addMetric = (goals, kpi) => ({
+defineGoals.addMetric = (goals, kpi) => ({
     ...goals,
     metrics: [...(goals.metrics || []), kpi],
 });
@@ -160,16 +162,20 @@ Goals.addMetric = (goals, kpi) => ({
  *
  * @example
  * ```ts
- * const updated = Goals.updateMetric(engineeringGoals, 'Deployment Frequency', {
+ * const updated = defineGoals.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),
-});
+defineGoals.updateMetric = (goals, name, updates) => {
+    const updatedMetrics = goals.metrics?.map((kpi) => kpi.name === name ? { ...kpi, ...updates } : kpi);
+    const result = { ...goals };
+    if (updatedMetrics) {
+        result.metrics = updatedMetrics;
+    }
+    return result;
+};
 /**
  * Get progress for a KPI (0-1)
  *
@@ -179,13 +185,11 @@ Goals.updateMetric = (goals, name, updates) => ({
  * @example
  * ```ts
  * const kpi = { current: 75, target: 100 }
- * const progress = Goals.progress(kpi) // 0.75
+ * const progress = defineGoals.progress(kpi) // 0.75
  * ```
  */
-Goals.progress = (kpi) => {
-    if (kpi.target === 0)
-        return 0;
-    return Math.min(1, Math.max(0, kpi.current / kpi.target));
+defineGoals.progress = (kpi) => {
+    return calculateProgress(kpi);
 };
 /**
  * Check if a KPI is on track
@@ -197,10 +201,12 @@ Goals.progress = (kpi) => {
  * @example
  * ```ts
  * const kpi = { current: 85, target: 100 }
- * const onTrack = Goals.onTrack(kpi) // true (85% >= 80% threshold)
+ * const onTrack = defineGoals.onTrack(kpi) // true (85% >= 80% threshold)
  * ```
  */
-Goals.onTrack = (kpi, threshold = 0.8) => {
-    return Goals.progress(kpi) >= threshold;
+defineGoals.onTrack = (kpi, threshold = 0.8) => {
+    return isOnTrack(kpi, threshold);
 };
+// Legacy alias for backward compatibility
+export { defineGoals as Goals };
 //# sourceMappingURL=goals.js.map

package/dist/goals.js.map

@@ -1 +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"}
+{"version":3,"file":"goals.js","sourceRoot":"","sources":["../src/goals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAGrD,kFAAkF;AAElF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,MAAM,UAAU,WAAW,CAAC,UAAuB;IACjD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,WAAW,CAAC,YAAY,GAAG,CAAC,KAAkB,EAAE,IAAY,EAAe,EAAE,CAAC,CAAC;IAC7E,GAAG,KAAK;IACR,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC;CACtC,CAAC,CAAA;AAEF;;;;;;;;;;;GAWG;AACH,WAAW,CAAC,WAAW,GAAG,CAAC,KAAkB,EAAE,IAAY,EAAe,EAAE,CAAC,CAAC;IAC5E,GAAG,KAAK;IACR,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC;CACpC,CAAC,CAAA;AAEF;;;;;;;;;;;GAWG;AACH,WAAW,CAAC,YAAY,GAAG,CAAC,KAAkB,EAAE,IAAY,EAAe,EAAE,CAAC,CAAC;IAC7E,GAAG,KAAK;IACR,SAAS,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC;CAC9C,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,WAAW,CAAC,SAAS,GAAG,CAAC,KAAkB,EAAE,GAAc,EAAe,EAAE,CAAC,CAAC;IAC5E,GAAG,KAAK;IACR,OAAO,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC;CACzC,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;GAeG;AACH,WAAW,CAAC,YAAY,GAAG,CACzB,KAAkB,EAClB,IAAY,EACZ,OAAyC,EAC5B,EAAE;IACf,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAChD,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CACjD,CAAA;IACD,MAAM,MAAM,GAAgB,EAAE,GAAG,KAAK,EAAE,CAAA;IACxC,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,CAAC,OAAO,GAAG,cAAc,CAAA;IACjC,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,WAAW,CAAC,QAAQ,GAAG,CAAC,GAA0C,EAAU,EAAE;IAC5E,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAA;AAC/B,CAAC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,WAAW,CAAC,OAAO,GAAG,CAAC,GAA0C,EAAE,SAAS,GAAG,GAAG,EAAW,EAAE;IAC7F,OAAO,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;AAClC,CAAC,CAAA;AAED,0CAA0C;AAC1C,OAAO,EAAE,WAAW,IAAI,KAAK,EAAE,CAAA"}

package/dist/image.d.ts

@@ -0,0 +1,189 @@
+/**
+ * Image generation functionality for digital workers
+ *
+ * This module provides image generation primitives within a worker context,
+ * with rich metadata about the generation process.
+ *
+ * - `image()` - Generates images with full metadata (model, size, style)
+ * - `image.variations()` - Creates variations of an existing image
+ * - `image.edit()` - Edits an image with a text prompt and optional mask
+ * - `image.upscale()` - Upscales an image to higher resolution
+ * - `image.style()` - Creates a curried function for a specific style
+ *
+ * The key difference from direct API calls is context and metadata:
+ * - digital-workers returns `ImageResult` with content + metadata
+ * - Direct API calls return just the generated image
+ *
+ * @module
+ */
+/**
+ * Available image style presets
+ */
+export type ImageStyle = 'realistic' | 'artistic' | 'cartoon' | 'abstract' | 'photographic' | 'digital-art' | 'cinematic';
+/**
+ * Available image sizes
+ */
+export type ImageSize = '256x256' | '512x512' | '1024x1024' | '1024x1792' | '1792x1024';
+/**
+ * Available image formats
+ */
+export type ImageFormat = 'png' | 'jpeg' | 'webp' | 'b64_json' | 'url';
+/**
+ * Options for image generation
+ */
+export interface ImageOptions {
+    /** The prompt describing the image to generate */
+    prompt: string;
+    /** The style preset to apply */
+    style?: ImageStyle;
+    /** The size of the generated image */
+    size?: ImageSize;
+    /** The model to use for generation */
+    model?: string;
+    /** Number of images to generate (1-10) */
+    n?: number;
+    /** Output format */
+    format?: ImageFormat;
+    /** Quality setting */
+    quality?: 'standard' | 'hd';
+    /** Negative prompt - what to avoid in the image */
+    negativePrompt?: string;
+    /** Seed for reproducible generation */
+    seed?: number;
+    /** Additional model-specific parameters */
+    parameters?: Record<string, unknown>;
+}
+/**
+ * Result of image generation
+ */
+export interface ImageResult {
+    /** URL or base64 data of the generated image */
+    url: string;
+    /** The original prompt */
+    prompt: string;
+    /** The revised/enhanced prompt if the model modified it */
+    revisedPrompt?: string;
+    /** Generation metadata */
+    metadata: {
+        /** Model used for generation */
+        model: string;
+        /** Size of the generated image */
+        size: string;
+        /** Style applied */
+        style?: string;
+        /** Generation duration in milliseconds */
+        duration?: number;
+        /** Seed used for generation */
+        seed?: number;
+        /** Format of the output */
+        format?: ImageFormat;
+        /** Quality setting used */
+        quality?: string;
+        /** Provider-specific metadata */
+        provider?: Record<string, unknown>;
+    };
+}
+/**
+ * Options for image variations
+ */
+export interface VariationOptions {
+    /** Number of variations to generate */
+    count?: number;
+    /** Size of the generated variations */
+    size?: ImageSize;
+    /** Model to use for generation */
+    model?: string;
+    /** Output format */
+    format?: ImageFormat;
+}
+/**
+ * Options for image editing
+ */
+export interface EditOptions {
+    /** The prompt describing the edit */
+    prompt: string;
+    /** URL or base64 of the mask image (transparent areas will be edited) */
+    mask?: string;
+    /** Size of the output image */
+    size?: ImageSize;
+    /** Model to use for editing */
+    model?: string;
+    /** Number of edits to generate */
+    n?: number;
+    /** Output format */
+    format?: ImageFormat;
+}
+/**
+ * Options for image upscaling
+ */
+export interface UpscaleOptions {
+    /** Scale factor (2, 4, etc.) */
+    scale?: number;
+    /** Model to use for upscaling */
+    model?: string;
+    /** Output format */
+    format?: ImageFormat;
+    /** Denoise level (0-1) */
+    denoise?: number;
+}
+/**
+ * Result of image upscaling
+ */
+export interface UpscaleResult extends ImageResult {
+    /** Original image dimensions */
+    originalSize: {
+        width: number;
+        height: number;
+    };
+    /** Upscaled image dimensions */
+    upscaledSize: {
+        width: number;
+        height: number;
+    };
+    /** Scale factor used */
+    scaleFactor: number;
+}
+/**
+ * Generate an image from a text prompt
+ *
+ * @param prompt - The text prompt describing the image to generate
+ * @param options - Generation options (style, size, model, etc.)
+ * @returns Promise resolving to ImageResult with URL and metadata
+ *
+ * @example
+ * ```ts
+ * // Generate a simple image
+ * const result = await image('A sunset over mountains')
+ * console.log(result.url) // URL to the generated image
+ * console.log(result.metadata.model) // Model used
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Generate with options
+ * const result = await image('A portrait of a robot', {
+ *   style: 'cinematic',
+ *   size: '1024x1024',
+ *   quality: 'hd',
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Generate multiple images
+ * const result = await image('Abstract patterns', {
+ *   style: 'abstract',
+ *   n: 4,
+ * })
+ * ```
+ */
+export declare function image(prompt: string, options?: Partial<ImageOptions>): Promise<ImageResult>;
+export declare namespace image {
+    var variations: (imageUrl: string, options?: VariationOptions) => Promise<ImageResult[]>;
+    var edit: (imageUrl: string, options: EditOptions) => Promise<ImageResult>;
+    var upscale: (imageUrl: string, options?: UpscaleOptions) => Promise<UpscaleResult>;
+    var style: (stylePreset: ImageStyle) => (prompt: string, options?: Partial<Omit<ImageOptions, "style">>) => Promise<ImageResult>;
+    var batch: (prompts: string[], options?: Partial<ImageOptions>) => Promise<ImageResult[]>;
+    var aspectRatio: (prompt: string, ratio: "portrait" | "landscape" | "square", options?: Partial<Omit<ImageOptions, "size">>) => Promise<ImageResult>;
+}
+//# sourceMappingURL=image.d.ts.map

package/dist/image.d.ts.map

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