@camstack/core 0.1.14 → 0.1.16

package/dist/builtins/system-config/system-config.addon.js

@@ -0,0 +1,234 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+require("../../chunk-C13QxCFV.js");
+let _camstack_types = require("@camstack/types");
+//#region src/builtins/system-config/system-config.addon.ts
+/**
+* Built-in `system-config` addon — Phase 4 of the settings redesign.
+*
+* Exposes the cluster-wide yml-backed sections that the bootstrap
+* loader reads before any addon is instantiated — things that cannot
+* live inside an addon because changing them requires a server
+* restart (port, host, dataPath) or because they own no runtime
+* state of their own (auth token expiry, global ffmpeg binary path).
+*
+* Sections exposed:
+*   - server     (port, host, dataPath — READ-ONLY, loaded from config.yaml at bootstrap)
+*   - auth       (tokenExpiry)
+*   - ffmpeg     (binaryPath, hwAccel, threadCount)
+*
+* Sections NOT exposed (each owned by the addon that implements them):
+*   - logging    → `winston-logging` addon (level + retention)
+*   - recording  → `recording` addon (segment duration, retention)
+*   - retention  → analytics / detection addons (per-table retention)
+*
+* Implementation notes:
+*   - Runs only on the hub process (yml sections are hub-side state).
+*     On agent nodes this addon would still instantiate, but every
+*     `ctx.settings.getSection(section)` call would hit an empty
+*     ConfigManager section so the UI would show the schema defaults.
+*     In practice the built-in loader can skip it on agents; for now we
+*     just let it run everywhere because it's harmless.
+*   - Reads via `ctx.settings.getSection(section)` and writes via
+*     `ctx.settings.setSection(section, patch)` — the explicit
+*     yml-section pair on `AddonSettingsApi`.
+*   - Does NOT register as a capability provider. It's a pure "settings
+*     surface" addon — its sole purpose is to expose the yml sections
+*     through the new three-level settings API.
+*
+* This addon is declared in `@camstack/core`'s package.json `camstack.addons[]`
+* and loaded automatically via AddonLoader like any other core built-in.
+*/
+/** Section key → user-facing section title. */
+var SECTION_TITLES = {
+	server: "Server",
+	auth: "Authentication",
+	ffmpeg: "FFmpeg"
+};
+/** Keys that map 1:1 to a given yml section — used by `updateGlobalSettings`
+*  to figure out which section owns each key in the incoming patch. */
+var KEY_TO_SECTION = {
+	port: "server",
+	host: "server",
+	dataPath: "server",
+	tokenExpiry: "auth",
+	binaryPath: "ffmpeg",
+	hwAccel: "ffmpeg",
+	threadCount: "ffmpeg"
+};
+var SystemConfigAddon = class extends _camstack_types.BaseAddon {
+	id = "system-config";
+	constructor() {
+		super({});
+	}
+	async onInitialize() {
+		this.ctx.logger.info("Initialized — exposes yml-backed sections via getGlobalSettings");
+	}
+	buildGlobalSchema() {
+		return { sections: [
+			{
+				id: "system-config-server",
+				title: SECTION_TITLES["server"],
+				description: "Core server connection settings — read-only, loaded from config.yaml at bootstrap.",
+				columns: 2,
+				fields: [
+					{
+						type: "info",
+						key: "server-restart-note",
+						label: "Restart required",
+						content: "Server settings are read-only. Change them in config.yaml and restart.",
+						variant: "warning"
+					},
+					{
+						type: "text",
+						key: "port",
+						label: "Port",
+						description: "Listening port",
+						disabled: true
+					},
+					{
+						type: "text",
+						key: "host",
+						label: "Host",
+						description: "Bind address",
+						disabled: true
+					},
+					{
+						type: "text",
+						key: "dataPath",
+						label: "Data Path",
+						description: "Root data directory",
+						disabled: true,
+						span: 2
+					}
+				]
+			},
+			{
+				id: "system-config-auth",
+				title: SECTION_TITLES["auth"],
+				description: "Token and session settings.",
+				columns: 1,
+				fields: [{
+					type: "text",
+					key: "tokenExpiry",
+					label: "Token Expiry",
+					description: "JWT token lifetime (e.g. 24h, 7d, 1h)",
+					placeholder: "24h",
+					default: "24h"
+				}]
+			},
+			{
+				id: "system-config-ffmpeg",
+				title: SECTION_TITLES["ffmpeg"],
+				description: "FFmpeg binary and hardware acceleration settings.",
+				columns: 2,
+				fields: [
+					{
+						type: "text",
+						key: "binaryPath",
+						label: "Binary Path",
+						description: "Path to ffmpeg executable",
+						placeholder: "ffmpeg",
+						default: "ffmpeg",
+						span: 2
+					},
+					{
+						type: "select",
+						key: "hwAccel",
+						label: "Hardware Acceleration",
+						description: "GPU decoding/encoding backend",
+						default: "auto",
+						options: [
+							{
+								value: "auto",
+								label: "Auto-detect"
+							},
+							{
+								value: "none",
+								label: "None (CPU only)"
+							},
+							{
+								value: "videotoolbox",
+								label: "VideoToolbox (macOS)"
+							},
+							{
+								value: "vaapi",
+								label: "VA-API (Linux Intel/AMD)"
+							},
+							{
+								value: "qsv",
+								label: "QSV (Intel Quick Sync)"
+							},
+							{
+								value: "cuda",
+								label: "CUDA (NVIDIA)"
+							}
+						]
+					},
+					{
+						type: "number",
+						key: "threadCount",
+						label: "Thread Count",
+						description: "0 = auto (let FFmpeg decide)",
+						min: 0,
+						max: 16,
+						step: 1,
+						default: 0
+					}
+				]
+			}
+		] };
+	}
+	async getGlobalSettings() {
+		const schema = this.buildGlobalSchema();
+		if (!this.ctx.settings) return (0, _camstack_types.hydrateSchema)(schema, {});
+		const sectionNames = Object.keys(SECTION_TITLES);
+		const merged = {};
+		for (const section of sectionNames) try {
+			const values = await this.ctx.settings.getSection(section);
+			Object.assign(merged, values);
+		} catch (err) {
+			const msg = (0, _camstack_types.errMsg)(err);
+			this.ctx.logger.debug("Failed to read section", { meta: {
+				section,
+				error: msg
+			} });
+		}
+		return (0, _camstack_types.hydrateSchema)(schema, merged);
+	}
+	async updateGlobalSettings(patch) {
+		if (!this.ctx.settings) throw new Error("system-config: ctx.settings not available — cannot write sections");
+		const perSection = /* @__PURE__ */ new Map();
+		for (const [key, value] of Object.entries(patch)) {
+			const section = KEY_TO_SECTION[key];
+			if (section === void 0) {
+				this.ctx.logger.warn("update ignored unknown key (not mapped to any section)", { meta: { key } });
+				continue;
+			}
+			if (section === "server") {
+				this.ctx.logger.warn("update ignored read-only server-section key", { meta: { key } });
+				continue;
+			}
+			let bucket = perSection.get(section);
+			if (!bucket) {
+				bucket = {};
+				perSection.set(section, bucket);
+			}
+			bucket[key] = value;
+		}
+		for (const [section, sectionPatch] of perSection) {
+			await this.ctx.settings.setSection(section, sectionPatch);
+			this.ctx.logger.info("Wrote keys to section", { meta: {
+				section,
+				keyCount: Object.keys(sectionPatch).length
+			} });
+		}
+	}
+};
+//#endregion
+exports.SystemConfigAddon = SystemConfigAddon;
+exports.default = SystemConfigAddon;
+
+//# sourceMappingURL=system-config.addon.js.map

