@camstack/core 0.1.14 → 0.1.16

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

@@ -1,10 +1,146 @@
-import {
-  WinstonDestination,
-  WinstonLoggingAddon
-} from "../../chunk-LQFPAEQF.mjs";
-export {
-  WinstonDestination,
-  WinstonLoggingAddon,
-  WinstonLoggingAddon as default
+import { t as formatLogLine } from "../../formatter-C-5An4Bl.mjs";
+import * as path from "node:path";
+import { BaseAddon, logDestinationCapability } from "@camstack/types";
+import * as winston from "winston";
+import DailyRotateFile from "winston-daily-rotate-file";
+//#region src/builtins/winston-logging/winston-destination.ts
+/**
+* Rotated-file log destination. Console output goes through the shared
+* `formatLogLine` so every console sink (Winston, ConsoleDestination,
+* HubForwarderDestination) emits identical lines. File output keeps a
+* structured JSON shape so log tooling can query tags/meta.
+*/
+var WinstonDestination = class {
+	logger = null;
+	async initialize(config) {
+		const { level = "info", retentionDays = 30, logsDir = path.join("camstack-data", "logs") } = config ?? {};
+		winston.format.printf((info) => {
+			const rendered = info._rendered;
+			return typeof rendered === "string" ? rendered : String(info.message);
+		});
+		const stripRendered = winston.format((info) => {
+			delete info["_rendered"];
+			return info;
+		});
+		const fileFormat = winston.format.combine(winston.format.timestamp(), stripRendered(), winston.format.json());
+		this.logger = winston.createLogger({
+			level,
+			transports: [new DailyRotateFile({
+				dirname: logsDir,
+				filename: "camstack-%DATE%.log",
+				datePattern: "YYYY-MM-DD",
+				maxFiles: `${retentionDays}d`,
+				format: fileFormat
+			})]
+		});
+	}
+	write(entry) {
+		if (!this.logger) return;
+		const ts = entry.timestamp instanceof Date ? entry.timestamp.toISOString() : String(entry.timestamp);
+		const rendered = formatLogLine(entry, { colorize: true });
+		this.logger.log({
+			level: entry.level,
+			message: entry.message,
+			_rendered: rendered,
+			timestamp: ts,
+			scope: entry.scope,
+			...entry.tags ? { tags: entry.tags } : {},
+			...entry.meta ? { meta: entry.meta } : {}
+		});
+	}
+	async query(_filter) {
+		return [];
+	}
+	async shutdown() {
+		if (!this.logger) return;
+		await new Promise((resolve) => {
+			this.logger.on("finish", resolve);
+			this.logger.end();
+		});
+		this.logger = null;
+	}
 };
+//#endregion
+//#region src/builtins/winston-logging/winston-logging.addon.ts
+/**
+* Winston logging addon — rotated log files + console output.
+* Settings appear under Cluster → NodeDetail → Settings.
+*/
+var WinstonLoggingAddon = class extends BaseAddon {
+	destination = null;
+	constructor() {
+		super({
+			level: "info",
+			retentionDays: 30
+		});
+	}
+	async onInitialize() {
+		const logsDir = await this.ctx.api.storage.resolve.query({
+			location: "logs",
+			relativePath: ""
+		}).catch(() => "camstack-data/logs");
+		this.destination = new WinstonDestination();
+		await this.destination.initialize({
+			...this.config,
+			logsDir
+		});
+		this.ctx.logger.info("Winston logging initialized");
+		return [{
+			capability: logDestinationCapability,
+			provider: this.destination
+		}];
+	}
+	async onShutdown() {
+		await this.destination?.shutdown();
+	}
+	getDestination() {
+		if (!this.destination) throw new Error("Winston not initialized");
+		return this.destination;
+	}
+	globalSettingsSchema() {
+		return this.schema({ sections: [{
+			id: "winston-logging",
+			title: "Logging",
+			description: "Global log verbosity + retention for rotated log files on this node.",
+			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"
+					}
+				]
+			}), this.field({
+				type: "number",
+				key: "retentionDays",
+				label: "Retention (days)",
+				description: "Number of days to keep rotated log files before deletion",
+				min: 1,
+				max: 365,
+				step: 1,
+				default: 30,
+				unit: "days"
+			})]
+		}] });
+	}
+};
+//#endregion
+export { WinstonDestination, WinstonLoggingAddon, WinstonLoggingAddon as default };
+
 //# sourceMappingURL=index.mjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/builtins/winston-logging/winston-destination.ts","../../../src/builtins/winston-logging/winston-logging.addon.ts"],"sourcesContent":["import * as winston from 'winston'\nimport DailyRotateFile from 'winston-daily-rotate-file'\nimport * as path from 'node:path'\nimport type { ILogDestination, LogEntry, LogFilter } from '@camstack/types'\nimport { formatLogLine } from '../../logging/formatter.js'\n\ninterface WinstonConfig {\n  readonly level: string\n  readonly retentionDays: number\n  /** Resolved absolute path to the logs directory (replaces the old dataPath field). */\n  readonly logsDir: string\n}\n\n/**\n * Rotated-file log destination. Console output goes through the shared\n * `formatLogLine` so every console sink (Winston, ConsoleDestination,\n * HubForwarderDestination) emits identical lines. File output keeps a\n * structured JSON shape so log tooling can query tags/meta.\n */\nexport class WinstonDestination implements ILogDestination {\n  private logger: winston.Logger | null = null\n\n  async initialize(config?: WinstonConfig): Promise<void> {\n    const {\n      level = 'info',\n      retentionDays = 30,\n      logsDir = path.join('camstack-data', 'logs'),\n    } = config ?? {}\n\n    // Console: canonical single-line formatter — `_rendered` already\n    // carries level-based ANSI colour codes (see `formatLogLine` in\n    // `@camstack/core/logging/formatter.ts`). Using Winston's colorize\n    // here would just decorate unused `info.level` and leave the\n    // rendered line uncoloured.\n    const consoleFormat = winston.format.printf((info) => {\n      const rendered = (info as unknown as { _rendered?: string })._rendered\n      return typeof rendered === 'string' ? rendered : String(info.message)\n    })\n\n    // File: structured JSON. Strip `_rendered` first — it carries ANSI\n    // escape codes intended for the terminal and has no place in a\n    // rotated-file store used for ops queries.\n    const stripRendered = winston.format((info) => {\n      delete (info as Record<string, unknown>)['_rendered']\n      return info\n    })\n    const fileFormat = winston.format.combine(\n      winston.format.timestamp(),\n      stripRendered(),\n      winston.format.json(),\n    )\n\n    // File-only winston. Stdout is owned by `ConsoleDestination`\n    // (the `console-logging` builtin addon) — adding a Winston console\n    // transport here would re-render every log line a second time on\n    // the hub terminal, which is the historic cause of the duplicate\n    // output operators have been seeing. The `consoleFormat` printf\n    // above stays wired in so a future opt-in transport can use it\n    // without re-deriving the layout.\n    void consoleFormat\n    this.logger = winston.createLogger({\n      level,\n      transports: [\n        new DailyRotateFile({\n          dirname: logsDir,\n          filename: 'camstack-%DATE%.log',\n          datePattern: 'YYYY-MM-DD',\n          maxFiles: `${retentionDays}d`,\n          format: fileFormat,\n        }),\n      ],\n    })\n  }\n\n  write(entry: LogEntry): void {\n    if (!this.logger) return\n\n    // Moleculer JSON serialization converts Date → string; normalize back\n    const ts = entry.timestamp instanceof Date\n      ? entry.timestamp.toISOString()\n      : String(entry.timestamp)\n    // Render once with colours for the console transport; file transport\n    // strips `_rendered` via the format chain above so disk stays plain.\n    const rendered = formatLogLine(entry, { colorize: true })\n\n    this.logger.log({\n      level: entry.level,\n      message: entry.message,\n      _rendered: rendered,\n      timestamp: ts,\n      scope: entry.scope,\n      ...(entry.tags ? { tags: entry.tags } : {}),\n      ...(entry.meta ? { meta: entry.meta } : {}),\n    })\n  }\n\n  async query(_filter: LogFilter): Promise<readonly LogEntry[]> {\n    // File-based log querying is not implemented; use structured storage for log queries\n    return []\n  }\n\n  async shutdown(): Promise<void> {\n    if (!this.logger) return\n\n    await new Promise<void>((resolve) => {\n      this.logger!.on('finish', resolve)\n      this.logger!.end()\n    })\n    this.logger = null\n  }\n}\n","import type { ProviderRegistration } from '@camstack/types'\nimport { BaseAddon, logDestinationCapability } from '@camstack/types'\nimport { WinstonDestination } from './winston-destination.js'\n\ninterface WinstonConfig {\n  readonly level: string\n  readonly retentionDays: number\n}\n\n/**\n * Winston logging addon — rotated log files + console output.\n * Settings appear under Cluster → NodeDetail → Settings.\n */\nexport class WinstonLoggingAddon extends BaseAddon<WinstonConfig> {\n  private destination: WinstonDestination | null = null\n\n  constructor() {\n    super({ level: 'info', retentionDays: 30 })\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    const logsDir = await this.ctx.api.storage.resolve.query({ location: 'logs', relativePath: '' })\n      .catch(() => 'camstack-data/logs')\n    this.destination = new WinstonDestination()\n    await this.destination.initialize({ ...this.config, logsDir })\n    this.ctx.logger.info('Winston 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(): WinstonDestination {\n    if (!this.destination) throw new Error('Winston not initialized')\n    return this.destination\n  }\n\n  protected globalSettingsSchema() {\n    return this.schema({\n      sections: [\n        {\n          id: 'winston-logging',\n          title: 'Logging',\n          description: 'Global log verbosity + retention for rotated log files on this node.',\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            this.field({\n              type: 'number',\n              key: 'retentionDays',\n              label: 'Retention (days)',\n              description: 'Number of days to keep rotated log files before deletion',\n              min: 1,\n              max: 365,\n              step: 1,\n              default: 30,\n              unit: 'days',\n            }),\n          ],\n        },\n      ],\n    })\n  }\n}\n"],"mappings":"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"}

