@camstack/core 0.1.34 → 0.1.36

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

@@ -1 +1 @@
-{"version":3,"file":"mesh-orchestrator.addon.d.ts","sourceRoot":"","sources":["../../../src/builtins/mesh-orchestrator/mesh-orchestrator.addon.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,SAAS,EAIT,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAA;AA2BxB,qBAAa,qBAAsB,SAAQ,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;;cAKzD,YAAY,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAkB/D,OAAO,CAAC,WAAW;YAML,aAAa;CAsC5B;AAED,eAAe,qBAAqB,CAAA"}
+{"version":3,"file":"mesh-orchestrator.addon.d.ts","sourceRoot":"","sources":["../../../src/builtins/mesh-orchestrator/mesh-orchestrator.addon.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,SAAS,EAKT,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAA;AAqCxB,qBAAa,qBAAsB,SAAQ,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;;cAKzD,YAAY,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAsC/D,OAAO,CAAC,WAAW;YAML,aAAa;CAqD5B;AAED,eAAe,qBAAqB,CAAA"}

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

@@ -29,6 +29,22 @@ var MeshOrchestratorAddon = class extends _camstack_types.BaseAddon {
 				const impl = this.resolveImpl(addonId);
 				if (impl?.leave) await impl.leave();
 				return { success: true };
+			},
+			startLoginProvider: async ({ addonId, hostname }) => {
+				const impl = this.resolveImpl(addonId);
+				if (!impl?.startLogin) throw new Error(`Mesh provider "${addonId}" does not support startLogin`);
+				return await impl.startLogin(hostname ? { hostname } : {});
+			},
+			logoutProvider: async ({ addonId }) => {
+				const impl = this.resolveImpl(addonId);
+				if (!impl?.logout) throw new Error(`Mesh provider "${addonId}" does not support logout`);
+				await impl.logout();
+				return { loggedOut: true };
+			},
+			listProviderPeers: async ({ addonId }) => {
+				const impl = this.resolveImpl(addonId);
+				if (!impl?.listPeers) return { peers: [] };
+				return await impl.listPeers();
 			}
 		};
 		this.ctx.logger.info("Mesh orchestrator initialized");
@@ -50,6 +66,11 @@ var MeshOrchestratorAddon = class extends _camstack_types.BaseAddon {
 			let peerCount = 0;
 			let endpoints = [];
 			let error;
+			let tenantName = "";
+			let magicDnsSuffix = "";
+			let userLogin = null;
+			let controlPlaneUrl = "";
+			let keyExpiry = null;
 			if (impl.getStatus) try {
 				const s = await impl.getStatus();
 				joined = s.joined;
@@ -58,6 +79,11 @@ var MeshOrchestratorAddon = class extends _camstack_types.BaseAddon {
 				peerCount = s.peerCount;
 				endpoints = s.endpoints;
 				error = s.error;
+				tenantName = s.tenantName;
+				magicDnsSuffix = s.magicDnsSuffix;
+				userLogin = s.userLogin;
+				controlPlaneUrl = s.controlPlaneUrl;
+				keyExpiry = s.keyExpiry;
 			} catch (err) {
 				error = err instanceof Error ? err.message : String(err);
 			}
@@ -69,7 +95,12 @@ var MeshOrchestratorAddon = class extends _camstack_types.BaseAddon {
 				magicDnsHostname,
 				peerCount,
 				endpoints,
-				...error !== void 0 ? { error } : {}
+				...error !== void 0 ? { error } : {},
+				tenantName,
+				magicDnsSuffix,
+				userLogin,
+				controlPlaneUrl,
+				keyExpiry
 			});
 		}
 		return out;

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

@@ -1 +1 @@
-{"version":3,"file":"mesh-orchestrator.addon.js","names":[],"sources":["../../../src/builtins/mesh-orchestrator/mesh-orchestrator.addon.ts"],"sourcesContent":["/**\n * Mesh orchestrator — singleton facade over the `mesh-network`\n * collection. One row per provider (Tailscale, Headscale, ZeroTier),\n * aggregated for the admin UI's Mesh Networks page.\n */\nimport {\n  BaseAddon,\n  meshOrchestratorCapability,\n  type IMeshOrchestrator,\n  type MeshProviderInfo,\n  type ProviderRegistration,\n} from '@camstack/types'\n\ninterface MeshNetworkLike {\n  getStatus?: () => Promise<{\n    joined: boolean\n    meshIp: string\n    magicDnsHostname: string\n    peerCount: number\n    endpoints: readonly {\n      id: string\n      label: string\n      scope: 'mesh' | 'public'\n      url: string\n      hostname: string\n      port: number\n      protocol: 'http' | 'https'\n    }[]\n    error?: string\n  }>\n  join?: (input: { authKey: string; hostname?: string }) => Promise<{ joined: true }>\n  leave?: () => Promise<{ left: true }>\n}\n\ninterface MeshRegistrationMeta {\n  readonly displayName?: string\n}\n\nexport class MeshOrchestratorAddon extends BaseAddon<Record<string, never>> {\n  constructor() {\n    super({})\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    const provider: IMeshOrchestrator = {\n      listProviders: async () => this.listProviders(),\n      joinProvider: async ({ addonId, authKey, hostname }) => {\n        const impl = this.resolveImpl(addonId)\n        if (!impl?.join) throw new Error(`Mesh provider \"${addonId}\" does not support join`)\n        return await impl.join({ authKey, ...(hostname ? { hostname } : {}) })\n      },\n      leaveProvider: async ({ addonId }) => {\n        const impl = this.resolveImpl(addonId)\n        if (impl?.leave) await impl.leave()\n        return { success: true as const }\n      },\n    }\n    this.ctx.logger.info('Mesh orchestrator initialized')\n    return [{ capability: meshOrchestratorCapability, provider }]\n  }\n\n  private resolveImpl(addonId: string): MeshNetworkLike | null {\n    const entries = this.capabilities?.getCollectionEntries<MeshNetworkLike>('mesh-network') ?? []\n    const found = entries.find(([id]) => id === addonId)\n    return found?.[1] ?? null\n  }\n\n  private async listProviders(): Promise<readonly MeshProviderInfo[]> {\n    const entries = this.capabilities?.getCollectionEntries<MeshNetworkLike & MeshRegistrationMeta>(\n      'mesh-network',\n    ) ?? []\n    const out: MeshProviderInfo[] = []\n    for (const [addonId, impl] of entries) {\n      let joined = false\n      let meshIp = ''\n      let magicDnsHostname = ''\n      let peerCount = 0\n      let endpoints: MeshProviderInfo['endpoints'] = []\n      let error: string | undefined\n      if (impl.getStatus) {\n        try {\n          const s = await impl.getStatus()\n          joined = s.joined\n          meshIp = s.meshIp\n          magicDnsHostname = s.magicDnsHostname\n          peerCount = s.peerCount\n          endpoints = s.endpoints\n          error = s.error\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        joined,\n        meshIp,\n        magicDnsHostname,\n        peerCount,\n        endpoints,\n        ...(error !== undefined ? { error } : {}),\n      })\n    }\n    return out\n  }\n}\n\nexport default MeshOrchestratorAddon\n"],"mappings":";;;;;;;;;;;;AAsCA,IAAa,wBAAb,cAA2C,gBAAA,UAAiC;CAC1E,cAAc;EACZ,MAAM,EAAE,CAAC;;CAGX,MAAgB,eAAgD;EAC9D,MAAM,WAA8B;GAClC,eAAe,YAAY,KAAK,eAAe;GAC/C,cAAc,OAAO,EAAE,SAAS,SAAS,eAAe;IACtD,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,CAAC,MAAM,MAAM,MAAM,IAAI,MAAM,kBAAkB,QAAQ,yBAAyB;IACpF,OAAO,MAAM,KAAK,KAAK;KAAE;KAAS,GAAI,WAAW,EAAE,UAAU,GAAG,EAAE;KAAG,CAAC;;GAExE,eAAe,OAAO,EAAE,cAAc;IACpC,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,MAAM,OAAO,MAAM,KAAK,OAAO;IACnC,OAAO,EAAE,SAAS,MAAe;;GAEpC;EACD,KAAK,IAAI,OAAO,KAAK,gCAAgC;EACrD,OAAO,CAAC;GAAE,YAAY,gBAAA;GAA4B;GAAU,CAAC;;CAG/D,YAAoB,SAAyC;EAG3D,QAFgB,KAAK,cAAc,qBAAsC,eAAe,IAAI,EAAE,EACxE,MAAM,CAAC,QAAQ,OAAO,QACrC,GAAQ,MAAM;;CAGvB,MAAc,gBAAsD;EAClE,MAAM,UAAU,KAAK,cAAc,qBACjC,eACD,IAAI,EAAE;EACP,MAAM,MAA0B,EAAE;EAClC,KAAK,MAAM,CAAC,SAAS,SAAS,SAAS;GACrC,IAAI,SAAS;GACb,IAAI,SAAS;GACb,IAAI,mBAAmB;GACvB,IAAI,YAAY;GAChB,IAAI,YAA2C,EAAE;GACjD,IAAI;GACJ,IAAI,KAAK,WACP,IAAI;IACF,MAAM,IAAI,MAAM,KAAK,WAAW;IAChC,SAAS,EAAE;IACX,SAAS,EAAE;IACX,mBAAmB,EAAE;IACrB,YAAY,EAAE;IACd,YAAY,EAAE;IACd,QAAQ,EAAE;YACH,KAAK;IACZ,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;;GAG5D,IAAI,KAAK;IACP;IACA,aAAa,KAAK,eAAe;IACjC;IACA;IACA;IACA;IACA;IACA,GAAI,UAAU,KAAA,IAAY,EAAE,OAAO,GAAG,EAAE;IACzC,CAAC;;EAEJ,OAAO"}
+{"version":3,"file":"mesh-orchestrator.addon.js","names":[],"sources":["../../../src/builtins/mesh-orchestrator/mesh-orchestrator.addon.ts"],"sourcesContent":["/**\n * Mesh orchestrator — singleton facade over the `mesh-network`\n * collection. One row per provider (Tailscale, Headscale, ZeroTier),\n * aggregated for the admin UI's Mesh Networks page.\n */\nimport {\n  BaseAddon,\n  meshOrchestratorCapability,\n  type IMeshOrchestrator,\n  type MeshPeer,\n  type MeshProviderInfo,\n  type ProviderRegistration,\n} from '@camstack/types'\n\ninterface MeshStatusLike {\n  joined: boolean\n  meshIp: string\n  magicDnsHostname: string\n  peerCount: number\n  endpoints: readonly {\n    id: string\n    label: string\n    scope: 'mesh' | 'public'\n    url: string\n    hostname: string\n    port: number\n    protocol: 'http' | 'https'\n  }[]\n  error?: string\n  tenantName: string\n  magicDnsSuffix: string\n  userLogin: string | null\n  controlPlaneUrl: string\n  keyExpiry: number | null\n}\n\ninterface MeshNetworkLike {\n  getStatus?: () => Promise<MeshStatusLike>\n  join?: (input: { authKey: string; hostname?: string }) => Promise<{ joined: true }>\n  startLogin?: (input: { hostname?: string }) => Promise<{ loginUrl: string }>\n  leave?: () => Promise<{ left: true }>\n  logout?: () => Promise<{ loggedOut: true }>\n  listPeers?: () => Promise<{ peers: readonly MeshPeer[] }>\n}\n\ninterface MeshRegistrationMeta {\n  readonly displayName?: string\n}\n\nexport class MeshOrchestratorAddon extends BaseAddon<Record<string, never>> {\n  constructor() {\n    super({})\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    const provider: IMeshOrchestrator = {\n      listProviders: async () => this.listProviders(),\n      joinProvider: async ({ addonId, authKey, hostname }) => {\n        const impl = this.resolveImpl(addonId)\n        if (!impl?.join) throw new Error(`Mesh provider \"${addonId}\" does not support join`)\n        return await impl.join({ authKey, ...(hostname ? { hostname } : {}) })\n      },\n      leaveProvider: async ({ addonId }) => {\n        const impl = this.resolveImpl(addonId)\n        if (impl?.leave) await impl.leave()\n        return { success: true as const }\n      },\n      startLoginProvider: async ({ addonId, hostname }) => {\n        const impl = this.resolveImpl(addonId)\n        if (!impl?.startLogin) {\n          throw new Error(`Mesh provider \"${addonId}\" does not support startLogin`)\n        }\n        return await impl.startLogin(hostname ? { hostname } : {})\n      },\n      logoutProvider: async ({ addonId }) => {\n        const impl = this.resolveImpl(addonId)\n        if (!impl?.logout) {\n          throw new Error(`Mesh provider \"${addonId}\" does not support logout`)\n        }\n        await impl.logout()\n        return { loggedOut: true as const }\n      },\n      listProviderPeers: async ({ addonId }) => {\n        const impl = this.resolveImpl(addonId)\n        if (!impl?.listPeers) return { peers: [] }\n        return await impl.listPeers()\n      },\n    }\n    this.ctx.logger.info('Mesh orchestrator initialized')\n    return [{ capability: meshOrchestratorCapability, provider }]\n  }\n\n  private resolveImpl(addonId: string): MeshNetworkLike | null {\n    const entries = this.capabilities?.getCollectionEntries<MeshNetworkLike>('mesh-network') ?? []\n    const found = entries.find(([id]) => id === addonId)\n    return found?.[1] ?? null\n  }\n\n  private async listProviders(): Promise<readonly MeshProviderInfo[]> {\n    const entries = this.capabilities?.getCollectionEntries<MeshNetworkLike & MeshRegistrationMeta>(\n      'mesh-network',\n    ) ?? []\n    const out: MeshProviderInfo[] = []\n    for (const [addonId, impl] of entries) {\n      let joined = false\n      let meshIp = ''\n      let magicDnsHostname = ''\n      let peerCount = 0\n      let endpoints: MeshProviderInfo['endpoints'] = []\n      let error: string | undefined\n      let tenantName = ''\n      let magicDnsSuffix = ''\n      let userLogin: string | null = null\n      let controlPlaneUrl = ''\n      let keyExpiry: number | null = null\n      if (impl.getStatus) {\n        try {\n          const s = await impl.getStatus()\n          joined = s.joined\n          meshIp = s.meshIp\n          magicDnsHostname = s.magicDnsHostname\n          peerCount = s.peerCount\n          endpoints = s.endpoints\n          error = s.error\n          tenantName = s.tenantName\n          magicDnsSuffix = s.magicDnsSuffix\n          userLogin = s.userLogin\n          controlPlaneUrl = s.controlPlaneUrl\n          keyExpiry = s.keyExpiry\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        joined,\n        meshIp,\n        magicDnsHostname,\n        peerCount,\n        endpoints,\n        ...(error !== undefined ? { error } : {}),\n        tenantName,\n        magicDnsSuffix,\n        userLogin,\n        controlPlaneUrl,\n        keyExpiry,\n      })\n    }\n    return out\n  }\n}\n\nexport default MeshOrchestratorAddon\n"],"mappings":";;;;;;;;;;;;AAiDA,IAAa,wBAAb,cAA2C,gBAAA,UAAiC;CAC1E,cAAc;EACZ,MAAM,EAAE,CAAC;;CAGX,MAAgB,eAAgD;EAC9D,MAAM,WAA8B;GAClC,eAAe,YAAY,KAAK,eAAe;GAC/C,cAAc,OAAO,EAAE,SAAS,SAAS,eAAe;IACtD,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,CAAC,MAAM,MAAM,MAAM,IAAI,MAAM,kBAAkB,QAAQ,yBAAyB;IACpF,OAAO,MAAM,KAAK,KAAK;KAAE;KAAS,GAAI,WAAW,EAAE,UAAU,GAAG,EAAE;KAAG,CAAC;;GAExE,eAAe,OAAO,EAAE,cAAc;IACpC,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,MAAM,OAAO,MAAM,KAAK,OAAO;IACnC,OAAO,EAAE,SAAS,MAAe;;GAEnC,oBAAoB,OAAO,EAAE,SAAS,eAAe;IACnD,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,CAAC,MAAM,YACT,MAAM,IAAI,MAAM,kBAAkB,QAAQ,+BAA+B;IAE3E,OAAO,MAAM,KAAK,WAAW,WAAW,EAAE,UAAU,GAAG,EAAE,CAAC;;GAE5D,gBAAgB,OAAO,EAAE,cAAc;IACrC,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,CAAC,MAAM,QACT,MAAM,IAAI,MAAM,kBAAkB,QAAQ,2BAA2B;IAEvE,MAAM,KAAK,QAAQ;IACnB,OAAO,EAAE,WAAW,MAAe;;GAErC,mBAAmB,OAAO,EAAE,cAAc;IACxC,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,CAAC,MAAM,WAAW,OAAO,EAAE,OAAO,EAAE,EAAE;IAC1C,OAAO,MAAM,KAAK,WAAW;;GAEhC;EACD,KAAK,IAAI,OAAO,KAAK,gCAAgC;EACrD,OAAO,CAAC;GAAE,YAAY,gBAAA;GAA4B;GAAU,CAAC;;CAG/D,YAAoB,SAAyC;EAG3D,QAFgB,KAAK,cAAc,qBAAsC,eAAe,IAAI,EAAE,EACxE,MAAM,CAAC,QAAQ,OAAO,QACrC,GAAQ,MAAM;;CAGvB,MAAc,gBAAsD;EAClE,MAAM,UAAU,KAAK,cAAc,qBACjC,eACD,IAAI,EAAE;EACP,MAAM,MAA0B,EAAE;EAClC,KAAK,MAAM,CAAC,SAAS,SAAS,SAAS;GACrC,IAAI,SAAS;GACb,IAAI,SAAS;GACb,IAAI,mBAAmB;GACvB,IAAI,YAAY;GAChB,IAAI,YAA2C,EAAE;GACjD,IAAI;GACJ,IAAI,aAAa;GACjB,IAAI,iBAAiB;GACrB,IAAI,YAA2B;GAC/B,IAAI,kBAAkB;GACtB,IAAI,YAA2B;GAC/B,IAAI,KAAK,WACP,IAAI;IACF,MAAM,IAAI,MAAM,KAAK,WAAW;IAChC,SAAS,EAAE;IACX,SAAS,EAAE;IACX,mBAAmB,EAAE;IACrB,YAAY,EAAE;IACd,YAAY,EAAE;IACd,QAAQ,EAAE;IACV,aAAa,EAAE;IACf,iBAAiB,EAAE;IACnB,YAAY,EAAE;IACd,kBAAkB,EAAE;IACpB,YAAY,EAAE;YACP,KAAK;IACZ,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;;GAG5D,IAAI,KAAK;IACP;IACA,aAAa,KAAK,eAAe;IACjC;IACA;IACA;IACA;IACA;IACA,GAAI,UAAU,KAAA,IAAY,EAAE,OAAO,GAAG,EAAE;IACxC;IACA;IACA;IACA;IACA;IACD,CAAC;;EAEJ,OAAO"}

package/dist/builtins/mesh-orchestrator/mesh-orchestrator.addon.mjs

@@ -24,6 +24,22 @@ var MeshOrchestratorAddon = class extends BaseAddon {
 				const impl = this.resolveImpl(addonId);
 				if (impl?.leave) await impl.leave();
 				return { success: true };
+			},
+			startLoginProvider: async ({ addonId, hostname }) => {
+				const impl = this.resolveImpl(addonId);
+				if (!impl?.startLogin) throw new Error(`Mesh provider "${addonId}" does not support startLogin`);
+				return await impl.startLogin(hostname ? { hostname } : {});
+			},
+			logoutProvider: async ({ addonId }) => {
+				const impl = this.resolveImpl(addonId);
+				if (!impl?.logout) throw new Error(`Mesh provider "${addonId}" does not support logout`);
+				await impl.logout();
+				return { loggedOut: true };
+			},
+			listProviderPeers: async ({ addonId }) => {
+				const impl = this.resolveImpl(addonId);
+				if (!impl?.listPeers) return { peers: [] };
+				return await impl.listPeers();
 			}
 		};
 		this.ctx.logger.info("Mesh orchestrator initialized");
