openclaw/src/commitments/config.ts

// Resolves commitment runtime configuration from agent and user settings.
import { resolveUserTimezone } from "../agents/date-time.js";
import type { OpenClawConfig } from "../config/config.js";

// Configuration defaults for hidden follow-up commitment extraction and
// heartbeat delivery limits.
const DEFAULT_COMMITMENT_EXTRACTION_DEBOUNCE_MS = 15_000;
const DEFAULT_COMMITMENT_BATCH_MAX_ITEMS = 8;
const DEFAULT_COMMITMENT_EXTRACTION_QUEUE_MAX_ITEMS = 64;
const DEFAULT_COMMITMENT_CONFIDENCE_THRESHOLD = 0.72;
const DEFAULT_COMMITMENT_CARE_CONFIDENCE_THRESHOLD = 0.86;
const DEFAULT_COMMITMENT_EXTRACTION_TIMEOUT_SECONDS = 45;
export const DEFAULT_COMMITMENT_MAX_PER_HEARTBEAT = 3;
export const DEFAULT_COMMITMENT_EXPIRE_AFTER_HOURS = 72;
const DEFAULT_COMMITMENT_MAX_PER_DAY = 3;

type ResolvedCommitmentsConfig = {
  enabled: boolean;
  maxPerDay: number;
  extraction: {
    debounceMs: number;
    batchMaxItems: number;
    queueMaxItems: number;
    confidenceThreshold: number;
    careConfidenceThreshold: number;
    timeoutSeconds: number;
  };
};

/** Resolves commitment extraction config with conservative defaults. */
export function resolveCommitmentsConfig(_cfg?: OpenClawConfig): ResolvedCommitmentsConfig {
  return {
    enabled: false,
    maxPerDay: DEFAULT_COMMITMENT_MAX_PER_DAY,
    extraction: {
      debounceMs: DEFAULT_COMMITMENT_EXTRACTION_DEBOUNCE_MS,
      batchMaxItems: DEFAULT_COMMITMENT_BATCH_MAX_ITEMS,
      queueMaxItems: DEFAULT_COMMITMENT_EXTRACTION_QUEUE_MAX_ITEMS,
      confidenceThreshold: DEFAULT_COMMITMENT_CONFIDENCE_THRESHOLD,
      careConfidenceThreshold: DEFAULT_COMMITMENT_CARE_CONFIDENCE_THRESHOLD,
      timeoutSeconds: DEFAULT_COMMITMENT_EXTRACTION_TIMEOUT_SECONDS,
    },
  };
}

/** Resolves the timezone used when interpreting inferred commitment dates. */
export function resolveCommitmentTimezone(cfg?: OpenClawConfig): string {
  return resolveUserTimezone(cfg?.agents?.defaults?.userTimezone);
}