@anthropic-ai/sdk/src/tools/agent-toolset/sync-interval.ts

The official TypeScript library for the Anthropic API

/**
 * The memory sync cadence, split out of `memories.ts` so runtime-agnostic
 * callers (the environment worker) can validate an interval up front without
 * reaching into the Node-only toolset module.
 */

import { AnthropicError } from '../../core/error';

/**
 * How often (milliseconds) the worker syncs the session's memory stores back
 * while the session runs. Checked after each dispatched tool call.
 */
export const DEFAULT_MEMORY_SYNC_INTERVAL_MS = 15_000;

/**
 * The shortest sync interval accepted. Each sync lists every attached store,
 * so anything tighter mostly spends requests rediscovering that nothing
 * changed.
 */
export const MIN_MEMORY_SYNC_INTERVAL_MS = 5_000;

/** Throw unless `ms` is a usable sync interval. `option` names it in the message. */
export function checkMemorySyncInterval(ms: number, option: string): void {
  if (!(ms >= MIN_MEMORY_SYNC_INTERVAL_MS)) {
    throw new AnthropicError(
      `${option} must be at least ${MIN_MEMORY_SYNC_INTERVAL_MS}ms (got ${ms}); ` +
        'to run without memory sync, pass `memorySyncIntervalMs: null` to the worker instead',
    );
  }
}