@microfox/ai-worker 1.0.3 → 1.0.5

package/dist/hitlConfig.d.ts

@@ -0,0 +1,46 @@
+import { ZodType } from 'zod';
+
+/**
+ * UI rendering hint for a HITL step.
+ *
+ * - `'custom'` — render using a registered view component (by `viewId`).
+ * - `'schema-form'` — auto-render a form for the step (no custom view needed).
+ *   The panel falls back to a raw-JSON textarea if no schema-form renderer is available.
+ */
+type HitlUiSpec = {
+    type: 'custom';
+    /** View ID used to look up the renderer in the app's HITL view registry. */
+    viewId: string;
+    title?: string;
+    sections?: Array<Record<string, unknown>>;
+    [key: string]: unknown;
+} | {
+    type: 'schema-form';
+    title?: string;
+    description?: string;
+};
+/** Metadata for a human-in-the-loop step on `WorkerQueueStep.hitl`. */
+type HitlStepConfig = {
+    taskKey: string;
+    timeoutSeconds?: number;
+    onTimeout?: 'reject' | 'auto-approve';
+    assignees?: string[];
+    ui: HitlUiSpec;
+    /** Reviewer form schema — single source of truth; use `z.infer<typeof schema>` for types. */
+    inputSchema?: ZodType;
+};
+/**
+ * DX helper for queue authors: keeps HITL config typed/readable.
+ *
+ * @example
+ * ```ts
+ * const hitl = defineHitlConfig({
+ *   taskKey: 'review-step',
+ *   ui: { type: 'schema-form', title: 'Review the output' },
+ *   inputSchema: z.object({ approved: z.boolean(), comment: z.string().optional() }),
+ * });
+ * ```
+ */
+declare function defineHitlConfig<T extends HitlStepConfig>(config: T): T;
+
+export { type HitlStepConfig, type HitlUiSpec, defineHitlConfig };

package/dist/hitlConfig.js

@@ -0,0 +1,33 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hitlConfig.ts
+var hitlConfig_exports = {};
+__export(hitlConfig_exports, {
+  defineHitlConfig: () => defineHitlConfig
+});
+module.exports = __toCommonJS(hitlConfig_exports);
+function defineHitlConfig(config) {
+  return config;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineHitlConfig
+});
+//# sourceMappingURL=hitlConfig.js.map