@@ -45,6 +61,11 @@ var MeshOrchestratorAddon = class extends BaseAddon {
 			let peerCount = 0;
 			let endpoints = [];
 			let error;
+			let tenantName = "";
+			let magicDnsSuffix = "";
+			let userLogin = null;
+			let controlPlaneUrl = "";
+			let keyExpiry = null;
 			if (impl.getStatus) try {
 				const s = await impl.getStatus();
 				joined = s.joined;
@@ -53,6 +74,11 @@ var MeshOrchestratorAddon = class extends BaseAddon {
 				peerCount = s.peerCount;
 				endpoints = s.endpoints;
 				error = s.error;
+				tenantName = s.tenantName;
+				magicDnsSuffix = s.magicDnsSuffix;
+				userLogin = s.userLogin;
+				controlPlaneUrl = s.controlPlaneUrl;
+				keyExpiry = s.keyExpiry;
 			} catch (err) {
 				error = err instanceof Error ? err.message : String(err);
 			}
@@ -64,7 +90,12 @@ var MeshOrchestratorAddon = class extends BaseAddon {
 				magicDnsHostname,
 				peerCount,
 				endpoints,
-				...error !== void 0 ? { error } : {}
+				...error !== void 0 ? { error } : {},
+				tenantName,
+				magicDnsSuffix,
+				userLogin,
+				controlPlaneUrl,
+				keyExpiry
 			});
 		}
 		return out;