package/dist/builtins/system-config/system-config.addon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-config.addon.js","names":[],"sources":["../../../src/builtins/system-config/system-config.addon.ts"],"sourcesContent":["import type {\n  ConfigUISchema,\n  ConfigUISchemaWithValues,\n} from '@camstack/types'\nimport { BaseAddon, hydrateSchema , errMsg } from '@camstack/types'\n\n/**\n * Built-in `system-config` addon — Phase 4 of the settings redesign.\n *\n * Exposes the cluster-wide yml-backed sections that the bootstrap\n * loader reads before any addon is instantiated — things that cannot\n * live inside an addon because changing them requires a server\n * restart (port, host, dataPath) or because they own no runtime\n * state of their own (auth token expiry, global ffmpeg binary path).\n *\n * Sections exposed:\n *   - server     (port, host, dataPath — READ-ONLY, loaded from config.yaml at bootstrap)\n *   - auth       (tokenExpiry)\n *   - ffmpeg     (binaryPath, hwAccel, threadCount)\n *\n * Sections NOT exposed (each owned by the addon that implements them):\n *   - logging    → `winston-logging` addon (level + retention)\n *   - recording  → `recording` addon (segment duration, retention)\n *   - retention  → analytics / detection addons (per-table retention)\n *\n * Implementation notes:\n *   - Runs only on the hub process (yml sections are hub-side state).\n *     On agent nodes this addon would still instantiate, but every\n *     `ctx.settings.getSection(section)` call would hit an empty\n *     ConfigManager section so the UI would show the schema defaults.\n *     In practice the built-in loader can skip it on agents; for now we\n *     just let it run everywhere because it's harmless.\n *   - Reads via `ctx.settings.getSection(section)` and writes via\n *     `ctx.settings.setSection(section, patch)` — the explicit\n *     yml-section pair on `AddonSettingsApi`.\n *   - Does NOT register as a capability provider. It's a pure \"settings\n *     surface\" addon — its sole purpose is to expose the yml sections\n *     through the new three-level settings API.\n *\n * This addon is declared in `@camstack/core`'s package.json `camstack.addons[]`\n * and loaded automatically via AddonLoader like any other core built-in.\n */\n\n/** Section key → user-facing section title. */\nconst SECTION_TITLES: Readonly<Record<string, string>> = {\n  server: 'Server',\n  auth: 'Authentication',\n  ffmpeg: 'FFmpeg',\n}\n\n/** Keys that map 1:1 to a given yml section — used by `updateGlobalSettings`\n *  to figure out which section owns each key in the incoming patch. */\nconst KEY_TO_SECTION: Readonly<Record<string, string>> = {\n  // server (read-only)\n  port: 'server',\n  host: 'server',\n  dataPath: 'server',\n  // auth\n  tokenExpiry: 'auth',\n  // ffmpeg\n  binaryPath: 'ffmpeg',\n  hwAccel: 'ffmpeg',\n  threadCount: 'ffmpeg',\n}\n\nexport class SystemConfigAddon extends BaseAddon {\n  readonly id = 'system-config'\n\n  constructor() { super({}) }\n\n  protected async onInitialize(): Promise<void> {\n    this.ctx.logger.info('Initialized — exposes yml-backed sections via getGlobalSettings')\n  }\n\n  // ── Three-level settings API (only `getGlobalSettings` is implemented) ──\n\n  private buildGlobalSchema(): ConfigUISchema {\n    return {\n      sections: [\n        {\n          id: 'system-config-server',\n          title: SECTION_TITLES['server']!,\n          description: 'Core server connection settings — read-only, loaded from config.yaml at bootstrap.',\n          columns: 2,\n          fields: [\n            {\n              type: 'info',\n              key: 'server-restart-note',\n              label: 'Restart required',\n              content: 'Server settings are read-only. Change them in config.yaml and restart.',\n              variant: 'warning',\n            },\n            { type: 'text', key: 'port', label: 'Port', description: 'Listening port', disabled: true },\n            { type: 'text', key: 'host', label: 'Host', description: 'Bind address', disabled: true },\n            { type: 'text', key: 'dataPath', label: 'Data Path', description: 'Root data directory', disabled: true, span: 2 },\n          ],\n        },\n        {\n          id: 'system-config-auth',\n          title: SECTION_TITLES['auth']!,\n          description: 'Token and session settings.',\n          columns: 1,\n          fields: [\n            {\n              type: 'text',\n              key: 'tokenExpiry',\n              label: 'Token Expiry',\n              description: 'JWT token lifetime (e.g. 24h, 7d, 1h)',\n              placeholder: '24h',\n              default: '24h',\n            },\n          ],\n        },\n        {\n          id: 'system-config-ffmpeg',\n          title: SECTION_TITLES['ffmpeg']!,\n          description: 'FFmpeg binary and hardware acceleration settings.',\n          columns: 2,\n          fields: [\n            {\n              type: 'text',\n              key: 'binaryPath',\n              label: 'Binary Path',\n              description: 'Path to ffmpeg executable',\n              placeholder: 'ffmpeg',\n              default: 'ffmpeg',\n              span: 2,\n            },\n            {\n              type: 'select',\n              key: 'hwAccel',\n              label: 'Hardware Acceleration',\n              description: 'GPU decoding/encoding backend',\n              default: 'auto',\n              options: [\n                { value: 'auto', label: 'Auto-detect' },\n                { value: 'none', label: 'None (CPU only)' },\n                { value: 'videotoolbox', label: 'VideoToolbox (macOS)' },\n                { value: 'vaapi', label: 'VA-API (Linux Intel/AMD)' },\n                { value: 'qsv', label: 'QSV (Intel Quick Sync)' },\n                { value: 'cuda', label: 'CUDA (NVIDIA)' },\n              ],\n            },\n            {\n              type: 'number',\n              key: 'threadCount',\n              label: 'Thread Count',\n              description: '0 = auto (let FFmpeg decide)',\n              min: 0,\n              max: 16,\n              step: 1,\n              default: 0,\n            },\n          ],\n        },\n      ],\n    }\n  }\n\n  async getGlobalSettings(): Promise<ConfigUISchemaWithValues> {\n    const schema = this.buildGlobalSchema()\n    if (!this.ctx.settings) {\n      return hydrateSchema(schema, {})\n    }\n\n    // Read all yml sections in parallel and merge their values into a\n    // single flat record keyed by field name. The `KEY_TO_SECTION` map\n    // guarantees uniqueness (each key belongs to exactly one section).\n    const sectionNames = Object.keys(SECTION_TITLES)\n    const merged: Record<string, unknown> = {}\n    for (const section of sectionNames) {\n      try {\n        const values = await this.ctx.settings!.getSection(section)\n        Object.assign(merged, values)\n      } catch (err: unknown) {\n        const msg = errMsg(err)\n        this.ctx.logger.debug('Failed to read section', { meta: { section, error: msg } })\n      }\n    }\n\n    return hydrateSchema(schema, merged)\n  }\n\n  async updateGlobalSettings(patch: Record<string, unknown>): Promise<void> {\n    if (!this.ctx.settings) {\n      throw new Error('system-config: ctx.settings not available — cannot write sections')\n    }\n\n    // Group the patch keys by the section they belong to, then write\n    // each section in one shot via ctx.settings.setSection(). The\n    // server section is read-only, so any keys targeting it are skipped\n    // with a warning.\n    const perSection = new Map<string, Record<string, unknown>>()\n    for (const [key, value] of Object.entries(patch)) {\n      const section = KEY_TO_SECTION[key]\n      if (section === undefined) {\n        this.ctx.logger.warn('update ignored unknown key (not mapped to any section)', { meta: { key } })\n        continue\n      }\n      if (section === 'server') {\n        this.ctx.logger.warn('update ignored read-only server-section key', { meta: { key } })\n        continue\n      }\n      let bucket = perSection.get(section)\n      if (!bucket) {\n        bucket = {}\n        perSection.set(section, bucket)\n      }\n      bucket[key] = value\n    }\n\n    for (const [section, sectionPatch] of perSection) {\n      await this.ctx.settings!.setSection(section, sectionPatch)\n      this.ctx.logger.info('Wrote keys to section', { meta: { section, keyCount: Object.keys(sectionPatch).length } })\n    }\n  }\n}\n\nexport default SystemConfigAddon\n"],"mappings":"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"}

package/dist/builtins/system-config/system-config.addon.mjs

@@ -0,0 +1,228 @@
+import { BaseAddon, errMsg, hydrateSchema } from "@camstack/types";
+//#region src/builtins/system-config/system-config.addon.ts
+/**
+* Built-in `system-config` addon — Phase 4 of the settings redesign.
+*
+* Exposes the cluster-wide yml-backed sections that the bootstrap
+* loader reads before any addon is instantiated — things that cannot
+* live inside an addon because changing them requires a server
+* restart (port, host, dataPath) or because they own no runtime
+* state of their own (auth token expiry, global ffmpeg binary path).
+*
+* Sections exposed:
+*   - server     (port, host, dataPath — READ-ONLY, loaded from config.yaml at bootstrap)
+*   - auth       (tokenExpiry)
+*   - ffmpeg     (binaryPath, hwAccel, threadCount)
+*
+* Sections NOT exposed (each owned by the addon that implements them):
+*   - logging    → `winston-logging` addon (level + retention)
+*   - recording  → `recording` addon (segment duration, retention)
+*   - retention  → analytics / detection addons (per-table retention)
+*
+* Implementation notes:
+*   - Runs only on the hub process (yml sections are hub-side state).
+*     On agent nodes this addon would still instantiate, but every
+*     `ctx.settings.getSection(section)` call would hit an empty
+*     ConfigManager section so the UI would show the schema defaults.
+*     In practice the built-in loader can skip it on agents; for now we
+*     just let it run everywhere because it's harmless.
+*   - Reads via `ctx.settings.getSection(section)` and writes via
+*     `ctx.settings.setSection(section, patch)` — the explicit
+*     yml-section pair on `AddonSettingsApi`.
+*   - Does NOT register as a capability provider. It's a pure "settings
+*     surface" addon — its sole purpose is to expose the yml sections
+*     through the new three-level settings API.
+*
+* This addon is declared in `@camstack/core`'s package.json `camstack.addons[]`
+* and loaded automatically via AddonLoader like any other core built-in.
+*/
+/** Section key → user-facing section title. */
+var SECTION_TITLES = {
+	server: "Server",
+	auth: "Authentication",
+	ffmpeg: "FFmpeg"
+};
+/** Keys that map 1:1 to a given yml section — used by `updateGlobalSettings`
+*  to figure out which section owns each key in the incoming patch. */
+var KEY_TO_SECTION = {
+	port: "server",
+	host: "server",
+	dataPath: "server",
+	tokenExpiry: "auth",
+	binaryPath: "ffmpeg",
+	hwAccel: "ffmpeg",
+	threadCount: "ffmpeg"
+};
+var SystemConfigAddon = class extends BaseAddon {
+	id = "system-config";
+	constructor() {
+		super({});
+	}
+	async onInitialize() {
+		this.ctx.logger.info("Initialized — exposes yml-backed sections via getGlobalSettings");
+	}
+	buildGlobalSchema() {
+		return { sections: [
+			{
+				id: "system-config-server",
+				title: SECTION_TITLES["server"],
+				description: "Core server connection settings — read-only, loaded from config.yaml at bootstrap.",
+				columns: 2,
+				fields: [
+					{
+						type: "info",
+						key: "server-restart-note",
+						label: "Restart required",
+						content: "Server settings are read-only. Change them in config.yaml and restart.",
+						variant: "warning"
+					},
+					{
+						type: "text",
+						key: "port",
+						label: "Port",
+						description: "Listening port",
+						disabled: true
+					},
+					{
+						type: "text",
+						key: "host",
+						label: "Host",
+						description: "Bind address",
+						disabled: true
+					},
+					{
+						type: "text",
+						key: "dataPath",
+						label: "Data Path",
+						description: "Root data directory",
+						disabled: true,
+						span: 2
+					}
+				]
+			},
+			{
+				id: "system-config-auth",
+				title: SECTION_TITLES["auth"],
+				description: "Token and session settings.",
+				columns: 1,
+				fields: [{
+					type: "text",
+					key: "tokenExpiry",
+					label: "Token Expiry",
+					description: "JWT token lifetime (e.g. 24h, 7d, 1h)",
+					placeholder: "24h",
+					default: "24h"
+				}]
+			},
+			{
+				id: "system-config-ffmpeg",
+				title: SECTION_TITLES["ffmpeg"],
+				description: "FFmpeg binary and hardware acceleration settings.",
+				columns: 2,
+				fields: [
+					{
+						type: "text",
+						key: "binaryPath",
+						label: "Binary Path",
+						description: "Path to ffmpeg executable",
+						placeholder: "ffmpeg",
+						default: "ffmpeg",
+						span: 2
+					},
+					{
+						type: "select",
+						key: "hwAccel",
+						label: "Hardware Acceleration",
+						description: "GPU decoding/encoding backend",
+						default: "auto",
+						options: [
+							{
+								value: "auto",
+								label: "Auto-detect"
+							},
+							{
+								value: "none",
+								label: "None (CPU only)"
+							},
+							{
+								value: "videotoolbox",
+								label: "VideoToolbox (macOS)"
+							},
+							{
+								value: "vaapi",
+								label: "VA-API (Linux Intel/AMD)"
+							},
+							{
+								value: "qsv",
+								label: "QSV (Intel Quick Sync)"
+							},
+							{
+								value: "cuda",
+								label: "CUDA (NVIDIA)"
+							}
+						]
+					},
+					{
+						type: "number",
+						key: "threadCount",
+						label: "Thread Count",
+						description: "0 = auto (let FFmpeg decide)",
+						min: 0,
+						max: 16,
+						step: 1,
+						default: 0
+					}
+				]
+			}
+		] };
+	}
+	async getGlobalSettings() {
+		const schema = this.buildGlobalSchema();
+		if (!this.ctx.settings) return hydrateSchema(schema, {});
+		const sectionNames = Object.keys(SECTION_TITLES);
+		const merged = {};
+		for (const section of sectionNames) try {
+			const values = await this.ctx.settings.getSection(section);
+			Object.assign(merged, values);
+		} catch (err) {
+			const msg = errMsg(err);
+			this.ctx.logger.debug("Failed to read section", { meta: {
+				section,
+				error: msg
+			} });
+		}
+		return hydrateSchema(schema, merged);
+	}
+	async updateGlobalSettings(patch) {
+		if (!this.ctx.settings) throw new Error("system-config: ctx.settings not available — cannot write sections");
+		const perSection = /* @__PURE__ */ new Map();
+		for (const [key, value] of Object.entries(patch)) {
+			const section = KEY_TO_SECTION[key];
+			if (section === void 0) {
+				this.ctx.logger.warn("update ignored unknown key (not mapped to any section)", { meta: { key } });
+				continue;
+			}
+			if (section === "server") {
+				this.ctx.logger.warn("update ignored read-only server-section key", { meta: { key } });
+				continue;
+			}
+			let bucket = perSection.get(section);
+			if (!bucket) {
+				bucket = {};
+				perSection.set(section, bucket);
+			}
+			bucket[key] = value;
+		}
+		for (const [section, sectionPatch] of perSection) {
+			await this.ctx.settings.setSection(section, sectionPatch);
+			this.ctx.logger.info("Wrote keys to section", { meta: {
+				section,
+				keyCount: Object.keys(sectionPatch).length
+			} });
+		}
+	}
+};
+//#endregion
+export { SystemConfigAddon, SystemConfigAddon as default };
+
+//# sourceMappingURL=system-config.addon.mjs.map

package/dist/builtins/system-config/system-config.addon.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-config.addon.mjs","names":[],"sources":["../../../src/builtins/system-config/system-config.addon.ts"],"sourcesContent":["import type {\n  ConfigUISchema,\n  ConfigUISchemaWithValues,\n} from '@camstack/types'\nimport { BaseAddon, hydrateSchema , errMsg } from '@camstack/types'\n\n/**\n * Built-in `system-config` addon — Phase 4 of the settings redesign.\n *\n * Exposes the cluster-wide yml-backed sections that the bootstrap\n * loader reads before any addon is instantiated — things that cannot\n * live inside an addon because changing them requires a server\n * restart (port, host, dataPath) or because they own no runtime\n * state of their own (auth token expiry, global ffmpeg binary path).\n *\n * Sections exposed:\n *   - server     (port, host, dataPath — READ-ONLY, loaded from config.yaml at bootstrap)\n *   - auth       (tokenExpiry)\n *   - ffmpeg     (binaryPath, hwAccel, threadCount)\n *\n * Sections NOT exposed (each owned by the addon that implements them):\n *   - logging    → `winston-logging` addon (level + retention)\n *   - recording  → `recording` addon (segment duration, retention)\n *   - retention  → analytics / detection addons (per-table retention)\n *\n * Implementation notes:\n *   - Runs only on the hub process (yml sections are hub-side state).\n *     On agent nodes this addon would still instantiate, but every\n *     `ctx.settings.getSection(section)` call would hit an empty\n *     ConfigManager section so the UI would show the schema defaults.\n *     In practice the built-in loader can skip it on agents; for now we\n *     just let it run everywhere because it's harmless.\n *   - Reads via `ctx.settings.getSection(section)` and writes via\n *     `ctx.settings.setSection(section, patch)` — the explicit\n *     yml-section pair on `AddonSettingsApi`.\n *   - Does NOT register as a capability provider. It's a pure \"settings\n *     surface\" addon — its sole purpose is to expose the yml sections\n *     through the new three-level settings API.\n *\n * This addon is declared in `@camstack/core`'s package.json `camstack.addons[]`\n * and loaded automatically via AddonLoader like any other core built-in.\n */\n\n/** Section key → user-facing section title. */\nconst SECTION_TITLES: Readonly<Record<string, string>> = {\n  server: 'Server',\n  auth: 'Authentication',\n  ffmpeg: 'FFmpeg',\n}\n\n/** Keys that map 1:1 to a given yml section — used by `updateGlobalSettings`\n *  to figure out which section owns each key in the incoming patch. */\nconst KEY_TO_SECTION: Readonly<Record<string, string>> = {\n  // server (read-only)\n  port: 'server',\n  host: 'server',\n  dataPath: 'server',\n  // auth\n  tokenExpiry: 'auth',\n  // ffmpeg\n  binaryPath: 'ffmpeg',\n  hwAccel: 'ffmpeg',\n  threadCount: 'ffmpeg',\n}\n\nexport class SystemConfigAddon extends BaseAddon {\n  readonly id = 'system-config'\n\n  constructor() { super({}) }\n\n  protected async onInitialize(): Promise<void> {\n    this.ctx.logger.info('Initialized — exposes yml-backed sections via getGlobalSettings')\n  }\n\n  // ── Three-level settings API (only `getGlobalSettings` is implemented) ──\n\n  private buildGlobalSchema(): ConfigUISchema {\n    return {\n      sections: [\n        {\n          id: 'system-config-server',\n          title: SECTION_TITLES['server']!,\n          description: 'Core server connection settings — read-only, loaded from config.yaml at bootstrap.',\n          columns: 2,\n          fields: [\n            {\n              type: 'info',\n              key: 'server-restart-note',\n              label: 'Restart required',\n              content: 'Server settings are read-only. Change them in config.yaml and restart.',\n              variant: 'warning',\n            },\n            { type: 'text', key: 'port', label: 'Port', description: 'Listening port', disabled: true },\n            { type: 'text', key: 'host', label: 'Host', description: 'Bind address', disabled: true },\n            { type: 'text', key: 'dataPath', label: 'Data Path', description: 'Root data directory', disabled: true, span: 2 },\n          ],\n        },\n        {\n          id: 'system-config-auth',\n          title: SECTION_TITLES['auth']!,\n          description: 'Token and session settings.',\n          columns: 1,\n          fields: [\n            {\n              type: 'text',\n              key: 'tokenExpiry',\n              label: 'Token Expiry',\n              description: 'JWT token lifetime (e.g. 24h, 7d, 1h)',\n              placeholder: '24h',\n              default: '24h',\n            },\n          ],\n        },\n        {\n          id: 'system-config-ffmpeg',\n          title: SECTION_TITLES['ffmpeg']!,\n          description: 'FFmpeg binary and hardware acceleration settings.',\n          columns: 2,\n          fields: [\n            {\n              type: 'text',\n              key: 'binaryPath',\n              label: 'Binary Path',\n              description: 'Path to ffmpeg executable',\n              placeholder: 'ffmpeg',\n              default: 'ffmpeg',\n              span: 2,\n            },\n            {\n              type: 'select',\n              key: 'hwAccel',\n              label: 'Hardware Acceleration',\n              description: 'GPU decoding/encoding backend',\n              default: 'auto',\n              options: [\n                { value: 'auto', label: 'Auto-detect' },\n                { value: 'none', label: 'None (CPU only)' },\n                { value: 'videotoolbox', label: 'VideoToolbox (macOS)' },\n                { value: 'vaapi', label: 'VA-API (Linux Intel/AMD)' },\n                { value: 'qsv', label: 'QSV (Intel Quick Sync)' },\n                { value: 'cuda', label: 'CUDA (NVIDIA)' },\n              ],\n            },\n            {\n              type: 'number',\n              key: 'threadCount',\n              label: 'Thread Count',\n              description: '0 = auto (let FFmpeg decide)',\n              min: 0,\n              max: 16,\n              step: 1,\n              default: 0,\n            },\n          ],\n        },\n      ],\n    }\n  }\n\n  async getGlobalSettings(): Promise<ConfigUISchemaWithValues> {\n    const schema = this.buildGlobalSchema()\n    if (!this.ctx.settings) {\n      return hydrateSchema(schema, {})\n    }\n\n    // Read all yml sections in parallel and merge their values into a\n    // single flat record keyed by field name. The `KEY_TO_SECTION` map\n    // guarantees uniqueness (each key belongs to exactly one section).\n    const sectionNames = Object.keys(SECTION_TITLES)\n    const merged: Record<string, unknown> = {}\n    for (const section of sectionNames) {\n      try {\n        const values = await this.ctx.settings!.getSection(section)\n        Object.assign(merged, values)\n      } catch (err: unknown) {\n        const msg = errMsg(err)\n        this.ctx.logger.debug('Failed to read section', { meta: { section, error: msg } })\n      }\n    }\n\n    return hydrateSchema(schema, merged)\n  }\n\n  async updateGlobalSettings(patch: Record<string, unknown>): Promise<void> {\n    if (!this.ctx.settings) {\n      throw new Error('system-config: ctx.settings not available — cannot write sections')\n    }\n\n    // Group the patch keys by the section they belong to, then write\n    // each section in one shot via ctx.settings.setSection(). The\n    // server section is read-only, so any keys targeting it are skipped\n    // with a warning.\n    const perSection = new Map<string, Record<string, unknown>>()\n    for (const [key, value] of Object.entries(patch)) {\n      const section = KEY_TO_SECTION[key]\n      if (section === undefined) {\n        this.ctx.logger.warn('update ignored unknown key (not mapped to any section)', { meta: { key } })\n        continue\n      }\n      if (section === 'server') {\n        this.ctx.logger.warn('update ignored read-only server-section key', { meta: { key } })\n        continue\n      }\n      let bucket = perSection.get(section)\n      if (!bucket) {\n        bucket = {}\n        perSection.set(section, bucket)\n      }\n      bucket[key] = value\n    }\n\n    for (const [section, sectionPatch] of perSection) {\n      await this.ctx.settings!.setSection(section, sectionPatch)\n      this.ctx.logger.info('Wrote keys to section', { meta: { section, keyCount: Object.keys(sectionPatch).length } })\n    }\n  }\n}\n\nexport default SystemConfigAddon\n"],"mappings":"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"}

package/dist/builtins/turn-orchestrator/index.d.ts

@@ -0,0 +1,2 @@
+export { TurnOrchestratorAddon, default } from './turn-orchestrator.addon.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/builtins/turn-orchestrator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builtins/turn-orchestrator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/builtins/turn-orchestrator/index.js

@@ -0,0 +1,7 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_builtins_turn_orchestrator_turn_orchestrator_addon = require("./turn-orchestrator.addon.js");
+exports.TurnOrchestratorAddon = require_builtins_turn_orchestrator_turn_orchestrator_addon.TurnOrchestratorAddon;
+exports.default = require_builtins_turn_orchestrator_turn_orchestrator_addon.TurnOrchestratorAddon;

package/dist/builtins/turn-orchestrator/index.mjs

@@ -0,0 +1,2 @@
+import { TurnOrchestratorAddon } from "./turn-orchestrator.addon.mjs";
+export { TurnOrchestratorAddon, TurnOrchestratorAddon as default };

package/dist/builtins/turn-orchestrator/turn-orchestrator.addon.d.ts

@@ -0,0 +1,10 @@
+import { BaseAddon, ProviderRegistration } from '@camstack/types';
+export declare class TurnOrchestratorAddon extends BaseAddon<Record<string, never>> {
+    constructor();
+    protected onInitialize(): Promise<ProviderRegistration[]>;
+    private getEntries;
+    private listProviders;
+    private getAllServers;
+}
+export default TurnOrchestratorAddon;
+//# sourceMappingURL=turn-orchestrator.addon.d.ts.map

package/dist/builtins/turn-orchestrator/turn-orchestrator.addon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-orchestrator.addon.d.ts","sourceRoot":"","sources":["../../../src/builtins/turn-orchestrator/turn-orchestrator.addon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,SAAS,EAIT,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAA;AAQxB,qBAAa,qBAAsB,SAAQ,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;;cAKzD,YAAY,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAc/D,OAAO,CAAC,UAAU;YAIJ,aAAa;YAyBb,aAAa;CAe5B;AAED,eAAe,qBAAqB,CAAA"}

package/dist/builtins/turn-orchestrator/turn-orchestrator.addon.js

@@ -0,0 +1,78 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+require("../../chunk-C13QxCFV.js");
+let _camstack_types = require("@camstack/types");
+//#region src/builtins/turn-orchestrator/turn-orchestrator.addon.ts
+/**
+* TURN orchestrator — singleton facade over the `turn-provider`
+* collection (Cloudflare TURN, coturn, Twilio, …). Mirrors the
+* auth-orchestrator / remote-access-orchestrator patterns.
+*
+* Provides:
+*   - listProviders() — admin UI inventory
+*   - getAllServers() — combined ICE server list across enabled
+*     providers, consumed by the WebRTC layer at session creation
+*/
+var TurnOrchestratorAddon = class extends _camstack_types.BaseAddon {
+	constructor() {
+		super({});
+	}
+	async onInitialize() {
+		const provider = {
+			listProviders: async () => this.listProviders(),
+			getAllServers: async () => this.getAllServers(),
+			setProviderEnabled: async () => {
+				return { success: true };
+			}
+		};
+		this.ctx.logger.info("TURN orchestrator initialized");
+		return [{
+			capability: _camstack_types.turnOrchestratorCapability,
+			provider
+		}];
+	}
+	getEntries() {
+		return this.capabilities?.getCollectionEntries("turn-provider") ?? [];
+	}
+	async listProviders() {
+		const out = [];
+		for (const [addonId, impl] of this.getEntries()) {
+			let serverCount = 0;
+			let error;
+			if (impl.getTurnServers) try {
+				serverCount = (await impl.getTurnServers()).length;
+			} catch (err) {
+				error = err instanceof Error ? err.message : String(err);
+			}
+			out.push({
+				addonId,
+				displayName: impl.displayName ?? addonId,
+				kind: impl.kind ?? (addonId.includes("cloudflare") ? "cloudflare" : addonId.includes("coturn") ? "coturn" : "other"),
+				enabled: true,
+				serverCount,
+				...error !== void 0 ? { error } : {}
+			});
+		}
+		return out;
+	}
+	async getAllServers() {
+		const out = [];
+		for (const [, impl] of this.getEntries()) {
+			if (!impl.getTurnServers) continue;
+			try {
+				const servers = await impl.getTurnServers();
+				out.push(...servers);
+			} catch (err) {
+				this.ctx.logger.warn("TURN provider failed to enumerate servers", { meta: { error: err instanceof Error ? err.message : String(err) } });
+			}
+		}
+		return out;
+	}
+};
+//#endregion
+exports.TurnOrchestratorAddon = TurnOrchestratorAddon;
+exports.default = TurnOrchestratorAddon;
+
+//# sourceMappingURL=turn-orchestrator.addon.js.map

package/dist/builtins/turn-orchestrator/turn-orchestrator.addon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-orchestrator.addon.js","names":[],"sources":["../../../src/builtins/turn-orchestrator/turn-orchestrator.addon.ts"],"sourcesContent":["/**\n * TURN orchestrator — singleton facade over the `turn-provider`\n * collection (Cloudflare TURN, coturn, Twilio, …). Mirrors the\n * auth-orchestrator / remote-access-orchestrator patterns.\n *\n * Provides:\n *   - listProviders() — admin UI inventory\n *   - getAllServers() — combined ICE server list across enabled\n *     providers, consumed by the WebRTC layer at session creation\n */\nimport {\n  BaseAddon,\n  turnOrchestratorCapability,\n  type ITurnOrchestratorProvider,\n  type TurnProviderInfo,\n  type ProviderRegistration,\n} from '@camstack/types'\n\ninterface TurnProviderLike {\n  getTurnServers?: () => Promise<readonly { urls: string | string[]; username?: string; credential?: string }[]>\n  readonly displayName?: string\n  readonly kind?: TurnProviderInfo['kind']\n}\n\nexport class TurnOrchestratorAddon extends BaseAddon<Record<string, never>> {\n  constructor() {\n    super({})\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    const provider: ITurnOrchestratorProvider = {\n      listProviders: async () => this.listProviders(),\n      getAllServers: async () => this.getAllServers(),\n      setProviderEnabled: async () => {\n        // Persistence per-addon for now — see auth-orchestrator\n        // rationale.\n        return { success: true as const }\n      },\n    }\n    this.ctx.logger.info('TURN orchestrator initialized')\n    return [{ capability: turnOrchestratorCapability, provider }]\n  }\n\n  private getEntries(): readonly (readonly [string, TurnProviderLike])[] {\n    return this.capabilities?.getCollectionEntries<TurnProviderLike>('turn-provider') ?? []\n  }\n\n  private async listProviders(): Promise<readonly TurnProviderInfo[]> {\n    const out: TurnProviderInfo[] = []\n    for (const [addonId, impl] of this.getEntries()) {\n      let serverCount = 0\n      let error: string | undefined\n      if (impl.getTurnServers) {\n        try {\n          const servers = await impl.getTurnServers()\n          serverCount = servers.length\n        } catch (err) {\n          error = err instanceof Error ? err.message : String(err)\n        }\n      }\n      out.push({\n        addonId,\n        displayName: impl.displayName ?? addonId,\n        kind: impl.kind ?? (addonId.includes('cloudflare') ? 'cloudflare' as const : addonId.includes('coturn') ? 'coturn' as const : 'other' as const),\n        enabled: true,\n        serverCount,\n        ...(error !== undefined ? { error } : {}),\n      })\n    }\n    return out\n  }\n\n  private async getAllServers(): Promise<readonly { urls: string | string[]; username?: string; credential?: string }[]> {\n    const out: { urls: string | string[]; username?: string; credential?: string }[] = []\n    for (const [, impl] of this.getEntries()) {\n      if (!impl.getTurnServers) continue\n      try {\n        const servers = await impl.getTurnServers()\n        out.push(...servers)\n      } catch (err) {\n        this.ctx.logger.warn('TURN provider failed to enumerate servers', {\n          meta: { error: err instanceof Error ? err.message : String(err) },\n        })\n      }\n    }\n    return out\n  }\n}\n\nexport default TurnOrchestratorAddon\n"],"mappings":";;;;;;;;;;;;;;;;;AAwBA,IAAa,wBAAb,cAA2C,gBAAA,UAAiC;CAC1E,cAAc;EACZ,MAAM,EAAE,CAAC;;CAGX,MAAgB,eAAgD;EAC9D,MAAM,WAAsC;GAC1C,eAAe,YAAY,KAAK,eAAe;GAC/C,eAAe,YAAY,KAAK,eAAe;GAC/C,oBAAoB,YAAY;IAG9B,OAAO,EAAE,SAAS,MAAe;;GAEpC;EACD,KAAK,IAAI,OAAO,KAAK,gCAAgC;EACrD,OAAO,CAAC;GAAE,YAAY,gBAAA;GAA4B;GAAU,CAAC;;CAG/D,aAAuE;EACrE,OAAO,KAAK,cAAc,qBAAuC,gBAAgB,IAAI,EAAE;;CAGzF,MAAc,gBAAsD;EAClE,MAAM,MAA0B,EAAE;EAClC,KAAK,MAAM,CAAC,SAAS,SAAS,KAAK,YAAY,EAAE;GAC/C,IAAI,cAAc;GAClB,IAAI;GACJ,IAAI,KAAK,gBACP,IAAI;IAEF,eAAc,MADQ,KAAK,gBAAgB,EACrB;YACf,KAAK;IACZ,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;;GAG5D,IAAI,KAAK;IACP;IACA,aAAa,KAAK,eAAe;IACjC,MAAM,KAAK,SAAS,QAAQ,SAAS,aAAa,GAAG,eAAwB,QAAQ,SAAS,SAAS,GAAG,WAAoB;IAC9H,SAAS;IACT;IACA,GAAI,UAAU,KAAA,IAAY,EAAE,OAAO,GAAG,EAAE;IACzC,CAAC;;EAEJ,OAAO;;CAGT,MAAc,gBAAyG;EACrH,MAAM,MAA6E,EAAE;EACrF,KAAK,MAAM,GAAG,SAAS,KAAK,YAAY,EAAE;GACxC,IAAI,CAAC,KAAK,gBAAgB;GAC1B,IAAI;IACF,MAAM,UAAU,MAAM,KAAK,gBAAgB;IAC3C,IAAI,KAAK,GAAG,QAAQ;YACb,KAAK;IACZ,KAAK,IAAI,OAAO,KAAK,6CAA6C,EAChE,MAAM,EAAE,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,EAAE,EAClE,CAAC;;;EAGN,OAAO"}