package/dist/hitlConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hitlConfig.ts"],"sourcesContent":["import type { ZodType } from 'zod';\n\n/**\n * UI rendering hint for a HITL step.\n *\n * - `'custom'` — render using a registered view component (by `viewId`).\n * - `'schema-form'` — auto-render a form for the step (no custom view needed).\n *   The panel falls back to a raw-JSON textarea if no schema-form renderer is available.\n */\nexport type HitlUiSpec =\n  | {\n      type: 'custom';\n      /** View ID used to look up the renderer in the app's HITL view registry. */\n      viewId: string;\n      title?: string;\n      sections?: Array<Record<string, unknown>>;\n      [key: string]: unknown;\n    }\n  | {\n      type: 'schema-form';\n      title?: string;\n      description?: string;\n    };\n\n/** Metadata for a human-in-the-loop step on `WorkerQueueStep.hitl`. */\nexport type HitlStepConfig = {\n  taskKey: string;\n  timeoutSeconds?: number;\n  onTimeout?: 'reject' | 'auto-approve';\n  assignees?: string[];\n  ui: HitlUiSpec;\n  /** Reviewer form schema — single source of truth; use `z.infer<typeof schema>` for types. */\n  inputSchema?: ZodType;\n};\n\n/**\n * DX helper for queue authors: keeps HITL config typed/readable.\n *\n * @example\n * ```ts\n * const hitl = defineHitlConfig({\n *   taskKey: 'review-step',\n *   ui: { type: 'schema-form', title: 'Review the output' },\n *   inputSchema: z.object({ approved: z.boolean(), comment: z.string().optional() }),\n * });\n * ```\n */\nexport function defineHitlConfig<T extends HitlStepConfig>(config: T): T {\n  return config;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA+CO,SAAS,iBAA2C,QAAc;AACvE,SAAO;AACT;","names":[]}

package/dist/hitlConfig.mjs

@@ -0,0 +1,8 @@
+import {
+  defineHitlConfig
+} from "./chunk-BCRJIFKB.mjs";
+import "./chunk-BJTO5JO5.mjs";
+export {
+  defineHitlConfig
+};
+//# sourceMappingURL=hitlConfig.mjs.map

package/dist/hitlConfig.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.mts

@@ -1,10 +1,15 @@
 import * as aws_lambda from 'aws-lambda';
-import { D as DispatchOptions, a as DispatchResult } from './client-BqSJQ9mZ.mjs';
-export { b as DispatchQueueResult, S as SerializedContext, j as WorkerQueueConfig, k as WorkerQueueContext, W as WorkerQueueRegistry, i as WorkerQueueStep, l as defineWorkerQueue, d as dispatch, f as dispatchLocal, h as dispatchQueue, e as dispatchWorker, c as getQueueStartUrl, g as getWorkersTriggerUrl } from './client-BqSJQ9mZ.mjs';
+import { DispatchOptions, DispatchResult } from './client.mjs';
+export { DispatchQueueResult, SerializedContext, WorkerQueueRegistry, dispatch, dispatchLocal, dispatchQueue, dispatchWorker, getQueueStartUrl, getWorkersTriggerUrl } from './client.mjs';
 import { WorkerHandler } from './handler.mjs';
-export { DispatchWorkerOptions, JobRecord, JobStore, JobStoreUpdate, QueueNextStep, QueueRuntime, QueueStepOutput, SQSMessageBody, SQS_MAX_DELAY_SECONDS, WebhookPayload, WorkerHandlerParams, WorkerLogger, createLambdaHandler, createWorkerLogger, wrapHandlerForQueue } from './handler.mjs';
+export { DispatchWorkerOptions, JobRecord, JobStore, JobStoreUpdate, MapStepInputContext, QueueNextStep, QueueRuntime, SQSMessageBody, SQS_MAX_DELAY_SECONDS, TokenBudgetExceededError, TokenBudgetState, TokenUsage, WebhookPayload, WorkerHandlerParams, WorkerLogger, createLambdaHandler, createWorkerLogger, wrapHandlerForQueue } from './handler.mjs';
+import { S as SmartRetryConfig } from './queue-DaR2UuZi.mjs';
+export { B as BuiltInRetryPattern, b as ChainContext, C as CustomRetryPattern, H as HitlResumeContext, L as LoopContext, c as QUEUE_ORCHESTRATION_KEYS, Q as QueueStepOutput, R as RetryContext, a as RetryPattern, d as WorkerQueueConfig, e as WorkerQueueContext, W as WorkerQueueStep, f as defineWorkerQueue, g as executeWithRetry, m as matchesRetryPattern, r as repeatStep } from './queue-DaR2UuZi.mjs';
 import { ZodType, z } from 'zod';
 export { WorkersConfig, clearWorkersConfigCache, getWorkersConfig, resolveQueueUrl } from './config.mjs';
+export { QueueOrchestrationFields, queueOrchestrationFieldsSchema, withQueueOrchestrationEnvelope } from './queueInputEnvelope.mjs';
+export { defaultMapChainContinueFromPrevious, defaultMapChainPassthrough } from './chainMapDefaults.mjs';
+export { HitlStepConfig, HitlUiSpec, defineHitlConfig } from './hitlConfig.mjs';
 
 /**
  * Schedule event configuration for a worker.
@@ -144,6 +149,11 @@ interface WorkerConfig {
      * ```
      */
     schedule?: ScheduleConfig;
+    /**
+     * If set, this worker is deployed to the serverless project for this group.
+     * Do not use 'core' (reserved). Max 12 characters (serverless service name limits).
+     */
+    group?: string;
     /**
      * SQS queue settings for this worker (used by @microfox/ai-worker-cli when generating serverless.yml).
      *
@@ -179,6 +189,18 @@ interface WorkerAgentConfig<INPUT_SCHEMA extends ZodType<any>, OUTPUT> {
     inputSchema: INPUT_SCHEMA;
     outputSchema: ZodType<OUTPUT>;
     handler: WorkerHandler<z.infer<INPUT_SCHEMA>, OUTPUT>;
+    /**
+     * Smart retry configuration for this worker.
+     * Applies whenever this worker runs (Lambda or local mode).
+     * Can be overridden per queue step via WorkerQueueStep.retry.
+     * Retries are in-process so ctx.retryContext is populated on each retry attempt.
+     *
+     * @example
+     * ```ts
+     * retry: { maxAttempts: 3, on: ['rate-limit', 'json-parse'] }
+     * ```
+     */
+    retry?: SmartRetryConfig;
     /**
      * @deprecated Prefer exporting `workerConfig` as a separate const from your worker file.
      * The CLI will automatically extract it from the export. This parameter is kept for backward compatibility.
@@ -192,6 +214,8 @@ interface WorkerAgent<INPUT_SCHEMA extends ZodType<any>, OUTPUT> {
     inputSchema: INPUT_SCHEMA;
     outputSchema: ZodType<OUTPUT>;
     workerConfig?: WorkerConfig;
+    /** Smart retry config set on this worker via createWorker({ retry }). */
+    retry?: SmartRetryConfig;
 }
 /**
  * Creates a worker agent that can be dispatched to SQS/Lambda.
@@ -233,4 +257,4 @@ declare function createWorker<INPUT_SCHEMA extends ZodType<any>, OUTPUT>(config:
  */
 declare function createLambdaEntrypoint<INPUT_SCHEMA extends ZodType<any>, OUTPUT>(agent: WorkerAgent<INPUT_SCHEMA, OUTPUT>): (event: aws_lambda.SQSEvent, context: aws_lambda.Context) => Promise<void>;
 
