@workglow/ai 0.2.20 → 0.2.21

package/dist/common.d.ts

@@ -12,6 +12,7 @@ export * from "./model/InMemoryModelRepository";
 export * from "./model/ModelRegistry";
 export * from "./model/ModelRepository";
 export * from "./model/ModelSchema";
+export * from "./errors/ImageGenerationErrors";
 export * from "./provider/AiProvider";
 export * from "./provider/AiProviderRegistry";
 export * from "./provider/QueuedAiProvider";

package/dist/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AAEpD,cAAc,aAAa,CAAC;AAE5B,cAAc,yBAAyB,CAAC;AAExC,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAE5C,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AAEpD,cAAc,aAAa,CAAC;AAE5B,cAAc,yBAAyB,CAAC;AAExC,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,gCAAgC,CAAC;AAE/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAE5C,cAAc,QAAQ,CAAC"}

package/dist/errors/ImageGenerationErrors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Thrown synchronously from validateInput() when the requested model cannot
+ * support a feature on the provided input (e.g., Gemini + mask, HF + multiple images).
+ * Surfaces before any worker/queue dispatch.
+ */
+export declare class ProviderUnsupportedFeatureError extends Error {
+    readonly field: string;
+    readonly modelId: string;
+    readonly retryable = false;
+    constructor(field: string, modelId: string, detail: string);
+}
+/**
+ * Thrown when a provider returns a content-policy refusal (OpenAI moderation,
+ * Gemini SAFETY block, HF NSFW filter). Non-retryable.
+ */
+export declare class ImageGenerationContentPolicyError extends Error {
+    readonly modelId: string;
+    readonly providerReason: string;
+    readonly retryable = false;
+    constructor(modelId: string, providerReason: string);
+}
+/**
+ * Wraps any other provider failure (rate limits, transient 5xx, malformed responses).
+ * Retryable per the existing job-queue retry policy.
+ */
+export declare class ImageGenerationProviderError extends Error {
+    readonly modelId: string;
+    readonly retryable = true;
+    constructor(modelId: string, message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=ImageGenerationErrors.d.ts.map

package/dist/errors/ImageGenerationErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageGenerationErrors.d.ts","sourceRoot":"","sources":["../../src/errors/ImageGenerationErrors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,qBAAa,+BAAgC,SAAQ,KAAK;aAGtC,KAAK,EAAE,MAAM;aACb,OAAO,EAAE,MAAM;IAHjC,SAAgB,SAAS,SAAS;IAClC,YACkB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAC/B,MAAM,EAAE,MAAM,EAIf;CACF;AAED;;;GAGG;AACH,qBAAa,iCAAkC,SAAQ,KAAK;aAGxC,OAAO,EAAE,MAAM;aACf,cAAc,EAAE,MAAM;IAHxC,SAAgB,SAAS,SAAS;IAClC,YACkB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EAIvC;CACF;AAED;;;GAGG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;aAGnC,OAAO,EAAE,MAAM;IAFjC,SAAgB,SAAS,QAAQ;IACjC,YACkB,OAAO,EAAE,MAAM,EAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EAIvB;CACF"}

package/dist/job/AiJob.d.ts

@@ -24,6 +24,12 @@ export interface AiJobInput<Input extends TaskInput = TaskInput> {
     /** Opaque session token for multi-turn conversation caching (KV cache for local models, prompt caching for API providers). */
     sessionId?: string;
 }
+/**
+ * Classifies a provider error as retryable or permanent based on known patterns.
+ * Returns a RetryableJobError for transient issues (rate limits, network errors,
+ * server errors) and a PermanentJobError for non-recoverable issues (auth, not found).
+ */
+export declare function classifyProviderError(err: unknown, taskType: string, provider: string): Error;
 /**
  * Extends the base Job class to provide custom execution functionality
  * through a provided function.

package/dist/job/AiJob.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AiJob.d.ts","sourceRoot":"","sources":["../../src/job/AiJob.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,kBAAkB,EAClB,GAAG,EAKJ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAmBxD;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,KAAK,GAAG;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC;IAC1C,qFAAqF;IACrF,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8HAA8H;IAC9H,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6HD;;;GAGG;AACH,qBAAa,KAAK,CAChB,KAAK,SAAS,UAAU,CAAC,SAAS,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,EAC3D,MAAM,SAAS,UAAU,GAAG,UAAU,CACtC,SAAQ,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACY,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDjF;IAED;;;;;;;OAOG;IACI,aAAa,CAClB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,kBAAkB,GAC1B,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAkDpC;CACF"}
+{"version":3,"file":"AiJob.d.ts","sourceRoot":"","sources":["../../src/job/AiJob.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,kBAAkB,EAClB,GAAG,EAKJ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAwBxD;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,KAAK,GAAG;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC;IAC1C,qFAAqF;IACrF,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8HAA8H;IAC9H,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAgI7F;AAED;;;GAGG;AACH,qBAAa,KAAK,CAChB,KAAK,SAAS,UAAU,CAAC,SAAS,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,EAC3D,MAAM,SAAS,UAAU,GAAG,UAAU,CACtC,SAAQ,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACY,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDjF;IAED;;;;;;;OAOG;IACI,aAAa,CAClB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,kBAAkB,GAC1B,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAsCpC;CACF"}