@remnic/core 9.66.0 → 9.66.2

package/dist/chunk-KODXCHXJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/activity/config.ts"],"sourcesContent":["import { coerceBooleanLike, coerceNumber } from \"../connectors/coerce.js\";\nimport { assertValidTimezone } from \"./digest.js\";\nimport type { ImportanceLevel } from \"../types.js\";\nimport type { ActivityConfig, ActivityExtractionMode, ActivitySourceConfig, ActivityTimelineConfig } from \"./types.js\";\n\nconst EXTRACTION_MODES: readonly ActivityExtractionMode[] = [\"off\", \"smart\"];\nconst IMPORTANCE_LEVELS: readonly ImportanceLevel[] = [\"critical\", \"high\", \"normal\", \"low\", \"trivial\"];\nconst LOOPBACK_HOSTS: Record<string, true> = { localhost: true, \"127.0.0.1\": true, \"::1\": true };\n\n/** The inert default: disabled, search-only, no sources, no extraction. */\nexport function defaultActivityConfig(): ActivityConfig {\n  return {\n    enabled: false,\n    timezone: \"UTC\",\n    syncDays: 1,\n    autoSyncIntervalMinutes: 15,\n    sources: [],\n    extractionMode: \"off\",\n    sourceTrust: 0.6,\n    autoApproveTrust: 0.8,\n    reviewTrust: 0.5,\n    minConfidence: 0.7,\n    minImportance: \"normal\",\n    maxMemoriesPerDay: 0,\n    timeline: { enabled: false },\n  };\n}\n\nfunction asRecord(value: unknown, name: string): Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new TypeError(`${name} must be an object`);\n  }\n  return value as Record<string, unknown>;\n}\n\nfunction optionalString(value: unknown, name: string): string | undefined {\n  if (value === undefined) return undefined;\n  if (typeof value !== \"string\" || value.length === 0) throw new TypeError(`${name} must be a non-empty string`);\n  return value;\n}\n\nfunction parseUnitInterval(value: unknown, key: string, fallback: number): number {\n  if (value === undefined) return fallback;\n  const parsed = coerceNumber(value);\n  if (parsed === undefined || !Number.isFinite(parsed) || parsed < 0 || parsed > 1) {\n    throw new RangeError(`activity.${key} must be a number in [0, 1]`);\n  }\n  return parsed;\n}\n\n/**\n * Parse, protocol-check, and confine an activity source base URL to a local\n * loopback host. Shared with ActivityHttpSourceClient so config-load and client\n * construction reject the exact same shapes with the same prefixed message. The\n * bearer token travels in an Authorization header, so a non-loopback baseUrl\n * would exfiltrate it; the subsystem contract is local capture daemons only.\n */\nexport function validateActivityBaseUrl(baseUrl: string): URL {\n  let parsed: URL;\n  try {\n    parsed = new URL(baseUrl);\n  } catch {\n    throw new RangeError(`activity source baseUrl must be a valid URL: ${baseUrl}`);\n  }\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new RangeError(\"activity source baseUrl must use HTTP or HTTPS\");\n  }\n  // URL keeps IPv6 hosts bracketed (e.g. \"[::1]\"); normalize before the lookup.\n  const host = parsed.hostname.replace(/^\\[|\\]$/g, \"\");\n  if (LOOPBACK_HOSTS[host] !== true && !/^127\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}$/.test(host)) {\n    throw new RangeError(`activity source baseUrl must target a loopback host (got ${parsed.hostname})`);\n  }\n  return parsed;\n}\n\nfunction parseSource(value: unknown): ActivitySourceConfig {\n  const raw = asRecord(value, \"activity source\");\n  const machineLabel = optionalString(raw.machineLabel, \"activity source machineLabel\");\n  const baseUrl = optionalString(raw.baseUrl, \"activity source baseUrl\");\n  if (machineLabel === undefined || baseUrl === undefined) {\n    throw new TypeError(\"activity source requires machineLabel and baseUrl\");\n  }\n  // Reject whitespace-only labels here so config-load fails loudly rather than\n  // parsing clean and then failing on the first sync (the client and pipeline\n  // both reject a blank label via trim()).\n  if (machineLabel.trim().length === 0) {\n    throw new RangeError(\"activity source machineLabel must not be blank\");\n  }\n  validateActivityBaseUrl(baseUrl);\n  const token = optionalString(raw.token, \"activity source token\");\n  return { machineLabel, baseUrl, ...(token === undefined ? {} : { token }) };\n}\n\n/**\n * Parse the unified `activity.*` block. `enabled` gates source ingestion (and\n * requires at least one source); `extractionMode` independently gates durable\n * trust-gated memory extraction (default `off`, i.e. search-only).\n */\nexport function parseActivityConfig(raw: unknown): ActivityConfig {\n  const defaults = defaultActivityConfig();\n  if (raw === undefined || raw === null) {\n    return { ...defaults };\n  }\n  const config = asRecord(raw, \"activity\");\n  const enabledValue = coerceBooleanLike(config.enabled, \"activity.enabled\");\n  if (config.enabled !== undefined && enabledValue === undefined) {\n    throw new TypeError(\"activity.enabled must be a boolean\");\n  }\n  const timezone = optionalString(config.timezone, \"activity.timezone\") ?? \"UTC\";\n  // Validate the IANA zone at parse so a typo fails before any daemon is\n  // contacted; otherwise activityDayWindow() throws mid-sync after snapshot\n  // pages may already be persisted, and every retry replays the same window.\n  assertValidTimezone(timezone);\n  const syncDaysValue = coerceNumber(config.syncDays, \"activity.syncDays\");\n  if (config.syncDays !== undefined && syncDaysValue === undefined) {\n    throw new TypeError(\"activity.syncDays must be a finite number\");\n  }\n  const syncDays = syncDaysValue ?? 1;\n  if (!Number.isInteger(syncDays) || syncDays < 1 || syncDays > 90) {\n    throw new RangeError(\"activity.syncDays must be an integer from 1 to 90\");\n  }\n  const intervalValue = coerceNumber(config.autoSyncIntervalMinutes, \"activity.autoSyncIntervalMinutes\");\n  if (config.autoSyncIntervalMinutes !== undefined && intervalValue === undefined) {\n    throw new TypeError(\"activity.autoSyncIntervalMinutes must be a finite number\");\n  }\n  const autoSyncIntervalMinutes = intervalValue ?? 15;\n  if (!Number.isInteger(autoSyncIntervalMinutes) || autoSyncIntervalMinutes < 1 || autoSyncIntervalMinutes > 1440) {\n    throw new RangeError(\"activity.autoSyncIntervalMinutes must be an integer from 1 to 1440\");\n  }\n  if (config.sources !== undefined && !Array.isArray(config.sources)) {\n    throw new TypeError(\"activity.sources must be an array\");\n  }\n  const sources = (config.sources ?? []).map(parseSource);\n  // Cursors and row dedup are keyed on machineLabel alone; two sources sharing\n  // a label would share a cursor and dedup namespace, silently skipping or\n  // conflating snapshots. Reject the collision at parse.\n  const labels = new Set<string>();\n  for (const source of sources) {\n    if (labels.has(source.machineLabel)) {\n      throw new RangeError(`activity source machineLabel must be unique: ${source.machineLabel}`);\n    }\n    labels.add(source.machineLabel);\n  }\n  const enabled = enabledValue ?? false;\n  if (enabled && sources.length === 0) throw new RangeError(\"activity.enabled requires at least one source\");\n\n  // Extraction gate (independent of `enabled` ingestion). Default `off`.\n  // Default only for a missing key; an explicit null/non-string is a malformed\n  // enum and must fail rather than silently disabling extraction.\n  const extractionMode = config.extractionMode === undefined ? defaults.extractionMode : config.extractionMode;\n  if (typeof extractionMode !== \"string\" || !EXTRACTION_MODES.includes(extractionMode as ActivityExtractionMode)) {\n    throw new RangeError(`activity.extractionMode must be one of: ${EXTRACTION_MODES.join(\", \")}`);\n  }\n  const minImportance = config.minImportance === undefined ? defaults.minImportance : config.minImportance;\n  if (typeof minImportance !== \"string\" || !IMPORTANCE_LEVELS.includes(minImportance as ImportanceLevel)) {\n    throw new RangeError(`activity.minImportance must be one of: ${IMPORTANCE_LEVELS.join(\", \")}`);\n  }\n  // Default only for a missing key; an explicit null/unparseable value must fail\n  // rather than silently uncapping (parity with the enum/unit-interval fields).\n  const rawMaxMemoriesPerDay =\n    config.maxMemoriesPerDay === undefined ? defaults.maxMemoriesPerDay : config.maxMemoriesPerDay;\n  const maxMemoriesPerDay = coerceNumber(rawMaxMemoriesPerDay);\n  if (maxMemoriesPerDay === undefined || !Number.isInteger(maxMemoriesPerDay) || maxMemoriesPerDay < 0) {\n    throw new RangeError(\"activity.maxMemoriesPerDay must be a non-negative integer\");\n  }\n  const autoApproveTrust = parseUnitInterval(config.autoApproveTrust, \"autoApproveTrust\", defaults.autoApproveTrust);\n  const reviewTrust = parseUnitInterval(config.reviewTrust, \"reviewTrust\", defaults.reviewTrust);\n  if (reviewTrust >= autoApproveTrust) {\n    throw new RangeError(\n      `activity.reviewTrust (${reviewTrust}) must be below autoApproveTrust (${autoApproveTrust})`,\n    );\n  }\n  return {\n    enabled,\n    timezone,\n    syncDays,\n    autoSyncIntervalMinutes,\n    sources,\n    extractionMode: extractionMode as ActivityExtractionMode,\n    sourceTrust: parseUnitInterval(config.sourceTrust, \"sourceTrust\", defaults.sourceTrust),\n    autoApproveTrust,\n    reviewTrust,\n    minConfidence: parseUnitInterval(config.minConfidence, \"minConfidence\", defaults.minConfidence),\n    minImportance: minImportance as ImportanceLevel,\n    maxMemoriesPerDay,\n    timeline: parseTimelineConfig(config.timeline),\n  };\n}\n\n/**\n * Parse the `activity.timeline.*` block. `enabled` is the master gate for\n * timeline-card derivation (issue #2049); default false. A non-object block\n * is malformed and must fail rather than silently disabling the layer.\n */\nfunction parseTimelineConfig(raw: unknown): ActivityTimelineConfig {\n  if (raw === undefined) return { enabled: false };\n  if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) {\n    throw new TypeError(\"activity.timeline must be an object\");\n  }\n  const timeline = raw as Record<string, unknown>;\n  const enabledValue = coerceBooleanLike(timeline.enabled, \"activity.timeline.enabled\");\n  if (timeline.enabled !== undefined && enabledValue === undefined) {\n    throw new TypeError(\"activity.timeline.enabled must be a boolean\");\n  }\n  return { enabled: enabledValue ?? false };\n}\n"],"mappings":"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","names":[]}