-export { DispatchOptions, DispatchResult, type ScheduleConfig, type ScheduleEventConfig, type WorkerAgent, type WorkerAgentConfig, type WorkerConfig, WorkerHandler, createLambdaEntrypoint, createWorker };
+export { DispatchOptions, DispatchResult, type ScheduleConfig, type ScheduleEventConfig, SmartRetryConfig, type WorkerAgent, type WorkerAgentConfig, type WorkerConfig, WorkerHandler, createLambdaEntrypoint, createWorker };

package/dist/index.d.ts

@@ -1,10 +1,15 @@
 import * as aws_lambda from 'aws-lambda';
-import { D as DispatchOptions, a as DispatchResult } from './client-BqSJQ9mZ.js';
-export { b as DispatchQueueResult, S as SerializedContext, j as WorkerQueueConfig, k as WorkerQueueContext, W as WorkerQueueRegistry, i as WorkerQueueStep, l as defineWorkerQueue, d as dispatch, f as dispatchLocal, h as dispatchQueue, e as dispatchWorker, c as getQueueStartUrl, g as getWorkersTriggerUrl } from './client-BqSJQ9mZ.js';
+import { DispatchOptions, DispatchResult } from './client.js';
+export { DispatchQueueResult, SerializedContext, WorkerQueueRegistry, dispatch, dispatchLocal, dispatchQueue, dispatchWorker, getQueueStartUrl, getWorkersTriggerUrl } from './client.js';
 import { WorkerHandler } from './handler.js';
-export { DispatchWorkerOptions, JobRecord, JobStore, JobStoreUpdate, QueueNextStep, QueueRuntime, QueueStepOutput, SQSMessageBody, SQS_MAX_DELAY_SECONDS, WebhookPayload, WorkerHandlerParams, WorkerLogger, createLambdaHandler, createWorkerLogger, wrapHandlerForQueue } from './handler.js';
+export { DispatchWorkerOptions, JobRecord, JobStore, JobStoreUpdate, MapStepInputContext, QueueNextStep, QueueRuntime, SQSMessageBody, SQS_MAX_DELAY_SECONDS, TokenBudgetExceededError, TokenBudgetState, TokenUsage, WebhookPayload, WorkerHandlerParams, WorkerLogger, createLambdaHandler, createWorkerLogger, wrapHandlerForQueue } from './handler.js';
+import { S as SmartRetryConfig } from './queue-B5n6YVQV.js';
+export { B as BuiltInRetryPattern, b as ChainContext, C as CustomRetryPattern, H as HitlResumeContext, L as LoopContext, c as QUEUE_ORCHESTRATION_KEYS, Q as QueueStepOutput, R as RetryContext, a as RetryPattern, d as WorkerQueueConfig, e as WorkerQueueContext, W as WorkerQueueStep, f as defineWorkerQueue, g as executeWithRetry, m as matchesRetryPattern, r as repeatStep } from './queue-B5n6YVQV.js';
 import { ZodType, z } from 'zod';
 export { WorkersConfig, clearWorkersConfigCache, getWorkersConfig, resolveQueueUrl } from './config.js';