package/dist/builtins/winston-logging/winston-destination.d.ts

@@ -0,0 +1,22 @@
+import { ILogDestination, LogEntry, LogFilter } from '@camstack/types';
+interface WinstonConfig {
+    readonly level: string;
+    readonly retentionDays: number;
+    /** Resolved absolute path to the logs directory (replaces the old dataPath field). */
+    readonly logsDir: string;
+}
+/**
+ * Rotated-file log destination. Console output goes through the shared
+ * `formatLogLine` so every console sink (Winston, ConsoleDestination,
+ * HubForwarderDestination) emits identical lines. File output keeps a
+ * structured JSON shape so log tooling can query tags/meta.
+ */
+export declare class WinstonDestination implements ILogDestination {
+    private logger;
+    initialize(config?: WinstonConfig): Promise<void>;
+    write(entry: LogEntry): void;
+    query(_filter: LogFilter): Promise<readonly LogEntry[]>;
+    shutdown(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=winston-destination.d.ts.map

package/dist/builtins/winston-logging/winston-destination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"winston-destination.d.ts","sourceRoot":"","sources":["../../../src/builtins/winston-logging/winston-destination.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAG3E,UAAU,aAAa;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,sFAAsF;IACtF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,MAAM,CAA8B;IAEtC,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAoDvD,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAsBtB,KAAK,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC;IAKvD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAShC"}

package/dist/builtins/winston-logging/winston-logging.addon.d.ts

@@ -0,0 +1,20 @@
+import { ProviderRegistration, BaseAddon } from '@camstack/types';
+import { WinstonDestination } from './winston-destination.js';
+interface WinstonConfig {
+    readonly level: string;
+    readonly retentionDays: number;
+}
+/**
+ * Winston logging addon — rotated log files + console output.
+ * Settings appear under Cluster → NodeDetail → Settings.
+ */
+export declare class WinstonLoggingAddon extends BaseAddon<WinstonConfig> {
+    private destination;
+    constructor();
+    protected onInitialize(): Promise<ProviderRegistration[]>;
+    protected onShutdown(): Promise<void>;
+    getDestination(): WinstonDestination;
+    protected globalSettingsSchema(): import('@camstack/types').ConfigUISchema;
+}
+export {};
+//# sourceMappingURL=winston-logging.addon.d.ts.map

package/dist/builtins/winston-logging/winston-logging.addon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"winston-logging.addon.d.ts","sourceRoot":"","sources":["../../../src/builtins/winston-logging/winston-logging.addon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAC3D,OAAO,EAAE,SAAS,EAA4B,MAAM,iBAAiB,CAAA;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAE7D,UAAU,aAAa;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,SAAS,CAAC,aAAa,CAAC;IAC/D,OAAO,CAAC,WAAW,CAAkC;;cAMrC,YAAY,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;cAS/C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C,cAAc,IAAI,kBAAkB;IAKpC,SAAS,CAAC,oBAAoB;CAqC/B"}

package/dist/chunk-C13QxCFV.js

@@ -0,0 +1,50 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+Object.defineProperty(exports, "__commonJSMin", {
+	enumerable: true,
+	get: function() {
+		return __commonJSMin;
+	}
+});
+Object.defineProperty(exports, "__exportAll", {
+	enumerable: true,
+	get: function() {
+		return __exportAll;
+	}
+});
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});

