Type Alias ActivityConfig

Type declaration

• Optionalactivities?: any

  Configuration for specific activities, type not yet specified

• Optionalexpire?: number

  place holder setting; unused at this time (re: activity workflow expire configuration)

• Optionalheaders?: Record<string, any>

  Optional metadata to pass alongside activity arguments. This metadata is transported as a dedicated schema field (not inside args) and made available to the activity function via Durable.activity.getContext().

• Optionalretry?: {
      backoffCoefficient?: number;
      initialInterval?: string;
      maximumAttempts?: number;
      maximumInterval?: string;
      throwOnError?: boolean;
  }

  Retry policy configuration for activities

  • OptionalbackoffCoefficient?: number

    Factor by which the retry timeout increases, default is 10 (HMSH_DURABLE_EXP_BACKOFF)

  • OptionalinitialInterval?: string

    Initial interval before the first retry. Formula: initialInterval * backoffCoefficient^retryCount, clamped by maximumInterval. Default is '1s'

  • OptionalmaximumAttempts?: number

    Maximum number of retry attempts, default is 50 (HMSH_DURABLE_MAX_ATTEMPTS)

  • OptionalmaximumInterval?: string

    Maximum interval between retries, default is '120s' (HMSH_DURABLE_MAX_INTERVAL)

  • OptionalthrowOnError?: boolean

    Whether to throw an error on failure, default is true

• OptionalstartToCloseTimeout?: string

  Maximum time an activity can run after starting execution. If exceeded, the activity fails with a timeout error. Accepts duration strings (e.g., '30s', '5m', '1h').

• OptionaltaskQueue?: string

  Optional explicit task queue for activities.

  Default Behavior (no taskQueue specified): Activities use the workflow's task queue + "-activity" suffix. Example: workflow "my-workflow" → activity queue "my-workflow-activity"

  Explicit Task Queue (when specified): Activities use the specified task queue + "-activity" suffix. Useful for:

  • Shared activity pools across multiple workflows
  • Interceptors (prevents per-workflow queue creation)
  • Isolated activity worker pools

  Example

  // Default: uses workflow's task queue (backward compatible)
  const activities = Durable.workflow.proxyActivities<typeof activities>({
    activities,
    retry: { maximumAttempts: 3 }
  });
  // If workflow taskQueue is "orders", uses "orders-activity"
  
  // Explicit: shared queue for interceptors (prevents explosion)
  const { auditLog } = Durable.workflow.proxyActivities<typeof activities>({
    activities: { auditLog },
    taskQueue: 'shared-activities', // Uses "shared-activities-activity"
    retry: { maximumAttempts: 3 }
  });
  Copy