+export { QueueOrchestrationFields, queueOrchestrationFieldsSchema, withQueueOrchestrationEnvelope } from './queueInputEnvelope.js';
+export { defaultMapChainContinueFromPrevious, defaultMapChainPassthrough } from './chainMapDefaults.js';
+export { HitlStepConfig, HitlUiSpec, defineHitlConfig } from './hitlConfig.js';
 
 /**
  * Schedule event configuration for a worker.
@@ -144,6 +149,11 @@ interface WorkerConfig {
      * ```
      */
     schedule?: ScheduleConfig;
+    /**
+     * If set, this worker is deployed to the serverless project for this group.
+     * Do not use 'core' (reserved). Max 12 characters (serverless service name limits).
+     */
+    group?: string;
     /**
      * SQS queue settings for this worker (used by @microfox/ai-worker-cli when generating serverless.yml).
      *
@@ -179,6 +189,18 @@ interface WorkerAgentConfig<INPUT_SCHEMA extends ZodType<any>, OUTPUT> {
     inputSchema: INPUT_SCHEMA;
     outputSchema: ZodType<OUTPUT>;
     handler: WorkerHandler<z.infer<INPUT_SCHEMA>, OUTPUT>;
+    /**
+     * Smart retry configuration for this worker.
+     * Applies whenever this worker runs (Lambda or local mode).
+     * Can be overridden per queue step via WorkerQueueStep.retry.
+     * Retries are in-process so ctx.retryContext is populated on each retry attempt.
+     *
+     * @example
+     * ```ts
+     * retry: { maxAttempts: 3, on: ['rate-limit', 'json-parse'] }
+     * ```
+     */
+    retry?: SmartRetryConfig;
     /**
      * @deprecated Prefer exporting `workerConfig` as a separate const from your worker file.
      * The CLI will automatically extract it from the export. This parameter is kept for backward compatibility.
@@ -192,6 +214,8 @@ interface WorkerAgent<INPUT_SCHEMA extends ZodType<any>, OUTPUT> {
     inputSchema: INPUT_SCHEMA;
     outputSchema: ZodType<OUTPUT>;
     workerConfig?: WorkerConfig;
+    /** Smart retry config set on this worker via createWorker({ retry }). */
+    retry?: SmartRetryConfig;
 }
 /**
  * Creates a worker agent that can be dispatched to SQS/Lambda.
@@ -233,4 +257,4 @@ declare function createWorker<INPUT_SCHEMA extends ZodType<any>, OUTPUT>(config:
  */
 declare function createLambdaEntrypoint<INPUT_SCHEMA extends ZodType<any>, OUTPUT>(agent: WorkerAgent<INPUT_SCHEMA, OUTPUT>): (event: aws_lambda.SQSEvent, context: aws_lambda.Context) => Promise<void>;
 
-export { DispatchOptions, DispatchResult, type ScheduleConfig, type ScheduleEventConfig, type WorkerAgent, type WorkerAgentConfig, type WorkerConfig, WorkerHandler, createLambdaEntrypoint, createWorker };
+export { DispatchOptions, DispatchResult, type ScheduleConfig, type ScheduleEventConfig, SmartRetryConfig, type WorkerAgent, type WorkerAgentConfig, type WorkerConfig, WorkerHandler, createLambdaEntrypoint, createWorker };