package/dist/chunk-hT5z_Zn9.mjs

@@ -0,0 +1,35 @@
+import { createRequire } from "node:module";
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+//#endregion
+export { __toESM as i, __exportAll as n, __require as r, __commonJSMin as t };

package/dist/download/model-download-service.d.ts

@@ -0,0 +1,42 @@
+import { ModelCatalogEntry, ModelFormat, IAddonModelManager } from '@camstack/types';
+/**
+ * Unified model download service.
+ *
+ * Handles downloading model files and extra files (labels, dicts) from a
+ * catalog of ModelCatalogEntry items. Supports single-file models and
+ * directory bundles (e.g., .mlpackage for CoreML).
+ *
+ * Addons use this via `context.models.ensure(modelId, format)`.
+ */
+export declare class ModelDownloadService implements IAddonModelManager {
+    private readonly modelsDir;
+    private readonly onProgress?;
+    private readonly catalog;
+    constructor(modelsDir: string, catalog: readonly ModelCatalogEntry[], onProgress?: ((modelId: string, downloaded: number, total: number) => void) | undefined);
+    /**
+     * Ensure a model (and its extra files) is downloaded.
+     * Returns the local filesystem path to the model file/directory.
+     */
+    ensure(modelId: string, format?: ModelFormat): Promise<string>;
+    /**
+     * Ensure extra files for a model are downloaded.
+     * Returns the local paths of all extra files.
+     */
+    ensureExtraFiles(modelId: string): Promise<readonly string[]>;
+    /** Absolute path to the shared models directory. */
+    getModelsDir(): string;
+    /** Check if a model file is already present on disk. */
+    isDownloaded(modelId: string, format?: ModelFormat): boolean;
+    /** Get the catalog entry for a model by ID. */
+    getEntry(modelId: string): ModelCatalogEntry | undefined;
+    private pickDefaultFormat;
+    private modelFilePath;
+    /**
+     * Download a directory bundle (e.g., .mlpackage) from HuggingFace.
+     * ATOMIC: downloads to temp dir, renames only on complete success.
+     */
+    private downloadDirectory;
+    /** Recursively list all files in a HuggingFace directory via API. */
+    private listHfFiles;
+}
+//# sourceMappingURL=model-download-service.d.ts.map