package/dist/builtins/mesh-orchestrator/mesh-orchestrator.addon.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mesh-orchestrator.addon.mjs","names":[],"sources":["../../../src/builtins/mesh-orchestrator/mesh-orchestrator.addon.ts"],"sourcesContent":["/**\n * Mesh orchestrator — singleton facade over the `mesh-network`\n * collection. One row per provider (Tailscale, Headscale, ZeroTier),\n * aggregated for the admin UI's Mesh Networks page.\n */\nimport {\n  BaseAddon,\n  meshOrchestratorCapability,\n  type IMeshOrchestrator,\n  type MeshProviderInfo,\n  type ProviderRegistration,\n} from '@camstack/types'\n\ninterface MeshNetworkLike {\n  getStatus?: () => Promise<{\n    joined: boolean\n    meshIp: string\n    magicDnsHostname: string\n    peerCount: number\n    endpoints: readonly {\n      id: string\n      label: string\n      scope: 'mesh' | 'public'\n      url: string\n      hostname: string\n      port: number\n      protocol: 'http' | 'https'\n    }[]\n    error?: string\n  }>\n  join?: (input: { authKey: string; hostname?: string }) => Promise<{ joined: true }>\n  leave?: () => Promise<{ left: true }>\n}\n\ninterface MeshRegistrationMeta {\n  readonly displayName?: string\n}\n\nexport class MeshOrchestratorAddon extends BaseAddon<Record<string, never>> {\n  constructor() {\n    super({})\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    const provider: IMeshOrchestrator = {\n      listProviders: async () => this.listProviders(),\n      joinProvider: async ({ addonId, authKey, hostname }) => {\n        const impl = this.resolveImpl(addonId)\n        if (!impl?.join) throw new Error(`Mesh provider \"${addonId}\" does not support join`)\n        return await impl.join({ authKey, ...(hostname ? { hostname } : {}) })\n      },\n      leaveProvider: async ({ addonId }) => {\n        const impl = this.resolveImpl(addonId)\n        if (impl?.leave) await impl.leave()\n        return { success: true as const }\n      },\n    }\n    this.ctx.logger.info('Mesh orchestrator initialized')\n    return [{ capability: meshOrchestratorCapability, provider }]\n  }\n\n  private resolveImpl(addonId: string): MeshNetworkLike | null {\n    const entries = this.capabilities?.getCollectionEntries<MeshNetworkLike>('mesh-network') ?? []\n    const found = entries.find(([id]) => id === addonId)\n    return found?.[1] ?? null\n  }\n\n  private async listProviders(): Promise<readonly MeshProviderInfo[]> {\n    const entries = this.capabilities?.getCollectionEntries<MeshNetworkLike & MeshRegistrationMeta>(\n      'mesh-network',\n    ) ?? []\n    const out: MeshProviderInfo[] = []\n    for (const [addonId, impl] of entries) {\n      let joined = false\n      let meshIp = ''\n      let magicDnsHostname = ''\n      let peerCount = 0\n      let endpoints: MeshProviderInfo['endpoints'] = []\n      let error: string | undefined\n      if (impl.getStatus) {\n        try {\n          const s = await impl.getStatus()\n          joined = s.joined\n          meshIp = s.meshIp\n          magicDnsHostname = s.magicDnsHostname\n          peerCount = s.peerCount\n          endpoints = s.endpoints\n          error = s.error\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        joined,\n        meshIp,\n        magicDnsHostname,\n        peerCount,\n        endpoints,\n        ...(error !== undefined ? { error } : {}),\n      })\n    }\n    return out\n  }\n}\n\nexport default MeshOrchestratorAddon\n"],"mappings":";;;;;;;AAsCA,IAAa,wBAAb,cAA2C,UAAiC;CAC1E,cAAc;EACZ,MAAM,EAAE,CAAC;;CAGX,MAAgB,eAAgD;EAC9D,MAAM,WAA8B;GAClC,eAAe,YAAY,KAAK,eAAe;GAC/C,cAAc,OAAO,EAAE,SAAS,SAAS,eAAe;IACtD,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,CAAC,MAAM,MAAM,MAAM,IAAI,MAAM,kBAAkB,QAAQ,yBAAyB;IACpF,OAAO,MAAM,KAAK,KAAK;KAAE;KAAS,GAAI,WAAW,EAAE,UAAU,GAAG,EAAE;KAAG,CAAC;;GAExE,eAAe,OAAO,EAAE,cAAc;IACpC,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,MAAM,OAAO,MAAM,KAAK,OAAO;IACnC,OAAO,EAAE,SAAS,MAAe;;GAEpC;EACD,KAAK,IAAI,OAAO,KAAK,gCAAgC;EACrD,OAAO,CAAC;GAAE,YAAY;GAA4B;GAAU,CAAC;;CAG/D,YAAoB,SAAyC;EAG3D,QAFgB,KAAK,cAAc,qBAAsC,eAAe,IAAI,EAAE,EACxE,MAAM,CAAC,QAAQ,OAAO,QACrC,GAAQ,MAAM;;CAGvB,MAAc,gBAAsD;EAClE,MAAM,UAAU,KAAK,cAAc,qBACjC,eACD,IAAI,EAAE;EACP,MAAM,MAA0B,EAAE;EAClC,KAAK,MAAM,CAAC,SAAS,SAAS,SAAS;GACrC,IAAI,SAAS;GACb,IAAI,SAAS;GACb,IAAI,mBAAmB;GACvB,IAAI,YAAY;GAChB,IAAI,YAA2C,EAAE;GACjD,IAAI;GACJ,IAAI,KAAK,WACP,IAAI;IACF,MAAM,IAAI,MAAM,KAAK,WAAW;IAChC,SAAS,EAAE;IACX,SAAS,EAAE;IACX,mBAAmB,EAAE;IACrB,YAAY,EAAE;IACd,YAAY,EAAE;IACd,QAAQ,EAAE;YACH,KAAK;IACZ,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;;GAG5D,IAAI,KAAK;IACP;IACA,aAAa,KAAK,eAAe;IACjC;IACA;IACA;IACA;IACA;IACA,GAAI,UAAU,KAAA,IAAY,EAAE,OAAO,GAAG,EAAE;IACzC,CAAC;;EAEJ,OAAO"}
+{"version":3,"file":"mesh-orchestrator.addon.mjs","names":[],"sources":["../../../src/builtins/mesh-orchestrator/mesh-orchestrator.addon.ts"],"sourcesContent":["/**\n * Mesh orchestrator — singleton facade over the `mesh-network`\n * collection. One row per provider (Tailscale, Headscale, ZeroTier),\n * aggregated for the admin UI's Mesh Networks page.\n */\nimport {\n  BaseAddon,\n  meshOrchestratorCapability,\n  type IMeshOrchestrator,\n  type MeshPeer,\n  type MeshProviderInfo,\n  type ProviderRegistration,\n} from '@camstack/types'\n\ninterface MeshStatusLike {\n  joined: boolean\n  meshIp: string\n  magicDnsHostname: string\n  peerCount: number\n  endpoints: readonly {\n    id: string\n    label: string\n    scope: 'mesh' | 'public'\n    url: string\n    hostname: string\n    port: number\n    protocol: 'http' | 'https'\n  }[]\n  error?: string\n  tenantName: string\n  magicDnsSuffix: string\n  userLogin: string | null\n  controlPlaneUrl: string\n  keyExpiry: number | null\n}\n\ninterface MeshNetworkLike {\n  getStatus?: () => Promise<MeshStatusLike>\n  join?: (input: { authKey: string; hostname?: string }) => Promise<{ joined: true }>\n  startLogin?: (input: { hostname?: string }) => Promise<{ loginUrl: string }>\n  leave?: () => Promise<{ left: true }>\n  logout?: () => Promise<{ loggedOut: true }>\n  listPeers?: () => Promise<{ peers: readonly MeshPeer[] }>\n}\n\ninterface MeshRegistrationMeta {\n  readonly displayName?: string\n}\n\nexport class MeshOrchestratorAddon extends BaseAddon<Record<string, never>> {\n  constructor() {\n    super({})\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    const provider: IMeshOrchestrator = {\n      listProviders: async () => this.listProviders(),\n      joinProvider: async ({ addonId, authKey, hostname }) => {\n        const impl = this.resolveImpl(addonId)\n        if (!impl?.join) throw new Error(`Mesh provider \"${addonId}\" does not support join`)\n        return await impl.join({ authKey, ...(hostname ? { hostname } : {}) })\n      },\n      leaveProvider: async ({ addonId }) => {\n        const impl = this.resolveImpl(addonId)\n        if (impl?.leave) await impl.leave()\n        return { success: true as const }\n      },\n      startLoginProvider: async ({ addonId, hostname }) => {\n        const impl = this.resolveImpl(addonId)\n        if (!impl?.startLogin) {\n          throw new Error(`Mesh provider \"${addonId}\" does not support startLogin`)\n        }\n        return await impl.startLogin(hostname ? { hostname } : {})\n      },\n      logoutProvider: async ({ addonId }) => {\n        const impl = this.resolveImpl(addonId)\n        if (!impl?.logout) {\n          throw new Error(`Mesh provider \"${addonId}\" does not support logout`)\n        }\n        await impl.logout()\n        return { loggedOut: true as const }\n      },\n      listProviderPeers: async ({ addonId }) => {\n        const impl = this.resolveImpl(addonId)\n        if (!impl?.listPeers) return { peers: [] }\n        return await impl.listPeers()\n      },\n    }\n    this.ctx.logger.info('Mesh orchestrator initialized')\n    return [{ capability: meshOrchestratorCapability, provider }]\n  }\n\n  private resolveImpl(addonId: string): MeshNetworkLike | null {\n    const entries = this.capabilities?.getCollectionEntries<MeshNetworkLike>('mesh-network') ?? []\n    const found = entries.find(([id]) => id === addonId)\n    return found?.[1] ?? null\n  }\n\n  private async listProviders(): Promise<readonly MeshProviderInfo[]> {\n    const entries = this.capabilities?.getCollectionEntries<MeshNetworkLike & MeshRegistrationMeta>(\n      'mesh-network',\n    ) ?? []\n    const out: MeshProviderInfo[] = []\n    for (const [addonId, impl] of entries) {\n      let joined = false\n      let meshIp = ''\n      let magicDnsHostname = ''\n      let peerCount = 0\n      let endpoints: MeshProviderInfo['endpoints'] = []\n      let error: string | undefined\n      let tenantName = ''\n      let magicDnsSuffix = ''\n      let userLogin: string | null = null\n      let controlPlaneUrl = ''\n      let keyExpiry: number | null = null\n      if (impl.getStatus) {\n        try {\n          const s = await impl.getStatus()\n          joined = s.joined\n          meshIp = s.meshIp\n          magicDnsHostname = s.magicDnsHostname\n          peerCount = s.peerCount\n          endpoints = s.endpoints\n          error = s.error\n          tenantName = s.tenantName\n          magicDnsSuffix = s.magicDnsSuffix\n          userLogin = s.userLogin\n          controlPlaneUrl = s.controlPlaneUrl\n          keyExpiry = s.keyExpiry\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        joined,\n        meshIp,\n        magicDnsHostname,\n        peerCount,\n        endpoints,\n        ...(error !== undefined ? { error } : {}),\n        tenantName,\n        magicDnsSuffix,\n        userLogin,\n        controlPlaneUrl,\n        keyExpiry,\n      })\n    }\n    return out\n  }\n}\n\nexport default MeshOrchestratorAddon\n"],"mappings":";;;;;;;AAiDA,IAAa,wBAAb,cAA2C,UAAiC;CAC1E,cAAc;EACZ,MAAM,EAAE,CAAC;;CAGX,MAAgB,eAAgD;EAC9D,MAAM,WAA8B;GAClC,eAAe,YAAY,KAAK,eAAe;GAC/C,cAAc,OAAO,EAAE,SAAS,SAAS,eAAe;IACtD,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,CAAC,MAAM,MAAM,MAAM,IAAI,MAAM,kBAAkB,QAAQ,yBAAyB;IACpF,OAAO,MAAM,KAAK,KAAK;KAAE;KAAS,GAAI,WAAW,EAAE,UAAU,GAAG,EAAE;KAAG,CAAC;;GAExE,eAAe,OAAO,EAAE,cAAc;IACpC,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,MAAM,OAAO,MAAM,KAAK,OAAO;IACnC,OAAO,EAAE,SAAS,MAAe;;GAEnC,oBAAoB,OAAO,EAAE,SAAS,eAAe;IACnD,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,CAAC,MAAM,YACT,MAAM,IAAI,MAAM,kBAAkB,QAAQ,+BAA+B;IAE3E,OAAO,MAAM,KAAK,WAAW,WAAW,EAAE,UAAU,GAAG,EAAE,CAAC;;GAE5D,gBAAgB,OAAO,EAAE,cAAc;IACrC,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,CAAC,MAAM,QACT,MAAM,IAAI,MAAM,kBAAkB,QAAQ,2BAA2B;IAEvE,MAAM,KAAK,QAAQ;IACnB,OAAO,EAAE,WAAW,MAAe;;GAErC,mBAAmB,OAAO,EAAE,cAAc;IACxC,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,CAAC,MAAM,WAAW,OAAO,EAAE,OAAO,EAAE,EAAE;IAC1C,OAAO,MAAM,KAAK,WAAW;;GAEhC;EACD,KAAK,IAAI,OAAO,KAAK,gCAAgC;EACrD,OAAO,CAAC;GAAE,YAAY;GAA4B;GAAU,CAAC;;CAG/D,YAAoB,SAAyC;EAG3D,QAFgB,KAAK,cAAc,qBAAsC,eAAe,IAAI,EAAE,EACxE,MAAM,CAAC,QAAQ,OAAO,QACrC,GAAQ,MAAM;;CAGvB,MAAc,gBAAsD;EAClE,MAAM,UAAU,KAAK,cAAc,qBACjC,eACD,IAAI,EAAE;EACP,MAAM,MAA0B,EAAE;EAClC,KAAK,MAAM,CAAC,SAAS,SAAS,SAAS;GACrC,IAAI,SAAS;GACb,IAAI,SAAS;GACb,IAAI,mBAAmB;GACvB,IAAI,YAAY;GAChB,IAAI,YAA2C,EAAE;GACjD,IAAI;GACJ,IAAI,aAAa;GACjB,IAAI,iBAAiB;GACrB,IAAI,YAA2B;GAC/B,IAAI,kBAAkB;GACtB,IAAI,YAA2B;GAC/B,IAAI,KAAK,WACP,IAAI;IACF,MAAM,IAAI,MAAM,KAAK,WAAW;IAChC,SAAS,EAAE;IACX,SAAS,EAAE;IACX,mBAAmB,EAAE;IACrB,YAAY,EAAE;IACd,YAAY,EAAE;IACd,QAAQ,EAAE;IACV,aAAa,EAAE;IACf,iBAAiB,EAAE;IACnB,YAAY,EAAE;IACd,kBAAkB,EAAE;IACpB,YAAY,EAAE;YACP,KAAK;IACZ,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;;GAG5D,IAAI,KAAK;IACP;IACA,aAAa,KAAK,eAAe;IACjC;IACA;IACA;IACA;IACA;IACA,GAAI,UAAU,KAAA,IAAY,EAAE,OAAO,GAAG,EAAE;IACxC;IACA;IACA;IACA;IACA;IACD,CAAC;;EAEJ,OAAO"}

