@camstack/core 0.1.15 → 0.1.17

package/dist/builtins/console-logging/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/builtins/console-logging/index.ts","../../../src/builtins/console-logging/console-logging.addon.ts","../../../src/logging/formatter.ts","../../../src/builtins/console-logging/console-destination.ts"],"sourcesContent":["export { ConsoleLoggingAddon } from './console-logging.addon.js'\nexport { ConsoleDestination } from './console-destination.js'\nexport { ConsoleLoggingAddon as default } from './console-logging.addon.js'\n","import type { ProviderRegistration } from '@camstack/types'\nimport { BaseAddon, logDestinationCapability } from '@camstack/types'\nimport { ConsoleDestination } from './console-destination.js'\n\ninterface ConsoleConfig {\n  readonly level: 'debug' | 'info' | 'warn' | 'error'\n}\n\n/**\n * Console logging addon — zero-dependency stdout/stderr sink that\n * produces the same canonical line format as the Winston built-in.\n * Registers as a `log-destination` capability provider so the shared\n * LogManager fans every entry to both sinks when both are active.\n *\n * Settings live under Cluster → NodeDetail → Settings alongside the\n * Winston addon. Disable one without disabling the other — the\n * LogManager keeps working as long as at least one destination is\n * registered.\n */\nexport class ConsoleLoggingAddon extends BaseAddon<ConsoleConfig> {\n  private destination: ConsoleDestination | null = null\n\n  constructor() {\n    super({ level: 'info' })\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    this.destination = new ConsoleDestination()\n    await this.destination.initialize({ level: this.config.level })\n    this.ctx.logger.info('Console logging initialized')\n    return [{ capability: logDestinationCapability, provider: this.destination }]\n  }\n\n  protected async onShutdown(): Promise<void> {\n    await this.destination?.shutdown()\n  }\n\n  getDestination(): ConsoleDestination {\n    if (!this.destination) throw new Error('Console logging not initialized')\n    return this.destination\n  }\n\n  protected globalSettingsSchema() {\n    return this.schema({\n      sections: [\n        {\n          id: 'console-logging',\n          title: 'Console Logging',\n          description: 'Minimum log level to emit on stdout/stderr. Independent from the rotated-file (Winston) destination.',\n          columns: 2,\n          fields: [\n            this.field({\n              type: 'select',\n              key: 'level',\n              label: 'Log Level',\n              default: 'info',\n              options: [\n                { value: 'debug', label: 'Debug' },\n                { value: 'info', label: 'Info' },\n                { value: 'warn', label: 'Warn' },\n                { value: 'error', label: 'Error' },\n              ],\n            }),\n          ],\n        },\n      ],\n    })\n  }\n}\n","/**\n * Canonical single-line formatter for every `LogEntry` that reaches a\n * console transport — hub-side `WinstonDestination` +\n * `ConsoleDestination`, agent-side `HubForwarderDestination`. One\n * definition so the three paths can't drift.\n *\n * Layout mirrors NestJS `ConsoleLogger` output:\n *\n *   [Nest] 54994  - 04/20/2026, 12:45:53 AM     LOG [InstanceLoader] TrpcModule dependencies initialized +0ms\n *\n * Mapping for camstack — cluster-aware:\n *   - `[Nest]` (brand bracket)   → `[<agent>/<addonId>]` so operators see\n *                                   at a glance which node emitted the line\n *                                   (matches the cluster topology)\n *   - `54994` (pid)              → `process.pid`\n *   - `<timestamp>`              → `M/D/YYYY, H:MM:SS AM`\n *   - `LOG` / `WARN` / `ERROR`   → `entry.level` upper-cased, colour per level\n *   - `[InstanceLoader]` (ctx)   → `[<device>]` — shown only when a device\n *                                   tag is present; omitted otherwise\n *   - `<message>`                → `entry.message`\n *   - trailing `+Nms`            → we don't compute timing yet; omitted\n *\n * Rendered examples:\n *   [hub/winston-logging]        71184  - 04/20/2026, 12:45:53 AM     INFO  Winston logging initialized\n *   [hub/provider-rtsp]          71184  - 04/20/2026, 12:46:01 AM     WARN  [salone] probe failed {err=\"timeout\"}\n *   [dev-agent-0/detection]      12345  - 04/20/2026, 12:47:15 AM     ERROR [cortile] no detector {codec=av1}\n */\nimport type { LogEntry, LogTags } from '@camstack/types'\n\n// Emit ANSI colour codes when the runtime supports them. Heuristic\n// follows npm ecosystem convention so log-consumers can override:\n//   - `NO_COLOR` env present → OFF (https://no-color.org/)\n//   - `FORCE_COLOR=0` → OFF\n//   - `FORCE_COLOR` truthy (1/2/3/true) → ON  (forces even when piped)\n//   - stdout.isTTY → ON\n//   - else → OFF\n// Rationale: running via `concurrently` / `npm run dev` often pipes\n// stdout and strips `isTTY`, making colours disappear. Dev sets\n// `FORCE_COLOR=1` in the shell to opt back in; CI / file-piping\n// pipelines set `NO_COLOR=1` to strip.\n//\n// Destinations that always render for console (ConsoleDestination,\n// HubForwarderDestination) pass `colorize: true` explicitly — still\n// gated by NO_COLOR. File sinks (Winston JSON) pass `colorize: false`\n// so log files stay plain text regardless of the shell environment.\nconst USE_COLOR = (() => {\n  try {\n    if (typeof process === 'undefined') return false\n    const env = process.env ?? {}\n    if (env['NO_COLOR']) return false\n    const force = env['FORCE_COLOR']\n    if (force !== undefined) return force !== '' && force !== '0' && force !== 'false'\n    return Boolean((process.stdout as { isTTY?: boolean })?.isTTY)\n  } catch { return false }\n})()\n\n/** True when `NO_COLOR` is set — destinations that force colour on still honour this. */\nconst NO_COLOR = (() => {\n  try { return Boolean(process?.env?.['NO_COLOR']) } catch { return false }\n})()\n\nconst RESET = '\\x1b[0m'\nconst ANSI = {\n  green:  '\\x1b[32m',\n  yellow: '\\x1b[33m',\n  red:    '\\x1b[31m',\n  cyan:   '\\x1b[36m',\n  gray:   '\\x1b[90m',\n} as const\n\nconst COLOR_BY_LEVEL: Readonly<Record<string, string>> = {\n  debug: ANSI.gray,\n  info:  ANSI.green,\n  warn:  ANSI.yellow,\n  error: ANSI.red,\n}\n\nfunction paint(color: string, text: string, enabled: boolean): string {\n  return enabled ? `${color}${text}${RESET}` : text\n}\n\nfunction colorizeLevel(level: string, text: string, enabled: boolean): string {\n  if (!enabled) return text\n  const code = COLOR_BY_LEVEL[level]\n  return code ? `${code}${text}${RESET}` : text\n}\n\n/** Right-pad `value` to exactly `width` characters. */\nfunction padRight(value: string, width: number): string {\n  if (value.length >= width) return value.slice(0, width)\n  return value + ' '.repeat(width - value.length)\n}\n\n/** Derive the agent — the top-level cluster node, never the forked-worker suffix. */\nfunction resolveAgent(tags: LogTags | undefined): string | null {\n  const agentId = tags?.agentId\n  if (typeof agentId === 'string' && agentId.length > 0) return agentId\n  const nodeId = tags?.nodeId\n  if (typeof nodeId === 'string' && nodeId.length > 0) {\n    return nodeId.includes('/') ? nodeId.split('/')[0]! : nodeId\n  }\n  return null\n}\n\n/** Derive the addon — `tags.addonId` first; `system` when the tag is missing\n *  (scope is no longer a fallback — it's a sub-component label, not identity). */\nfunction resolveAddon(entry: Pick<LogEntry, 'tags'>): string {\n  const addonId = entry.tags?.addonId\n  if (typeof addonId === 'string' && addonId.length > 0) return addonId\n  return 'system'\n}\n\n/** Device name (or `#id` fallback) — used inside the context bracket when present. */\nfunction resolveDevice(tags: LogTags | undefined): string | null {\n  const name = tags?.deviceName\n  if (typeof name === 'string' && name.length > 0) return name\n  const id = tags?.deviceId\n  if (typeof id === 'number' && Number.isFinite(id)) return `#${id}`\n  return null\n}\n\n/**\n * Build the brand bracket content — `<agent>/<addonId>`. Agent is\n * always shown (even `hub`) so operators never have to guess which\n * node emitted a line. Falls back to `?/<addon>` when tags don't\n * carry an agent id (pre-boot logs, test harnesses).\n */\nfunction buildBrand(entry: Pick<LogEntry, 'tags'>): string {\n  const agent = resolveAgent(entry.tags) ?? '?'\n  const addon = resolveAddon(entry)\n  return `${agent}/${addon}`\n}\n\n/**\n * Build the optional device-context bracket. Returns `null` when the\n * line doesn't carry a device tag — renders as just the brand + message\n * without the second bracket. With a device tag: `salone` / `#42`.\n */\nfunction buildDeviceContext(entry: Pick<LogEntry, 'tags'>): string | null {\n  return resolveDevice(entry.tags)\n}\n\n/**\n * NestJS-style locale timestamp: `M/D/YYYY, H:MM:SS AM`. Built with\n * `toLocaleString('en-US')` to match the default NestJS format that\n * operators are used to from Nest boot output.\n */\nfunction formatTimestamp(value: unknown): string {\n  const date = value instanceof Date ? value : new Date(typeof value === 'string' ? value : Date.now())\n  return date.toLocaleString('en-US', {\n    month: 'numeric',\n    day: 'numeric',\n    year: 'numeric',\n    hour: 'numeric',\n    minute: '2-digit',\n    second: '2-digit',\n    hour12: true,\n  })\n}\n\n/** Compact `{key=value key=\"with space\"}` rendering of an arbitrary object. Empty → ''. */\nfunction formatMeta(meta: Record<string, unknown> | undefined): string {\n  if (!meta) return ''\n  const keys = Object.keys(meta)\n  if (keys.length === 0) return ''\n  const parts: string[] = []\n  for (const key of keys) {\n    const value = meta[key]\n    parts.push(`${key}=${formatMetaValue(value)}`)\n  }\n  return `{${parts.join(' ')}}`\n}\n\nfunction formatMetaValue(value: unknown): string {\n  if (value === null) return 'null'\n  if (value === undefined) return 'undefined'\n  if (typeof value === 'string') {\n    return /\\s|\"/.test(value) ? JSON.stringify(value) : value\n  }\n  if (typeof value === 'number' || typeof value === 'boolean') return String(value)\n  if (value instanceof Error) return JSON.stringify(value.message)\n  try { return JSON.stringify(value) } catch { return String(value) }\n}\n\n/** Cached renderer PID — fallback when the entry doesn't carry its own `tags.pid`. */\nconst PID = typeof process !== 'undefined' && typeof process.pid === 'number' ? String(process.pid) : '?'\n\n/** Options for `formatLogLine`. */\nexport interface FormatLogLineOptions {\n  /**\n   * Emit ANSI colour codes. When omitted, falls back to the shell-env\n   * heuristic (`NO_COLOR`/`FORCE_COLOR`/`isTTY`). Destinations that\n   * always target a console (ConsoleDestination, HubForwarderDestination)\n   * pass `true`; file sinks (Winston JSON) pass `false` so logs on disk\n   * stay plain text regardless of the shell env.\n   *\n   * `NO_COLOR=1` in the environment still wins — consumer opt-in beats\n   * producer opt-in, matching the https://no-color.org/ convention.\n   */\n  readonly colorize?: boolean\n}\n\n/**\n * Render a `LogEntry` as one complete console line — no trailing newline.\n * Caller appends `\\n` (file sinks) or relies on `console.log` (stdout sink).\n *\n * PID column prefers `entry.tags.pid` when set (so forked-worker entries\n * carry the worker's OS pid even when the hub renders them), falling back\n * to the renderer's own `process.pid`.\n *\n * Colours (when enabled) follow the NestJS convention: the level token\n * AND the message body share the level colour (green/yellow/red/gray for\n * info/warn/error/debug). Brand, device context, scope and meta keep\n * their fixed hues so the structural fields stay visually distinct from\n * the message content.\n */\nexport function formatLogLine(entry: LogEntry, options?: FormatLogLineOptions): string {\n  const wantsColor = options?.colorize ?? USE_COLOR\n  const colorize = wantsColor && !NO_COLOR\n  const levelColor = COLOR_BY_LEVEL[entry.level]\n\n  const brand = paint(ANSI.green, `[${buildBrand(entry)}]`, colorize)\n  const entryPid = entry.tags?.pid\n  const pid = typeof entryPid === 'number' ? String(entryPid) : PID\n  const timestamp = formatTimestamp(entry.timestamp)\n  // Right-pad level to 5 chars (matches NestJS) so the context/message\n  // column aligns across different levels without fixed-width hacks\n  // on the surrounding fields.\n  const level = colorizeLevel(entry.level, padRight(entry.level.toUpperCase(), 5), colorize)\n  const device = buildDeviceContext(entry)\n  const ctxPart = device ? ' ' + paint(ANSI.yellow, `[${device}]`, colorize) : ''\n  const scope = typeof entry.scope === 'string' && entry.scope.length > 0 ? entry.scope : null\n  const scopePart = scope ? ' ' + paint(ANSI.cyan, `(${scope})`, colorize) : ''\n  const metaText = formatMeta(entry.meta)\n  const metaPart = metaText ? ' ' + paint(ANSI.gray, metaText, colorize) : ''\n  // NestJS layout: `[<agent>/<addon>] <pid>  - <timestamp>     <LEVEL> [<device>] (<scope>) <message>`\n  // Message body is tinted by level colour so `error`/`warn` stand out at a glance.\n  const message = colorize && levelColor\n    ? `${levelColor}${entry.message}${RESET}`\n    : entry.message\n  return `${brand} ${pid}  - ${timestamp}     ${level}${ctxPart}${scopePart} ${message}${metaPart}`\n}\n","/**\n * Zero-dependency log destination that writes every entry to stdout /\n * stderr via the shared `formatLogLine` formatter. Same surface as\n * `WinstonDestination` (full `ILogDestination` contract) but without\n * the rotating-file transport — ideal fallback when the Winston addon\n * is disabled or unavailable (e.g. bare-bones agents, tests).\n */\nimport type { ILogDestination, LogEntry, LogFilter } from '@camstack/types'\nimport { formatLogLine } from '../../logging/formatter.js'\n\ninterface ConsoleConfig {\n  /** Minimum log level to emit. Entries below this level are dropped. */\n  readonly level?: 'debug' | 'info' | 'warn' | 'error'\n}\n\nconst LEVEL_RANK: Readonly<Record<string, number>> = {\n  debug: 0, info: 1, warn: 2, error: 3,\n}\n\nexport class ConsoleDestination implements ILogDestination {\n  private minLevel = 0\n\n  async initialize(config?: ConsoleConfig): Promise<void> {\n    this.minLevel = LEVEL_RANK[config?.level ?? 'info'] ?? 1\n  }\n\n  write(entry: LogEntry): void {\n    const rank = LEVEL_RANK[entry.level] ?? 1\n    if (rank < this.minLevel) return\n    // Always request ANSI colours for the console sink. The formatter still\n    // respects `NO_COLOR` so operators can opt out globally.\n    const line = formatLogLine(entry, { colorize: true })\n    if (entry.level === 'error') console.error(line)\n    else if (entry.level === 'warn') console.warn(line)\n    else console.log(line)\n  }\n\n  async query(_filter: LogFilter): Promise<readonly LogEntry[]> {\n    // Console has no persistence — queries are served by other destinations.\n    return []\n  }\n\n  async shutdown(): Promise<void> {\n    // Nothing to flush — stdout/stderr are process-owned.\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACCA,mBAAoD;;;AC4CpD,IAAM,aAAa,MAAM;AACvB,MAAI;AACF,QAAI,OAAO,YAAY,YAAa,QAAO;AAC3C,UAAM,MAAM,QAAQ,OAAO,CAAC;AAC5B,QAAI,IAAI,UAAU,EAAG,QAAO;AAC5B,UAAM,QAAQ,IAAI,aAAa;AAC/B,QAAI,UAAU,OAAW,QAAO,UAAU,MAAM,UAAU,OAAO,UAAU;AAC3E,WAAO,QAAS,QAAQ,QAAgC,KAAK;AAAA,EAC/D,QAAQ;AAAE,WAAO;AAAA,EAAM;AACzB,GAAG;AAGH,IAAM,YAAY,MAAM;AACtB,MAAI;AAAE,WAAO,QAAQ,SAAS,MAAM,UAAU,CAAC;AAAA,EAAE,QAAQ;AAAE,WAAO;AAAA,EAAM;AAC1E,GAAG;AAEH,IAAM,QAAQ;AACd,IAAM,OAAO;AAAA,EACX,OAAQ;AAAA,EACR,QAAQ;AAAA,EACR,KAAQ;AAAA,EACR,MAAQ;AAAA,EACR,MAAQ;AACV;AAEA,IAAM,iBAAmD;AAAA,EACvD,OAAO,KAAK;AAAA,EACZ,MAAO,KAAK;AAAA,EACZ,MAAO,KAAK;AAAA,EACZ,OAAO,KAAK;AACd;AAEA,SAAS,MAAM,OAAe,MAAc,SAA0B;AACpE,SAAO,UAAU,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,KAAK;AAC/C;AAEA,SAAS,cAAc,OAAe,MAAc,SAA0B;AAC5E,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,OAAO,eAAe,KAAK;AACjC,SAAO,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,KAAK;AAC3C;AAGA,SAAS,SAAS,OAAe,OAAuB;AACtD,MAAI,MAAM,UAAU,MAAO,QAAO,MAAM,MAAM,GAAG,KAAK;AACtD,SAAO,QAAQ,IAAI,OAAO,QAAQ,MAAM,MAAM;AAChD;AAGA,SAAS,aAAa,MAA0C;AAC9D,QAAM,UAAU,MAAM;AACtB,MAAI,OAAO,YAAY,YAAY,QAAQ,SAAS,EAAG,QAAO;AAC9D,QAAM,SAAS,MAAM;AACrB,MAAI,OAAO,WAAW,YAAY,OAAO,SAAS,GAAG;AACnD,WAAO,OAAO,SAAS,GAAG,IAAI,OAAO,MAAM,GAAG,EAAE,CAAC,IAAK;AAAA,EACxD;AACA,SAAO;AACT;AAIA,SAAS,aAAa,OAAuC;AAC3D,QAAM,UAAU,MAAM,MAAM;AAC5B,MAAI,OAAO,YAAY,YAAY,QAAQ,SAAS,EAAG,QAAO;AAC9D,SAAO;AACT;AAGA,SAAS,cAAc,MAA0C;AAC/D,QAAM,OAAO,MAAM;AACnB,MAAI,OAAO,SAAS,YAAY,KAAK,SAAS,EAAG,QAAO;AACxD,QAAM,KAAK,MAAM;AACjB,MAAI,OAAO,OAAO,YAAY,OAAO,SAAS,EAAE,EAAG,QAAO,IAAI,EAAE;AAChE,SAAO;AACT;AAQA,SAAS,WAAW,OAAuC;AACzD,QAAM,QAAQ,aAAa,MAAM,IAAI,KAAK;AAC1C,QAAM,QAAQ,aAAa,KAAK;AAChC,SAAO,GAAG,KAAK,IAAI,KAAK;AAC1B;AAOA,SAAS,mBAAmB,OAA8C;AACxE,SAAO,cAAc,MAAM,IAAI;AACjC;AAOA,SAAS,gBAAgB,OAAwB;AAC/C,QAAM,OAAO,iBAAiB,OAAO,QAAQ,IAAI,KAAK,OAAO,UAAU,WAAW,QAAQ,KAAK,IAAI,CAAC;AACpG,SAAO,KAAK,eAAe,SAAS;AAAA,IAClC,OAAO;AAAA,IACP,KAAK;AAAA,IACL,MAAM;AAAA,IACN,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,EACV,CAAC;AACH;AAGA,SAAS,WAAW,MAAmD;AACrE,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,OAAO,OAAO,KAAK,IAAI;AAC7B,MAAI,KAAK,WAAW,EAAG,QAAO;AAC9B,QAAM,QAAkB,CAAC;AACzB,aAAW,OAAO,MAAM;AACtB,UAAM,QAAQ,KAAK,GAAG;AACtB,UAAM,KAAK,GAAG,GAAG,IAAI,gBAAgB,KAAK,CAAC,EAAE;AAAA,EAC/C;AACA,SAAO,IAAI,MAAM,KAAK,GAAG,CAAC;AAC5B;AAEA,SAAS,gBAAgB,OAAwB;AAC/C,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,OAAO,KAAK,KAAK,IAAI,KAAK,UAAU,KAAK,IAAI;AAAA,EACtD;AACA,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,UAAW,QAAO,OAAO,KAAK;AAChF,MAAI,iBAAiB,MAAO,QAAO,KAAK,UAAU,MAAM,OAAO;AAC/D,MAAI;AAAE,WAAO,KAAK,UAAU,KAAK;AAAA,EAAE,QAAQ;AAAE,WAAO,OAAO,KAAK;AAAA,EAAE;AACpE;AAGA,IAAM,MAAM,OAAO,YAAY,eAAe,OAAO,QAAQ,QAAQ,WAAW,OAAO,QAAQ,GAAG,IAAI;AA+B/F,SAAS,cAAc,OAAiB,SAAwC;AACrF,QAAM,aAAa,SAAS,YAAY;AACxC,QAAM,WAAW,cAAc,CAAC;AAChC,QAAM,aAAa,eAAe,MAAM,KAAK;AAE7C,QAAM,QAAQ,MAAM,KAAK,OAAO,IAAI,WAAW,KAAK,CAAC,KAAK,QAAQ;AAClE,QAAM,WAAW,MAAM,MAAM;AAC7B,QAAM,MAAM,OAAO,aAAa,WAAW,OAAO,QAAQ,IAAI;AAC9D,QAAM,YAAY,gBAAgB,MAAM,SAAS;AAIjD,QAAM,QAAQ,cAAc,MAAM,OAAO,SAAS,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,QAAQ;AACzF,QAAM,SAAS,mBAAmB,KAAK;AACvC,QAAM,UAAU,SAAS,MAAM,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,QAAQ,IAAI;AAC7E,QAAM,QAAQ,OAAO,MAAM,UAAU,YAAY,MAAM,MAAM,SAAS,IAAI,MAAM,QAAQ;AACxF,QAAM,YAAY,QAAQ,MAAM,MAAM,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ,IAAI;AAC3E,QAAM,WAAW,WAAW,MAAM,IAAI;AACtC,QAAM,WAAW,WAAW,MAAM,MAAM,KAAK,MAAM,UAAU,QAAQ,IAAI;AAGzE,QAAM,UAAU,YAAY,aACxB,GAAG,UAAU,GAAG,MAAM,OAAO,GAAG,KAAK,KACrC,MAAM;AACV,SAAO,GAAG,KAAK,IAAI,GAAG,OAAO,SAAS,QAAQ,KAAK,GAAG,OAAO,GAAG,SAAS,IAAI,OAAO,GAAG,QAAQ;AACjG;;;AClOA,IAAM,aAA+C;AAAA,EACnD,OAAO;AAAA,EAAG,MAAM;AAAA,EAAG,MAAM;AAAA,EAAG,OAAO;AACrC;AAEO,IAAM,qBAAN,MAAoD;AAAA,EACjD,WAAW;AAAA,EAEnB,MAAM,WAAW,QAAuC;AACtD,SAAK,WAAW,WAAW,QAAQ,SAAS,MAAM,KAAK;AAAA,EACzD;AAAA,EAEA,MAAM,OAAuB;AAC3B,UAAM,OAAO,WAAW,MAAM,KAAK,KAAK;AACxC,QAAI,OAAO,KAAK,SAAU;AAG1B,UAAM,OAAO,cAAc,OAAO,EAAE,UAAU,KAAK,CAAC;AACpD,QAAI,MAAM,UAAU,QAAS,SAAQ,MAAM,IAAI;AAAA,aACtC,MAAM,UAAU,OAAQ,SAAQ,KAAK,IAAI;AAAA,QAC7C,SAAQ,IAAI,IAAI;AAAA,EACvB;AAAA,EAEA,MAAM,MAAM,SAAkD;AAE5D,WAAO,CAAC;AAAA,EACV;AAAA,EAEA,MAAM,WAA0B;AAAA,EAEhC;AACF;;;AF1BO,IAAM,sBAAN,cAAkC,uBAAyB;AAAA,EACxD,cAAyC;AAAA,EAEjD,cAAc;AACZ,UAAM,EAAE,OAAO,OAAO,CAAC;AAAA,EACzB;AAAA,EAEA,MAAgB,eAAgD;AAC9D,SAAK,cAAc,IAAI,mBAAmB;AAC1C,UAAM,KAAK,YAAY,WAAW,EAAE,OAAO,KAAK,OAAO,MAAM,CAAC;AAC9D,SAAK,IAAI,OAAO,KAAK,6BAA6B;AAClD,WAAO,CAAC,EAAE,YAAY,uCAA0B,UAAU,KAAK,YAAY,CAAC;AAAA,EAC9E;AAAA,EAEA,MAAgB,aAA4B;AAC1C,UAAM,KAAK,aAAa,SAAS;AAAA,EACnC;AAAA,EAEA,iBAAqC;AACnC,QAAI,CAAC,KAAK,YAAa,OAAM,IAAI,MAAM,iCAAiC;AACxE,WAAO,KAAK;AAAA,EACd;AAAA,EAEU,uBAAuB;AAC/B,WAAO,KAAK,OAAO;AAAA,MACjB,UAAU;AAAA,QACR;AAAA,UACE,IAAI;AAAA,UACJ,OAAO;AAAA,UACP,aAAa;AAAA,UACb,SAAS;AAAA,UACT,QAAQ;AAAA,YACN,KAAK,MAAM;AAAA,cACT,MAAM;AAAA,cACN,KAAK;AAAA,cACL,OAAO;AAAA,cACP,SAAS;AAAA,cACT,SAAS;AAAA,gBACP,EAAE,OAAO,SAAS,OAAO,QAAQ;AAAA,gBACjC,EAAE,OAAO,QAAQ,OAAO,OAAO;AAAA,gBAC/B,EAAE,OAAO,QAAQ,OAAO,OAAO;AAAA,gBAC/B,EAAE,OAAO,SAAS,OAAO,QAAQ;AAAA,cACnC;AAAA,YACF,CAAC;AAAA,UACH;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/builtins/console-logging/console-destination.ts","../../../src/builtins/console-logging/console-logging.addon.ts"],"sourcesContent":["/**\n * Zero-dependency log destination that writes every entry to stdout /\n * stderr via the shared `formatLogLine` formatter. Same surface as\n * `WinstonDestination` (full `ILogDestination` contract) but without\n * the rotating-file transport — ideal fallback when the Winston addon\n * is disabled or unavailable (e.g. bare-bones agents, tests).\n */\nimport type { ILogDestination, LogEntry, LogFilter } from '@camstack/types'\nimport { formatLogLine } from '../../logging/formatter.js'\n\ninterface ConsoleConfig {\n  /** Minimum log level to emit. Entries below this level are dropped. */\n  readonly level?: 'debug' | 'info' | 'warn' | 'error'\n}\n\nconst LEVEL_RANK: Readonly<Record<string, number>> = {\n  debug: 0, info: 1, warn: 2, error: 3,\n}\n\nexport class ConsoleDestination implements ILogDestination {\n  private minLevel = 0\n\n  async initialize(config?: ConsoleConfig): Promise<void> {\n    this.minLevel = LEVEL_RANK[config?.level ?? 'info'] ?? 1\n  }\n\n  write(entry: LogEntry): void {\n    const rank = LEVEL_RANK[entry.level] ?? 1\n    if (rank < this.minLevel) return\n    // Always request ANSI colours for the console sink. The formatter still\n    // respects `NO_COLOR` so operators can opt out globally.\n    const line = formatLogLine(entry, { colorize: true })\n    if (entry.level === 'error') console.error(line)\n    else if (entry.level === 'warn') console.warn(line)\n    else console.log(line)\n  }\n\n  async query(_filter: LogFilter): Promise<readonly LogEntry[]> {\n    // Console has no persistence — queries are served by other destinations.\n    return []\n  }\n\n  async shutdown(): Promise<void> {\n    // Nothing to flush — stdout/stderr are process-owned.\n  }\n}\n","import type { ProviderRegistration } from '@camstack/types'\nimport { BaseAddon, logDestinationCapability } from '@camstack/types'\nimport { ConsoleDestination } from './console-destination.js'\n\ninterface ConsoleConfig {\n  readonly level: 'debug' | 'info' | 'warn' | 'error'\n}\n\n/**\n * Console logging addon — zero-dependency stdout/stderr sink that\n * produces the same canonical line format as the Winston built-in.\n * Registers as a `log-destination` capability provider so the shared\n * LogManager fans every entry to both sinks when both are active.\n *\n * Settings live under Cluster → NodeDetail → Settings alongside the\n * Winston addon. Disable one without disabling the other — the\n * LogManager keeps working as long as at least one destination is\n * registered.\n */\nexport class ConsoleLoggingAddon extends BaseAddon<ConsoleConfig> {\n  private destination: ConsoleDestination | null = null\n\n  constructor() {\n    super({ level: 'info' })\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    this.destination = new ConsoleDestination()\n    await this.destination.initialize({ level: this.config.level })\n    this.ctx.logger.info('Console logging initialized')\n    return [{ capability: logDestinationCapability, provider: this.destination }]\n  }\n\n  protected async onShutdown(): Promise<void> {\n    await this.destination?.shutdown()\n  }\n\n  getDestination(): ConsoleDestination {\n    if (!this.destination) throw new Error('Console logging not initialized')\n    return this.destination\n  }\n\n  protected globalSettingsSchema() {\n    return this.schema({\n      sections: [\n        {\n          id: 'console-logging',\n          title: 'Console Logging',\n          description: 'Minimum log level to emit on stdout/stderr. Independent from the rotated-file (Winston) destination.',\n          columns: 2,\n          fields: [\n            this.field({\n              type: 'select',\n              key: 'level',\n              label: 'Log Level',\n              default: 'info',\n              options: [\n                { value: 'debug', label: 'Debug' },\n                { value: 'info', label: 'Info' },\n                { value: 'warn', label: 'Warn' },\n                { value: 'error', label: 'Error' },\n              ],\n            }),\n          ],\n        },\n      ],\n    })\n  }\n}\n"],"mappings":";;;;;;;;AAeA,IAAM,aAA+C;CACnD,OAAO;CAAG,MAAM;CAAG,MAAM;CAAG,OAAO;CACpC;AAED,IAAa,qBAAb,MAA2D;CACzD,WAAmB;CAEnB,MAAM,WAAW,QAAuC;EACtD,KAAK,WAAW,WAAW,QAAQ,SAAS,WAAW;;CAGzD,MAAM,OAAuB;EAE3B,KADa,WAAW,MAAM,UAAU,KAC7B,KAAK,UAAU;EAG1B,MAAM,OAAO,kBAAA,cAAc,OAAO,EAAE,UAAU,MAAM,CAAC;EACrD,IAAI,MAAM,UAAU,SAAS,QAAQ,MAAM,KAAK;OAC3C,IAAI,MAAM,UAAU,QAAQ,QAAQ,KAAK,KAAK;OAC9C,QAAQ,IAAI,KAAK;;CAGxB,MAAM,MAAM,SAAkD;EAE5D,OAAO,EAAE;;CAGX,MAAM,WAA0B;;;;;;;;;;;;;;;ACvBlC,IAAa,sBAAb,cAAyC,gBAAA,UAAyB;CAChE,cAAiD;CAEjD,cAAc;EACZ,MAAM,EAAE,OAAO,QAAQ,CAAC;;CAG1B,MAAgB,eAAgD;EAC9D,KAAK,cAAc,IAAI,oBAAoB;EAC3C,MAAM,KAAK,YAAY,WAAW,EAAE,OAAO,KAAK,OAAO,OAAO,CAAC;EAC/D,KAAK,IAAI,OAAO,KAAK,8BAA8B;EACnD,OAAO,CAAC;GAAE,YAAY,gBAAA;GAA0B,UAAU,KAAK;GAAa,CAAC;;CAG/E,MAAgB,aAA4B;EAC1C,MAAM,KAAK,aAAa,UAAU;;CAGpC,iBAAqC;EACnC,IAAI,CAAC,KAAK,aAAa,MAAM,IAAI,MAAM,kCAAkC;EACzE,OAAO,KAAK;;CAGd,uBAAiC;EAC/B,OAAO,KAAK,OAAO,EACjB,UAAU,CACR;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,SAAS;GACT,QAAQ,CACN,KAAK,MAAM;IACT,MAAM;IACN,KAAK;IACL,OAAO;IACP,SAAS;IACT,SAAS;KACP;MAAE,OAAO;MAAS,OAAO;MAAS;KAClC;MAAE,OAAO;MAAQ,OAAO;MAAQ;KAChC;MAAE,OAAO;MAAQ,OAAO;MAAQ;KAChC;MAAE,OAAO;MAAS,OAAO;MAAS;KACnC;IACF,CAAC,CACH;GACF,CACF,EACF,CAAC"}