package/dist/download/model-download-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-download-service.d.ts","sourceRoot":"","sources":["../../src/download/model-download-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAKzF;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,YAAW,kBAAkB;IAI3D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAL9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;gBAG7C,SAAS,EAAE,MAAM,EAClC,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACpB,UAAU,CAAC,GAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,aAAA;IAS5F;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAwDpE;;;OAGG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAkBnE,oDAAoD;IACpD,YAAY,IAAI,MAAM;IAItB,wDAAwD;IACxD,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO;IAmB5D,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAQxD,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,aAAa;IAUrB;;;OAGG;YACW,iBAAiB;IAgD/B,qEAAqE;YACvD,WAAW;CAwB1B"}

package/dist/download/model-downloader.d.ts

@@ -0,0 +1,32 @@
+import { ModelCatalogEntry, ModelDownloadOptions, ModelDownloadResult, ModelFormat } from '@camstack/types';
+/**
+ * Download a single file from a URL to a destination path.
+ * Uses native fetch() (Node 22+) which handles redirects natively.
+ * Streams to disk with optional progress callback.
+ * Returns the destination path. Skips download if file already exists.
+ */
+export declare function downloadFile(url: string, destPath: string, onProgress?: (downloaded: number, total: number) => void): Promise<string>;
+/**
+ * Fetch JSON from a URL using native fetch().
+ */
+export declare function fetchJson(url: string): Promise<unknown>;
+/**
+ * Download a model with fallback URLs and optional SHA256 verification.
+ * Legacy API preserved for backward compatibility -- delegates to downloadFile().
+ */
+export declare function downloadModel(options: ModelDownloadOptions): Promise<ModelDownloadResult>;
+/** Progress callback: (downloadedBytes, totalBytes | undefined) */
+export type DownloadProgressCallback = (downloaded: number, total: number | undefined) => void;
+/**
+ * Resolve a `ModelCatalogEntry` against `modelsDir`: download model file
+ * (or directory bundle) + extra files (labels JSON, charset dict, …),
+ * skip if already on disk. Returns the local model path.
+ */
+export declare function ensureModel(modelsDir: string, entry: ModelCatalogEntry, format: ModelFormat, onProgress?: DownloadProgressCallback): Promise<string>;
+/** Compute the on-disk path for a given model + format, even when not yet downloaded. */
+export declare function getModelFilePath(modelsDir: string, entry: ModelCatalogEntry, format: ModelFormat): string | null;
+/** True iff the model file (or `Manifest.json` for directory bundles) exists and is non-empty. */
+export declare function isModelDownloaded(modelsDir: string, entry: ModelCatalogEntry, format: ModelFormat): boolean;
+/** Remove the on-disk model file/directory. Returns true if something was deleted. */
+export declare function deleteModelFromDisk(modelsDir: string, entry: ModelCatalogEntry, format: ModelFormat): boolean;
+//# sourceMappingURL=model-downloader.d.ts.map