package/dist/builtins/platform-probe/hardware-encoder-probe.d.ts

@@ -0,0 +1,14 @@
+import { HardwareInfo, HardwareEncoders, IScopedLogger } from '@camstack/types';
+export declare class HardwareEncoderProber {
+    private cached;
+    private inflight;
+    private readonly logger;
+    private readonly ffmpegPath;
+    constructor(logger: IScopedLogger, ffmpegPath?: string);
+    getCached(): HardwareEncoders | null;
+    probe(hardware: HardwareInfo, options?: {
+        readonly force?: boolean;
+    }): Promise<HardwareEncoders>;
+    private runProbe;
+}
+//# sourceMappingURL=hardware-encoder-probe.d.ts.map

package/dist/builtins/platform-probe/hardware-encoder-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware-encoder-probe.d.ts","sourceRoot":"","sources":["../../../src/builtins/platform-probe/hardware-encoder-probe.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EAGZ,gBAAgB,EAChB,aAAa,EACd,MAAM,iBAAiB,CAAA;AA4ExB,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEvB,MAAM,EAAE,aAAa,EAAE,UAAU,SAAW;IAKxD,SAAS,IAAI,gBAAgB,GAAG,IAAI;IAI9B,KAAK,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAiB5F,QAAQ;CAuCvB"}