package/dist/builtins/console-logging/index.mjs

@@ -1,11 +1,97 @@
-import {
-  ConsoleDestination,
-  ConsoleLoggingAddon
-} from "../../chunk-TB562PZX.mjs";
-import "../../chunk-2F76X6NL.mjs";
-export {
-  ConsoleDestination,
-  ConsoleLoggingAddon,
-  ConsoleLoggingAddon as default
+import { t as formatLogLine } from "../../formatter-C-5An4Bl.mjs";
+import { BaseAddon, logDestinationCapability } from "@camstack/types";
+//#region src/builtins/console-logging/console-destination.ts
+var LEVEL_RANK = {
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3
 };
+var ConsoleDestination = class {
+	minLevel = 0;
+	async initialize(config) {
+		this.minLevel = LEVEL_RANK[config?.level ?? "info"] ?? 1;
+	}
+	write(entry) {
+		if ((LEVEL_RANK[entry.level] ?? 1) < this.minLevel) return;
+		const line = formatLogLine(entry, { colorize: true });
+		if (entry.level === "error") console.error(line);
+		else if (entry.level === "warn") console.warn(line);
+		else console.log(line);
+	}
+	async query(_filter) {
+		return [];
+	}
+	async shutdown() {}
+};
+//#endregion
+//#region src/builtins/console-logging/console-logging.addon.ts
+/**
+* Console logging addon — zero-dependency stdout/stderr sink that
+* produces the same canonical line format as the Winston built-in.
+* Registers as a `log-destination` capability provider so the shared
+* LogManager fans every entry to both sinks when both are active.
+*
+* Settings live under Cluster → NodeDetail → Settings alongside the
+* Winston addon. Disable one without disabling the other — the
+* LogManager keeps working as long as at least one destination is
+* registered.
+*/
+var ConsoleLoggingAddon = class extends BaseAddon {
+	destination = null;
+	constructor() {
+		super({ level: "info" });
+	}
+	async onInitialize() {
+		this.destination = new ConsoleDestination();
+		await this.destination.initialize({ level: this.config.level });
+		this.ctx.logger.info("Console logging initialized");
+		return [{
+			capability: logDestinationCapability,
+			provider: this.destination
+		}];
+	}
+	async onShutdown() {
+		await this.destination?.shutdown();
+	}
+	getDestination() {
+		if (!this.destination) throw new Error("Console logging not initialized");
+		return this.destination;
+	}
+	globalSettingsSchema() {
+		return this.schema({ sections: [{
+			id: "console-logging",
+			title: "Console Logging",
+			description: "Minimum log level to emit on stdout/stderr. Independent from the rotated-file (Winston) destination.",
+			columns: 2,
+			fields: [this.field({
+				type: "select",
+				key: "level",
+				label: "Log Level",
+				default: "info",
+				options: [
+					{
+						value: "debug",
+						label: "Debug"
+					},
+					{
+						value: "info",
+						label: "Info"
+					},
+					{
+						value: "warn",
+						label: "Warn"
+					},
+					{
+						value: "error",
+						label: "Error"
+					}
+				]
+			})]
+		}] });
+	}
+};
+//#endregion
+export { ConsoleDestination, ConsoleLoggingAddon, ConsoleLoggingAddon as default };
+
 //# sourceMappingURL=index.mjs.map

package/dist/builtins/console-logging/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/builtins/console-logging/console-destination.ts","../../../src/builtins/console-logging/console-logging.addon.ts"],"sourcesContent":["/**\n * Zero-dependency log destination that writes every entry to stdout /\n * stderr via the shared `formatLogLine` formatter. Same surface as\n * `WinstonDestination` (full `ILogDestination` contract) but without\n * the rotating-file transport — ideal fallback when the Winston addon\n * is disabled or unavailable (e.g. bare-bones agents, tests).\n */\nimport type { ILogDestination, LogEntry, LogFilter } from '@camstack/types'\nimport { formatLogLine } from '../../logging/formatter.js'\n\ninterface ConsoleConfig {\n  /** Minimum log level to emit. Entries below this level are dropped. */\n  readonly level?: 'debug' | 'info' | 'warn' | 'error'\n}\n\nconst LEVEL_RANK: Readonly<Record<string, number>> = {\n  debug: 0, info: 1, warn: 2, error: 3,\n}\n\nexport class ConsoleDestination implements ILogDestination {\n  private minLevel = 0\n\n  async initialize(config?: ConsoleConfig): Promise<void> {\n    this.minLevel = LEVEL_RANK[config?.level ?? 'info'] ?? 1\n  }\n\n  write(entry: LogEntry): void {\n    const rank = LEVEL_RANK[entry.level] ?? 1\n    if (rank < this.minLevel) return\n    // Always request ANSI colours for the console sink. The formatter still\n    // respects `NO_COLOR` so operators can opt out globally.\n    const line = formatLogLine(entry, { colorize: true })\n    if (entry.level === 'error') console.error(line)\n    else if (entry.level === 'warn') console.warn(line)\n    else console.log(line)\n  }\n\n  async query(_filter: LogFilter): Promise<readonly LogEntry[]> {\n    // Console has no persistence — queries are served by other destinations.\n    return []\n  }\n\n  async shutdown(): Promise<void> {\n    // Nothing to flush — stdout/stderr are process-owned.\n  }\n}\n","import type { ProviderRegistration } from '@camstack/types'\nimport { BaseAddon, logDestinationCapability } from '@camstack/types'\nimport { ConsoleDestination } from './console-destination.js'\n\ninterface ConsoleConfig {\n  readonly level: 'debug' | 'info' | 'warn' | 'error'\n}\n\n/**\n * Console logging addon — zero-dependency stdout/stderr sink that\n * produces the same canonical line format as the Winston built-in.\n * Registers as a `log-destination` capability provider so the shared\n * LogManager fans every entry to both sinks when both are active.\n *\n * Settings live under Cluster → NodeDetail → Settings alongside the\n * Winston addon. Disable one without disabling the other — the\n * LogManager keeps working as long as at least one destination is\n * registered.\n */\nexport class ConsoleLoggingAddon extends BaseAddon<ConsoleConfig> {\n  private destination: ConsoleDestination | null = null\n\n  constructor() {\n    super({ level: 'info' })\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    this.destination = new ConsoleDestination()\n    await this.destination.initialize({ level: this.config.level })\n    this.ctx.logger.info('Console logging initialized')\n    return [{ capability: logDestinationCapability, provider: this.destination }]\n  }\n\n  protected async onShutdown(): Promise<void> {\n    await this.destination?.shutdown()\n  }\n\n  getDestination(): ConsoleDestination {\n    if (!this.destination) throw new Error('Console logging not initialized')\n    return this.destination\n  }\n\n  protected globalSettingsSchema() {\n    return this.schema({\n      sections: [\n        {\n          id: 'console-logging',\n          title: 'Console Logging',\n          description: 'Minimum log level to emit on stdout/stderr. Independent from the rotated-file (Winston) destination.',\n          columns: 2,\n          fields: [\n            this.field({\n              type: 'select',\n              key: 'level',\n              label: 'Log Level',\n              default: 'info',\n              options: [\n                { value: 'debug', label: 'Debug' },\n                { value: 'info', label: 'Info' },\n                { value: 'warn', label: 'Warn' },\n                { value: 'error', label: 'Error' },\n              ],\n            }),\n          ],\n        },\n      ],\n    })\n  }\n}\n"],"mappings":";;;AAeA,IAAM,aAA+C;CACnD,OAAO;CAAG,MAAM;CAAG,MAAM;CAAG,OAAO;CACpC;AAED,IAAa,qBAAb,MAA2D;CACzD,WAAmB;CAEnB,MAAM,WAAW,QAAuC;EACtD,KAAK,WAAW,WAAW,QAAQ,SAAS,WAAW;;CAGzD,MAAM,OAAuB;EAE3B,KADa,WAAW,MAAM,UAAU,KAC7B,KAAK,UAAU;EAG1B,MAAM,OAAO,cAAc,OAAO,EAAE,UAAU,MAAM,CAAC;EACrD,IAAI,MAAM,UAAU,SAAS,QAAQ,MAAM,KAAK;OAC3C,IAAI,MAAM,UAAU,QAAQ,QAAQ,KAAK,KAAK;OAC9C,QAAQ,IAAI,KAAK;;CAGxB,MAAM,MAAM,SAAkD;EAE5D,OAAO,EAAE;;CAGX,MAAM,WAA0B;;;;;;;;;;;;;;;ACvBlC,IAAa,sBAAb,cAAyC,UAAyB;CAChE,cAAiD;CAEjD,cAAc;EACZ,MAAM,EAAE,OAAO,QAAQ,CAAC;;CAG1B,MAAgB,eAAgD;EAC9D,KAAK,cAAc,IAAI,oBAAoB;EAC3C,MAAM,KAAK,YAAY,WAAW,EAAE,OAAO,KAAK,OAAO,OAAO,CAAC;EAC/D,KAAK,IAAI,OAAO,KAAK,8BAA8B;EACnD,OAAO,CAAC;GAAE,YAAY;GAA0B,UAAU,KAAK;GAAa,CAAC;;CAG/E,MAAgB,aAA4B;EAC1C,MAAM,KAAK,aAAa,UAAU;;CAGpC,iBAAqC;EACnC,IAAI,CAAC,KAAK,aAAa,MAAM,IAAI,MAAM,kCAAkC;EACzE,OAAO,KAAK;;CAGd,uBAAiC;EAC/B,OAAO,KAAK,OAAO,EACjB,UAAU,CACR;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,SAAS;GACT,QAAQ,CACN,KAAK,MAAM;IACT,MAAM;IACN,KAAK;IACL,OAAO;IACP,SAAS;IACT,SAAS;KACP;MAAE,OAAO;MAAS,OAAO;MAAS;KAClC;MAAE,OAAO;MAAQ,OAAO;MAAQ;KAChC;MAAE,OAAO;MAAQ,OAAO;MAAQ;KAChC;MAAE,OAAO;MAAS,OAAO;MAAS;KACnC;IACF,CAAC,CACH;GACF,CACF,EACF,CAAC"}

package/dist/builtins/device-manager/device-event-propagator.d.ts

@@ -0,0 +1,27 @@
+import { IEventBus, SystemEvent } from '@camstack/types';
+export interface DeviceEventPropagatorOptions {
+    readonly eventBus: IEventBus;
+    /**
+     * Resolve the numeric parent id of a device, or `null` when the
+     * device has no parent (or was deleted). The propagator injects a
+     * closure over the hub's `DeviceRegistry` so the lookup is in-
+     * process and O(1) per call.
+     */
+    readonly getParentOf: (deviceId: number) => number | null;
+    /** Structured logger for anti-cycle + anti-loop diagnostics. */
+    readonly logger: {
+        warn: (msg: string, meta?: Record<string, unknown>) => void;
+        debug: (msg: string, meta?: Record<string, unknown>) => void;
+    };
+}
+export declare class DeviceEventPropagator {
+    private readonly opts;
+    private unsubscribe;
+    constructor(opts: DeviceEventPropagatorOptions);
+    start(): void;
+    stop(): void;
+    /** Exposed for tests — lets them inject events without the full bus. */
+    handle(ev: SystemEvent): void;
+    private resolveParentChain;
+}
+//# sourceMappingURL=device-event-propagator.d.ts.map

package/dist/builtins/device-manager/device-event-propagator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-event-propagator.d.ts","sourceRoot":"","sources":["../../../src/builtins/device-manager/device-event-propagator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAe,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAqC1E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;IACzD,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE;QACf,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;QAC3D,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;KAC7D,CAAA;CACF;AAED,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,WAAW,CAA4B;gBAElB,IAAI,EAAE,4BAA4B;IAE/D,KAAK,IAAI,IAAI;IASb,IAAI,IAAI,IAAI;IAMZ,wEAAwE;IACxE,MAAM,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI;IAyB7B,OAAO,CAAC,kBAAkB;CAyB3B"}

package/dist/builtins/device-manager/device-manager.addon.d.ts

@@ -0,0 +1,259 @@
+import { ProviderRegistration, BaseAddon, DeviceBindingEntry } from '@camstack/types';
+/**
+ * Wire shape matching `z.infer<typeof SettingsSchemaWithValuesSchema>` —
+ * duplicated as a plain interface because importing the Zod schema across
+ * package boundaries confuses `tsc` when the types package pins a
+ * different `zod` minor than the core package. Keeping the shape local
+ * keeps the addon decoupled from the schema's internal type encoding.
+ */
+interface ContributionShape {
+    tabs?: Array<{
+        id: string;
+        label: string;
+        icon: string;
+        order?: number;
+    }>;
+    sections: Array<{
+        id: string;
+        title: string;
+        description?: string;
+        style?: 'card' | 'accordion';
+        defaultCollapsed?: boolean;
+        columns?: 1 | 2 | 3 | 4;
+        tab?: string;
+        /** Where the section renders. Default 'settings' (Config tab); 'top-tab' hoists into the device-detail tab bar via DeviceDetail discovery. */
+        location?: 'settings' | 'top-tab';
+        order?: number;
+        fields: unknown[];
+    }>;
+}
+export declare class DeviceManagerAddon extends BaseAddon {
+    constructor();
+    /** Shorthand for the kernel-injected capability registry. */
+    private get capabilityRegistry();
+    /**
+     * Parent-chain event propagator. Started in `onInitialize` once the
+     * hub's `deviceRegistry` is available; listens to every device-sourced
+     * event and re-emits a copy on each ancestor scope with `via[]`
+     * populated. Stopped in `onShutdown`.
+     */
+    private propagator;
+    /**
+     * Hub-side mirror of every device's cap-keyed runtime state.
+     * Populated whenever any caller writes via `deviceState.setCapSlice`
+     * (the canonical cross-layer write entrypoint) and on first load
+     * via `loadRuntimeState`. Cross-process consumers reach the mirror
+     * through the `deviceState` cap router; per-cap event subscribers
+     * (e.g. `battery.onStatusChanged`) get the same data via
+     * cap-specific events still emitted by the owning device.
+     *
+     * Key: deviceId. Value: per-cap slice map. Empty by default —
+     * slices show up as `setCapSlice` calls trickle in.
+     */
+    private readonly stateMirror;
+    /**
+     * Per-device disk-write debouncer for runtime-state. `setCapSlice`
+     * updates the in-memory mirror synchronously and emits the change
+     * event immediately, but the disk write is coalesced — frequent
+     * back-to-back writes (motion phase transitions, battery pushes,
+     * etc.) collapse to one `writeDeviceRuntimeState` per
+     * `RUNTIME_STATE_DEBOUNCE_MS` window. `flushRuntimeStateWrites`
+     * awaits any in-flight write + scheduled flush so shutdown is
+     * lossless.
+     */
+    private readonly runtimeStateDebounce;
+    private static readonly RUNTIME_STATE_DEBOUNCE_MS;
+    /**
+     * Cross-process native-provider cache: deviceId (numeric) → capName → { addonId, nodeId }.
+     * Kept in sync with `device.bindings-changed` events emitted by forked
+     * workers. Union'd into `getBindings` so hub-side consumers see every
+     * native cap regardless of which process owns the IDevice. No persistence
+     * — entries re-register when the worker restarts. Purged on
+     * `$node.disconnected` to avoid stale routing after a worker crash.
+     */
+    private remoteNativeCaps;
+    /** Wait for a device-provider by addonId, returning null on timeout. */
+    private waitDeviceProvider;
+    /** Require a device-provider by addonId — throws if not found. */
+    private requireDeviceProvider;
+    private readBindingsStore;
+    private writeBindingsStore;
+    private resolveWrapperNodeId;
+    /**
+     * Active discovery of native caps registered on a worker node.
+     * Called from the `$node.connected` handler to recover from lost
+     * `DeviceBindingsChanged` broadcasts after worker restart.
+     *
+     * Iterates the broker's service registry, picks
+     * `<addonId>.native-provider.<capName>` services owned by the
+     * connected node, calls each service's `$listDeviceIds` action to
+     * fetch the deviceIds the worker has registered that cap on, then
+     * writes entries into `remoteNativeCaps`.
+     *
+     * Best-effort: per-service failures are logged and swallowed so a
+     * single bad service doesn't abort the whole rebuild.
+     */
+    private discoverWorkerNativeCaps;
+    getBindings(input: {
+        deviceId: number;
+    }): Promise<{
+        deviceId: number;
+        entries: DeviceBindingEntry[];
+    }>;
+    /**
+     * Whole-fleet binding dump. Iterates every device known to the
+     * deviceRegistry and reuses the per-device `getBindings` resolver
+     * for each — same routing rules, single round-trip. Used by
+     * `SystemManager.init()` for warm-boot.
+     *
+     * Bindings change rarely (wrapper toggle, device add/remove) so
+     * clients invalidate via the existing
+     * `capability.binding-changed` event rather than re-fetching this
+     * payload periodically.
+     */
+    getAllBindings(): Promise<Array<{
+        deviceId: number;
+        entries: DeviceBindingEntry[];
+    }>>;
+    /**
+     * Resolve a numeric deviceId to a stableId via persisted meta.
+     * Used only by the device-identity section of the device-details
+     * aggregator (see `buildBaseDeviceSection`) to surface the stableId as
+     * a readonly display field. All runtime/registry lookups are keyed by
+     * numeric deviceId; this helper is display-only.
+     */
+    private lookupPersistedStableId;
+    getDeviceAggregate(deviceId: number, kind: 'settings' | 'live'): Promise<ContributionShape | null>;
+    /**
+     * Build the device-manager's own contribution to the aggregator — the
+     * device identity (id, stableId, addonId, type, online) + the
+     * driver-specific config exposed by the device class via
+     * `zodEntriesToConfigUI`.
+     *
+     * Two paths, deliberately symmetric with `getSettingsSchema`:
+     *
+     *  - Hub-local: device's IDevice instance lives in this process'
+     *    DeviceRegistry, we read config + schema directly by reference.
+     *  - Cross-process: device lives in a forked worker (RtspCamera on
+     *    provider-rtsp, ONVIF on provider-onvif, …). We ask the worker's
+     *    `device-ops.getSettingsSchema` native provider for a wire-
+     *    serializable ConfigUISchema and merge it in under the same
+     *    "Driver Config" section, so the UI sees the same shape regardless
+     *    of where the IDevice physically runs.
+     *
+     *  Returns `null` only when the device genuinely doesn't exist anywhere
+     *  (no hub-local, no persisted ownership, no device-ops native). The
+     *  aggregator falls back to contributor sections only in that case.
+     */
+    private buildBaseDeviceSection;
+    /**
+     * Lookup the native owner for `device-ops` on `deviceId` — the native-cap
+     * registry (hub-local and remote) is keyed by numeric id.
+     */
+    private resolveNativeDeviceOwner;
+    /**
+     * Aggregate `status` across every registered cap for a device.
+     *
+     * Walks the supplied cap list (or `CAP_NAMES_WITH_STATUS` when
+     * omitted), looks up a native provider per cap via the capability
+     * registry, calls `provider.getStatus({ deviceId })`, and validates
+     * the return against the cap's own `status.schema`. Validation
+     * failures log a warning and yield `null` for that cap so the
+     * overall aggregate stays usable — a single misbehaving provider
+     * must not blank out a device's entire status view.
+     *
+     * Returned shape is `Record<capName, unknown | null>`; the client-
+     * side hook tightens this to `CapStatusTypeMap` via the generated
+     * `cap-status-types.ts`.
+     */
+    private getDeviceStatusAggregate;
+    /**
+     * Return the driver-specific device-settings contribution. Hub-local
+     * devices call `getSettingsUISchema()` directly; forked-worker devices
+     * go through the `device-ops.getSettingsSchema` cap method on the
+     * numeric-id-keyed native registry.
+     */
+    private resolveDriverConfigSchema;
+    updateDeviceField(input: {
+        deviceId: number;
+        writerCapName: string;
+        writerAddonId: string;
+        key: string;
+        value: unknown;
+    }): Promise<{
+        success: true;
+    }>;
+    /**
+     * Batched counterpart of `updateDeviceField`. Groups changes by
+     * `(writerCapName, writerAddonId)` so each contributor receives a
+     * single `applyDeviceSettingsPatch` with all of its updates merged —
+     * avoids N round-trips for simultaneous edits in the same save.
+     *
+     * Per-provider failures are captured in the `failures[]` output so the
+     * admin UI can highlight which sections didn't persist; a failure on
+     * one provider does NOT abort the others.
+     */
+    updateDeviceFieldsBatch(input: {
+        deviceId: number;
+        changes: ReadonlyArray<{
+            writerCapName: string;
+            writerAddonId: string;
+            key: string;
+            value: unknown;
+        }>;
+    }): Promise<{
+        success: true;
+        failures: {
+            writerCapName: string;
+            writerAddonId: string;
+            error: string;
+        }[];
+    }>;
+    /** Apply a single grouped patch to the appropriate provider. Mirrors
+     * `updateDeviceField` routing (special-case device-manager, else
+     * registry lookup). Used by `updateDeviceFieldsBatch`. */
+    private applyGroupPatch;
+    listWrappersForCap(input: {
+        capName: string;
+    }): Promise<string[]>;
+    listBindableCapsForDeviceType(input: {
+        deviceType: string;
+    }): Promise<Array<{
+        capName: string;
+        wrappers: string[];
+    }>>;
+    setWrapperActive(input: {
+        deviceId: number;
+        capName: string;
+        wrapperAddonId: string;
+        active: boolean;
+    }): Promise<void>;
+    protected onInitialize(): Promise<ProviderRegistration[] | void>;
+    /**
+     * Single-cap mirror update — diff against the current mirror,
+     * persist the new slice in-memory, emit `DeviceStateChanged` for
+     * this cap. No-op on identical writes (both same shape and same
+     * values). Called by `setCapSlice` provider.
+     */
+    private applySingleCapUpdate;
+    /**
+     * Debounced disk writer. Coalesces frequent writes (motion phase
+     * transitions, battery pushes) into one `writeDeviceRuntimeState`
+     * per `RUNTIME_STATE_DEBOUNCE_MS` window. Reads the per-device
+     * blob from the live mirror at flush time so the disk picture is
+     * always the latest state — no risk of writing a stale snapshot.
+     */
+    private scheduleRuntimeStateDiskWrite;
+    /**
+     * One-shot mirror seed used by `loadRuntimeState` at boot so the
+     * hub knows about every persisted slice without waiting for the
+     * first `setCapSlice` call. No events emitted — this is
+     * initial-state population, not a transition.
+     */
+    private seedMirror;
+    private snapshotForDevice;
+    private emitStateChanged;
+    protected onShutdown(): Promise<void>;
+}
+export default DeviceManagerAddon;
+//# sourceMappingURL=device-manager.addon.d.ts.map

package/dist/builtins/device-manager/device-manager.addon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-manager.addon.d.ts","sourceRoot":"","sources":["../../../src/builtins/device-manager/device-manager.addon.ts"],"names":[],"mappings":"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"}