package/dist/download/model-downloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-downloader.d.ts","sourceRoot":"","sources":["../../src/download/model-downloader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAehH;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACvD,OAAO,CAAC,MAAM,CAAC,CAiDjB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAS7D;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsC/F;AAwBD,mEAAmE;AACnE,MAAM,MAAM,wBAAwB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;AAkD9F;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,wBAAwB,GACpC,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,WAAW,GAClB,MAAM,GAAG,IAAI,CAKf;AAED,kGAAkG;AAClG,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAOT;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAUT"}

package/dist/events/event-bus.d.ts

@@ -0,0 +1,11 @@
+type EventCallback<T = unknown> = (data: T) => void;
+export declare class EventBus {
+    private listeners;
+    on<T = unknown>(event: string, callback: EventCallback<T>): () => void;
+    emit<T = unknown>(event: string, data: T): void;
+    once<T = unknown>(event: string, callback: EventCallback<T>): () => void;
+    removeAllListeners(event?: string): void;
+    listenerCount(event: string): number;
+}
+export {};
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/events/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/events/event-bus.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;AAEnD,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAAwC;IAEzD,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAOtE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAQ/C,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAQxE,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAKxC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAGrC"}

package/dist/events/system-event-bus.d.ts

@@ -0,0 +1,15 @@
+import { EventSource, SystemEvent, EventFilter, IEventBus } from '@camstack/types';
+export type { EventSource, SystemEvent, EventFilter };
+export declare class SystemEventBus implements IEventBus {
+    private readonly ringBuffer;
+    private readonly subscribers;
+    constructor(bufferSize?: number);
+    emit(event: SystemEvent): void;
+    /**
+     * Subscribe to events matching a filter.
+     * When called with a typed category filter, the handler receives typed event data.
+     */
+    subscribe(filter: EventFilter, handler: (event: SystemEvent) => void): () => void;
+    getRecent(filter?: EventFilter, limit?: number): readonly SystemEvent[];
+}
+//# sourceMappingURL=system-event-bus.d.ts.map

package/dist/events/system-event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-event-bus.d.ts","sourceRoot":"","sources":["../../src/events/system-event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,SAAS,EACV,MAAM,iBAAiB,CAAA;AAExB,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,CAAA;AAsGrD,qBAAa,cAAe,YAAW,SAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;gBAEnC,UAAU,GAAE,MAAc;IAItC,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAgB9B;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI;IAYjF,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE;CAGxE"}