package/dist/builtins/platform-probe/index.d.ts

@@ -1,8 +1,10 @@
 import { ProviderRegistration, BaseAddon } from '@camstack/types';
 export { PlatformScorer } from './platform-scorer.js';
 export { InferenceConfigResolver } from './inference-config-resolver.js';
+export { HardwareEncoderProber } from './hardware-encoder-probe.js';
 export declare class PlatformProbeNativeAddon extends BaseAddon {
     private scorer;
+    private encoderProber;
     private cachedCaps;
     constructor();
     protected onInitialize(): Promise<ProviderRegistration[]>;

package/dist/builtins/platform-probe/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builtins/platform-probe/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EACV,oBAAoB,EAOrB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,SAAS,EAAkD,MAAM,iBAAiB,CAAA;AAI3F,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AAExE,qBAAa,wBAAyB,SAAQ,SAAS;IACrD,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,UAAU,CAAoC;;cAItC,YAAY,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;cA4E/C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAI5C;AAED,eAAe,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builtins/platform-probe/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,oBAAoB,EAQrB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,SAAS,EAAkD,MAAM,iBAAiB,CAAA;AAK3F,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AAEnE,qBAAa,wBAAyB,SAAQ,SAAS;IACrD,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,UAAU,CAAoC;;cAItC,YAAY,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;cA0F/C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAK5C;AAED,eAAe,wBAAwB,CAAA"}

package/dist/builtins/platform-probe/index.js

@@ -16,7 +16,7 @@ node_os = require_chunk.__toESM(node_os);
 * entire Node process (WS handshakes, tRPC subscriptions, metrics — all
 * stalled). Keeping it async turns the probe into a true background task.
 */
-var execFileAsync = (0, node_util.promisify)(node_child_process.execFile);
+var execFileAsync$1 = (0, node_util.promisify)(node_child_process.execFile);
 /** Minimal no-op logger for default parameter */
 var noopLogger = {
 	debug() {},
@@ -44,7 +44,7 @@ async function getAvailableRAM_MB() {
 		const platform = node_os.platform();
 		try {
 			if (platform === "darwin") {
-				const { stdout: output } = await execFileAsync("vm_stat", [], {
+				const { stdout: output } = await execFileAsync$1("vm_stat", [], {
 					encoding: "utf8",
 					timeout: 3e3
 				});
@@ -169,7 +169,7 @@ var PlatformScorer = class {
 			npu = { type: "apple-ane" };
 		}
 		if (platform === "linux") try {
-			const { stdout } = await execFileAsync("nvidia-smi", ["--query-gpu=name,memory.total", "--format=csv,noheader"], {
+			const { stdout } = await execFileAsync$1("nvidia-smi", ["--query-gpu=name,memory.total", "--format=csv,noheader"], {
 				encoding: "utf8",
 				timeout: 5e3
 			});
@@ -230,7 +230,7 @@ var PlatformScorer = class {
 	async probePythonBackends() {
 		let pythonPath = null;
 		for (const cmd of ["python3", "python"]) try {
-			await execFileAsync(cmd, ["--version"], { timeout: 5e3 });
+			await execFileAsync$1(cmd, ["--version"], { timeout: 5e3 });
 			pythonPath = cmd;
 			break;
 		} catch (err) {
@@ -265,7 +265,7 @@ var PlatformScorer = class {
 			const probeStart = Date.now();
 			let available = false;
 			try {
-				await execFileAsync(pythonPath, ["-c", `import ${mod}`], { timeout: 3e4 });
+				await execFileAsync$1(pythonPath, ["-c", `import ${mod}`], { timeout: 3e4 });
 				available = true;
 			} catch (err) {
 				console.debug(`Python module "${mod}" not installed: ${(0, _camstack_types.errMsg)(err)}`);
@@ -459,15 +459,192 @@ var InferenceConfigResolver = class {
 	}
 };
 //#endregion
+//#region src/builtins/platform-probe/hardware-encoder-probe.ts
+var execFileAsync = (0, node_util.promisify)(node_child_process.execFile);
+function buildCandidates(hardware) {
+	const out = [];
+	if (hardware.platform === "darwin") {
+		out.push({
+			encoder: "h264_videotoolbox",
+			codec: "H264",
+			family: "videotoolbox"
+		});
+		out.push({
+			encoder: "hevc_videotoolbox",
+			codec: "H265",
+			family: "videotoolbox"
+		});
+	}
+	if (hardware.platform === "linux") {
+		if (hardware.gpu?.type === "nvidia") {
+			out.push({
+				encoder: "h264_nvenc",
+				codec: "H264",
+				family: "nvenc"
+			});
+			out.push({
+				encoder: "hevc_nvenc",
+				codec: "H265",
+				family: "nvenc"
+			});
+		}
+		if (hardware.gpu?.type === "intel" || hardware.gpu?.type === "amd" || !hardware.gpu) {
+			out.push({
+				encoder: "h264_vaapi",
+				codec: "H264",
+				family: "vaapi"
+			});
+			out.push({
+				encoder: "hevc_vaapi",
+				codec: "H265",
+				family: "vaapi"
+			});
+		}
+	}
+	return out;
+}
+async function runTestEncode(candidate, opts) {
+	const ffmpeg = opts.ffmpegPath ?? "ffmpeg";
+	const timeout = opts.timeoutMs ?? 8e3;
+	const nullSink = node_os.platform() === "win32" ? "NUL" : "/dev/null";
+	const baseArgs = [
+		"-hide_banner",
+		"-loglevel",
+		"error"
+	];
+	const inArgs = [
+		"-f",
+		"lavfi",
+		"-i",
+		"testsrc=duration=0.04:size=16x16:rate=25"
+	];
+	let outArgs;
+	if (candidate.family === "vaapi") outArgs = [
+		"-vaapi_device",
+		"/dev/dri/renderD128",
+		"-vf",
+		"format=nv12,hwupload",
+		"-c:v",
+		candidate.encoder,
+		"-frames:v",
+		"1",
+		"-f",
+		"null",
+		nullSink
+	];
+	else outArgs = [
+		"-c:v",
+		candidate.encoder,
+		"-frames:v",
+		"1",
+		"-f",
+		"null",
+		nullSink
+	];
+	try {
+		await execFileAsync(ffmpeg, [
+			...baseArgs,
+			...inArgs,
+			...outArgs
+		], {
+			timeout,
+			encoding: "utf8"
+		});
+		return {
+			encoder: candidate.encoder,
+			codec: candidate.codec,
+			family: candidate.family,
+			available: true
+		};
+	} catch (err) {
+		return {
+			encoder: candidate.encoder,
+			codec: candidate.codec,
+			family: candidate.family,
+			available: false,
+			reason: (0, _camstack_types.errMsg)(err)
+		};
+	}
+}
+var HardwareEncoderProber = class {
+	cached = null;
+	inflight = null;
+	logger;
+	ffmpegPath;
+	constructor(logger, ffmpegPath = "ffmpeg") {
+		this.logger = logger;
+		this.ffmpegPath = ffmpegPath;
+	}
+	getCached() {
+		return this.cached;
+	}
+	async probe(hardware, options = {}) {
+		if (!options.force && this.cached) return this.cached;
+		if (this.inflight) return this.inflight;
+		this.inflight = this.runProbe(hardware).then((res) => {
+			this.cached = res;
+			this.inflight = null;
+			return res;
+		}).catch((err) => {
+			this.inflight = null;
+			throw err;
+		});
+		return this.inflight;
+	}
+	async runProbe(hardware) {
+		const candidates = buildCandidates(hardware);
+		const start = Date.now();
+		this.logger.info("Probing hardware encoders", { meta: {
+			platform: hardware.platform,
+			arch: hardware.arch,
+			candidates: candidates.length
+		} });
+		const probes = await Promise.all(candidates.map((c) => runTestEncode(c, { ffmpegPath: this.ffmpegPath })));
+		probes.push({
+			encoder: "libx264",
+			codec: "H264",
+			family: "software",
+			available: true
+		});
+		probes.push({
+			encoder: "libx265",
+			codec: "H265",
+			family: "software",
+			available: true
+		});
+		const pickDefault = (codec) => {
+			const hw = probes.find((p) => p.codec === codec && p.available && p.family !== "software");
+			if (hw) return hw.encoder;
+			return codec === "H264" ? "libx264" : "libx265";
+		};
+		const result = {
+			encoders: probes,
+			defaultH264: pickDefault("H264"),
+			defaultH265: pickDefault("H265"),
+			probedAt: Date.now()
+		};
+		const elapsed = Date.now() - start;
+		this.logger.info("Hardware encoder probe complete", { meta: {
+			elapsedMs: elapsed,
+			defaultH264: result.defaultH264,
+			defaultH265: result.defaultH265,
+			availableHw: probes.filter((p) => p.available && p.family !== "software").map((p) => p.encoder)
+		} });
+		return result;
+	}
+};
+//#endregion
 //#region src/builtins/platform-probe/index.ts
 var PlatformProbeNativeAddon = class extends _camstack_types.BaseAddon {
 	scorer = null;
+	encoderProber = null;
 	cachedCaps = null;
 	constructor() {
 		super({});
 	}
 	async onInitialize() {
 		this.scorer = new PlatformScorer(this.ctx.logger);
+		this.encoderProber = new HardwareEncoderProber(this.ctx.logger);
 		const emitPhase = (phase, payload) => {
 			this.ctx.eventBus?.emit({
 				id: `platform-probe-${phase}-${Date.now()}`,
@@ -521,16 +698,32 @@ var PlatformProbeNativeAddon = class extends _camstack_types.BaseAddon {
 					const hwaccel = this.ctx.kernel.hwaccel;
 					if (!hwaccel) return { preferred: [] };
 					return { preferred: (await hwaccel.resolve(input.prefer ?? null)).preferred };
+				},
+				getHardwareEncoders: async () => {
+					const prober = this.encoderProber;
+					if (!prober) throw new Error("Hardware encoder prober not initialized");
+					const cached = prober.getCached();
+					if (cached) return cached;
+					const caps = await getCaps();
+					return prober.probe(caps.hardware);
+				},
+				refreshHardwareEncoders: async () => {
+					const prober = this.encoderProber;
+					if (!prober) throw new Error("Hardware encoder prober not initialized");
+					const caps = await getCaps();
+					return prober.probe(caps.hardware, { force: true });
 				}
 			}
 		}];
 	}
 	async onShutdown() {
 		this.scorer = null;
+		this.encoderProber = null;
 		this.cachedCaps = null;
 	}
 };
 //#endregion
+exports.HardwareEncoderProber = HardwareEncoderProber;
 exports.InferenceConfigResolver = InferenceConfigResolver;
 exports.PlatformProbeNativeAddon = PlatformProbeNativeAddon;
 exports.default = PlatformProbeNativeAddon;