package/dist/feature/feature-manager.d.ts

@@ -0,0 +1,12 @@
+import { FeatureManifest, FeatureFlag } from '@camstack/types';
+export type { FeatureManifest, FeatureFlag };
+export type FeatureConfigReader = {
+    readonly features: FeatureManifest;
+};
+export declare class FeatureManager {
+    private readonly configReader;
+    constructor(configReader: FeatureConfigReader);
+    isEnabled(flag: FeatureFlag): boolean;
+    getManifest(): FeatureManifest;
+}
+//# sourceMappingURL=feature-manager.d.ts.map

package/dist/feature/feature-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-manager.d.ts","sourceRoot":"","sources":["../../src/feature/feature-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAEnE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,CAAA;AAE5C,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;CACnC,CAAA;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,mBAAmB;IAE9D,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAIrC,WAAW,IAAI,eAAe;CAG/B"}

package/dist/formatter-C-5An4Bl.mjs

@@ -0,0 +1,164 @@
+//#region src/logging/formatter.ts
+var USE_COLOR = (() => {
+	try {
+		if (typeof process === "undefined") return false;
+		const env = process.env ?? {};
+		if (env["NO_COLOR"]) return false;
+		const force = env["FORCE_COLOR"];
+		if (force !== void 0) return force !== "" && force !== "0" && force !== "false";
+		return Boolean(process.stdout?.isTTY);
+	} catch {
+		return false;
+	}
+})();
+/** True when `NO_COLOR` is set — destinations that force colour on still honour this. */
+var NO_COLOR = (() => {
+	try {
+		return Boolean(process?.env?.["NO_COLOR"]);
+	} catch {
+		return false;
+	}
+})();
+var RESET = "\x1B[0m";
+var ANSI = {
+	green: "\x1B[32m",
+	yellow: "\x1B[33m",
+	red: "\x1B[31m",
+	cyan: "\x1B[36m",
+	gray: "\x1B[90m"
+};
+var COLOR_BY_LEVEL = {
+	debug: ANSI.gray,
+	info: ANSI.green,
+	warn: ANSI.yellow,
+	error: ANSI.red
+};
+function paint(color, text, enabled) {
+	return enabled ? `${color}${text}${RESET}` : text;
+}
+function colorizeLevel(level, text, enabled) {
+	if (!enabled) return text;
+	const code = COLOR_BY_LEVEL[level];
+	return code ? `${code}${text}${RESET}` : text;
+}
+/** Right-pad `value` to exactly `width` characters. */
+function padRight(value, width) {
+	if (value.length >= width) return value.slice(0, width);
+	return value + " ".repeat(width - value.length);
+}
+/** Derive the agent — the top-level cluster node, never the forked-worker suffix. */
+function resolveAgent(tags) {
+	const agentId = tags?.agentId;
+	if (typeof agentId === "string" && agentId.length > 0) return agentId;
+	const nodeId = tags?.nodeId;
+	if (typeof nodeId === "string" && nodeId.length > 0) return nodeId.includes("/") ? nodeId.split("/")[0] : nodeId;
+	return null;
+}
+/** Derive the addon — `tags.addonId` first; `system` when the tag is missing
+*  (scope is no longer a fallback — it's a sub-component label, not identity). */
+function resolveAddon(entry) {
+	const addonId = entry.tags?.addonId;
+	if (typeof addonId === "string" && addonId.length > 0) return addonId;
+	return "system";
+}
+/** Device name (or `#id` fallback) — used inside the context bracket when present. */
+function resolveDevice(tags) {
+	const name = tags?.deviceName;
+	if (typeof name === "string" && name.length > 0) return name;
+	const id = tags?.deviceId;
+	if (typeof id === "number" && Number.isFinite(id)) return `#${id}`;
+	return null;
+}
+/**
+* Build the brand bracket content — `<agent>/<addonId>`. Agent is
+* always shown (even `hub`) so operators never have to guess which
+* node emitted a line. Falls back to `?/<addon>` when tags don't
+* carry an agent id (pre-boot logs, test harnesses).
+*/
+function buildBrand(entry) {
+	return `${resolveAgent(entry.tags) ?? "?"}/${resolveAddon(entry)}`;
+}
+/**
+* Build the optional device-context bracket. Returns `null` when the
+* line doesn't carry a device tag — renders as just the brand + message
+* without the second bracket. With a device tag: `salone` / `#42`.
+*/
+function buildDeviceContext(entry) {
+	return resolveDevice(entry.tags);
+}
+/**
+* NestJS-style locale timestamp: `M/D/YYYY, H:MM:SS AM`. Built with
+* `toLocaleString('en-US')` to match the default NestJS format that
+* operators are used to from Nest boot output.
+*/
+function formatTimestamp(value) {
+	return (value instanceof Date ? value : new Date(typeof value === "string" ? value : Date.now())).toLocaleString("en-US", {
+		month: "numeric",
+		day: "numeric",
+		year: "numeric",
+		hour: "numeric",
+		minute: "2-digit",
+		second: "2-digit",
+		hour12: true
+	});
+}
+/** Compact `{key=value key="with space"}` rendering of an arbitrary object. Empty → ''. */
+function formatMeta(meta) {
+	if (!meta) return "";
+	const keys = Object.keys(meta);
+	if (keys.length === 0) return "";
+	const parts = [];
+	for (const key of keys) {
+		const value = meta[key];
+		parts.push(`${key}=${formatMetaValue(value)}`);
+	}
+	return `{${parts.join(" ")}}`;
+}
+function formatMetaValue(value) {
+	if (value === null) return "null";
+	if (value === void 0) return "undefined";
+	if (typeof value === "string") return /\s|"/.test(value) ? JSON.stringify(value) : value;
+	if (typeof value === "number" || typeof value === "boolean") return String(value);
+	if (value instanceof Error) return JSON.stringify(value.message);
+	try {
+		return JSON.stringify(value);
+	} catch {
+		return String(value);
+	}
+}
+/** Cached renderer PID — fallback when the entry doesn't carry its own `tags.pid`. */
+var PID = typeof process !== "undefined" && typeof process.pid === "number" ? String(process.pid) : "?";
+/**
+* Render a `LogEntry` as one complete console line — no trailing newline.
+* Caller appends `\n` (file sinks) or relies on `console.log` (stdout sink).
+*
+* PID column prefers `entry.tags.pid` when set (so forked-worker entries
+* carry the worker's OS pid even when the hub renders them), falling back
+* to the renderer's own `process.pid`.
+*
+* Colours (when enabled) follow the NestJS convention: the level token
+* AND the message body share the level colour (green/yellow/red/gray for
+* info/warn/error/debug). Brand, device context, scope and meta keep
+* their fixed hues so the structural fields stay visually distinct from
+* the message content.
+*/
+function formatLogLine(entry, options) {
+	const colorize = (options?.colorize ?? USE_COLOR) && !NO_COLOR;
+	const levelColor = COLOR_BY_LEVEL[entry.level];
+	const brand = paint(ANSI.green, `[${buildBrand(entry)}]`, colorize);
+	const entryPid = entry.tags?.pid;
+	const pid = typeof entryPid === "number" ? String(entryPid) : PID;
+	const timestamp = formatTimestamp(entry.timestamp);
+	const level = colorizeLevel(entry.level, padRight(entry.level.toUpperCase(), 5), colorize);
+	const device = buildDeviceContext(entry);
+	const ctxPart = device ? " " + paint(ANSI.yellow, `[${device}]`, colorize) : "";
+	const scope = typeof entry.scope === "string" && entry.scope.length > 0 ? entry.scope : null;
+	const scopePart = scope ? " " + paint(ANSI.cyan, `(${scope})`, colorize) : "";
+	const metaText = formatMeta(entry.meta);
+	const metaPart = metaText ? " " + paint(ANSI.gray, metaText, colorize) : "";
+	return `${brand} ${pid}  - ${timestamp}     ${level}${ctxPart}${scopePart} ${colorize && levelColor ? `${levelColor}${entry.message}${RESET}` : entry.message}${metaPart}`;
+}
+//#endregion
+export { formatLogLine as t };
+
+//# sourceMappingURL=formatter-C-5An4Bl.mjs.map