@camstack/core 0.1.15 → 0.1.16

package/dist/lifecycle/lifecycle-state-machine.d.ts

@@ -0,0 +1,29 @@
+import { IScopedLogger, IEventBus } from '@camstack/types';
+export type ElementState = 'stopped' | 'starting' | 'running' | 'stopping' | 'error' | 'disabled';
+export interface ElementStatus {
+    state: ElementState;
+    error?: string;
+    startedAt?: number;
+    stoppedAt?: number;
+    restartCount: number;
+    uptime: number;
+}
+export declare class LifecycleStateMachine {
+    private readonly elementId;
+    private readonly elementType;
+    private readonly eventBus;
+    private readonly logger;
+    private _state;
+    private _error?;
+    private _startedAt?;
+    private _stoppedAt?;
+    private _restartCount;
+    private _hasStartedOnce;
+    constructor(elementId: string, elementType: 'provider' | 'device' | 'addon' | 'process', eventBus: IEventBus, logger: IScopedLogger);
+    get state(): ElementState;
+    getStatus(): ElementStatus;
+    transition(to: ElementState, error?: string): boolean;
+    incrementRestartCount(): void;
+    private isValidTransition;
+}
+//# sourceMappingURL=lifecycle-state-machine.d.ts.map

package/dist/lifecycle/lifecycle-state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-state-machine.d.ts","sourceRoot":"","sources":["../../src/lifecycle/lifecycle-state-machine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE/D,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAA;AAEjG,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;CACf;AAWD,qBAAa,qBAAqB;IAS9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXzB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,UAAU,CAAC,CAAQ;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAQ;IAC3B,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,eAAe,CAAQ;gBAGZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,EACxD,QAAQ,EAAE,SAAS,EACnB,MAAM,EAAE,aAAa;IAGxC,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,SAAS,IAAI,aAAa;IAc1B,UAAU,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAqCrD,qBAAqB,IAAI,IAAI;IAI7B,OAAO,CAAC,iBAAiB;CAG1B"}

package/dist/logging/formatter.d.ts

@@ -0,0 +1,31 @@
+import { LogEntry } from '@camstack/types';
+/** Options for `formatLogLine`. */
+export interface FormatLogLineOptions {
+    /**
+     * Emit ANSI colour codes. When omitted, falls back to the shell-env
+     * heuristic (`NO_COLOR`/`FORCE_COLOR`/`isTTY`). Destinations that
+     * always target a console (ConsoleDestination, HubForwarderDestination)
+     * pass `true`; file sinks (Winston JSON) pass `false` so logs on disk
+     * stay plain text regardless of the shell env.
+     *
+     * `NO_COLOR=1` in the environment still wins — consumer opt-in beats
+     * producer opt-in, matching the https://no-color.org/ convention.
+     */
+    readonly colorize?: boolean;
+}
+/**
+ * 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.
+ */
+export declare function formatLogLine(entry: LogEntry, options?: FormatLogLineOptions): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/logging/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/logging/formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAW,MAAM,iBAAiB,CAAA;AAgKxD,mCAAmC;AACnC,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAyBrF"}

package/dist/logging/log-manager.d.ts

@@ -0,0 +1,52 @@
+import { LogEntry, LogFilter } from './log-ring-buffer.js';
+import { IScopedLogger } from './scoped-logger.js';
+export interface ILogDestination {
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    write(entry: LogEntry): void;
+    query?(filter: LogFilter): Promise<readonly LogEntry[]>;
+}
+export declare class LogManager {
+    private readonly ringBuffer;
+    private readonly destinations;
+    private readonly subscribers;
+    private deviceNameLookup;
+    constructor(bufferSize?: number);
+    /**
+     * Register a callback that resolves `deviceId → deviceName`. Called
+     * for every emitted entry that carries `tags.deviceId` but no
+     * explicit `tags.deviceName` — the LogManager injects the resolved
+     * name directly into the entry's tags BEFORE ring-buffer / destination
+     * write, so every destination (local console, file, remote forwarder,
+     * addon-bundled copies of core) sees the enriched shape regardless of
+     * which module instance the destination was built from.
+     */
+    setDeviceNameLookup(lookup: ((deviceId: number) => string | null) | null): void;
+    createLogger(scope?: string): IScopedLogger;
+    private enrichDeviceName;
+    /** Subscribe to live logs matching a filter. Returns an unsubscribe function. */
+    subscribe(filter: Partial<LogFilter>, callback: (entry: LogEntry) => void): () => void;
+    private matchesFilter;
+    /**
+     * Register a log destination.
+     *
+     * @param opts.replay  If true (default), replay every entry currently in
+     *                     the ring buffer to the new destination before live
+     *                     traffic starts. Lets a destination added mid-boot
+     *                     still receive boot-time log entries.
+     */
+    addDestination(dest: ILogDestination, opts?: {
+        replay?: boolean;
+    }): void;
+    removeDestination(dest: ILogDestination): void;
+    query(filter: LogFilter): LogEntry[];
+    /**
+     * Drop ring-buffer entries matching `filter`. Returns the count
+     * removed. Backs the UI's "Clear logs" admin action so an operator
+     * can wipe the historical window for a scope (per-device, per-addon,
+     * agent-level) without restarting the server. External destinations
+     * (file, forwarder) are NOT touched — only the in-memory ring.
+     */
+    clear(filter?: LogFilter): number;
+}
+//# sourceMappingURL=log-manager.d.ts.map

package/dist/logging/log-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-manager.d.ts","sourceRoot":"","sources":["../../src/logging/log-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACnG,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAErE,MAAM,WAAW,eAAe;IAC9B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC5B,KAAK,CAAC,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAA;CACxD;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyF;IACrH,OAAO,CAAC,gBAAgB,CAAqD;gBAEjE,UAAU,GAAE,MAAc;IAItC;;;;;;;;OAQG;IACH,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAI/E,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa;IAgB3C,OAAO,CAAC,gBAAgB;IAYxB,iFAAiF;IACjF,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI;IAMtF,OAAO,CAAC,aAAa;IAarB;;;;;;;OAOG;IACH,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAU5E,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAO9C,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,EAAE;IAIpC;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,GAAE,SAAc,GAAG,MAAM;CAGtC"}

package/dist/logging/log-ring-buffer.d.ts

@@ -0,0 +1,48 @@
+import { LogLevel, LogEntry, LogFilter, LogTags } from '@camstack/types';
+export type { LogLevel, LogEntry, LogFilter };
+/**
+ * Per-tag filter matcher with semantic-aware comparisons:
+ *
+ *   `addonId`  — matches the entry's bare addon id (strips any `@<workerId>`
+ *                qualifier added by the cap-router for remote providers).
+ *                So a UI filter for `audio-classifier` matches both the
+ *                addon's own log lines and bridge management lines whose
+ *                addonId is logged as `audio-classifier@dev-agent-0/audio-classifier`.
+ *
+ *   `agentId`  — matches when ANY of these hold:
+ *                  * the entry was emitted by that agent (`agentId` exact)
+ *                  * the entry's `nodeId` IS that agent (single-node case)
+ *                  * the entry's `nodeId` starts with `<agent>/` (worker
+ *                    inside that agent — e.g. `dev-agent-0/audio-classifier`)
+ *                Captures all the log emission paths for an addon hosted
+ *                on the agent regardless of who actually emitted the line.
+ *
+ *   any other key — exact match (legacy semantics).
+ *
+ * Returns `true` when ALL filter keys match (AND), `false` otherwise.
+ * `undefined` filter values are skipped.
+ */
+export declare function matchesLogTags(entryTags: LogTags | undefined, filterTags: Partial<LogTags>): boolean;
+export declare class LogRingBuffer {
+    private readonly capacity;
+    private readonly buffer;
+    private head;
+    private count;
+    constructor(capacity?: number);
+    push(entry: LogEntry): void;
+    getAll(): LogEntry[];
+    query(filter: LogFilter): LogEntry[];
+    /**
+     * Drop entries that match `filter`. Returns the number of entries
+     * removed. Triggered by the UI's "Clear logs" button so the operator
+     * can wipe the historical buffer for a specific scope (per-device,
+     * per-addon, per-agent) — without it, closing and reopening the
+     * panel re-populates the cleared rows from the server's ring buffer.
+     *
+     * Filter semantics mirror `query` (same level / since / until / tags
+     * handling) — whatever you'd see listed by `query(filter)` is what
+     * gets removed.
+     */
+    clear(filter?: LogFilter): number;
+}
+//# sourceMappingURL=log-ring-buffer.d.ts.map

package/dist/logging/log-ring-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-ring-buffer.d.ts","sourceRoot":"","sources":["../../src/logging/log-ring-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAE7E,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,OAAO,GAAG,SAAS,EAC9B,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,GAC3B,OAAO,CAkCT;AAED,qBAAa,aAAa;IAKZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,KAAK,CAAI;gBAEY,QAAQ,GAAE,MAAc;IAIrD,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAQ3B,MAAM,IAAI,QAAQ,EAAE;IAWpB,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,EAAE;IA4BpC;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,GAAE,SAAc,GAAG,MAAM;CA0BtC"}

package/dist/logging/scoped-logger.d.ts

@@ -0,0 +1,18 @@
+import { IScopedLogger, LogExtras, LogTags } from '@camstack/types';
+import { LogEntry } from './log-ring-buffer.js';
+export type { IScopedLogger };
+export declare class ScopedLogger implements IScopedLogger {
+    private readonly scope;
+    private readonly writeFn;
+    private readonly tags?;
+    constructor(scope: string | undefined, writeFn: (entry: LogEntry) => void, tags?: LogTags | undefined);
+    debug(message: string, extras?: LogExtras): void;
+    info(message: string, extras?: LogExtras): void;
+    warn(message: string, extras?: LogExtras): void;
+    error(message: string, extras?: LogExtras): void;
+    child(childScope: string): IScopedLogger;
+    withTags(tags: LogTags): IScopedLogger;
+    private write;
+    private mergeTags;
+}
+//# sourceMappingURL=scoped-logger.d.ts.map

package/dist/logging/scoped-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-logger.d.ts","sourceRoot":"","sources":["../../src/logging/scoped-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,sBAAsB,CAAA;AAE9D,YAAY,EAAE,aAAa,EAAE,CAAA;AAE7B,qBAAa,YAAa,YAAW,aAAa;IAE9C,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAFL,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,EAClC,IAAI,CAAC,EAAE,OAAO,YAAA;IAGjC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI;IAIhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI;IAI/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI;IAI/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI;IAIhD,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAIxC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa;IAKtC,OAAO,CAAC,KAAK;IAab,OAAO,CAAC,SAAS;CAMlB"}

package/dist/network/network-quality.d.ts

@@ -0,0 +1,12 @@
+import { StreamNetworkStats, ClientNetworkStats, DeviceNetworkStats, INetworkQualityTracker } from '@camstack/types';
+export type { StreamNetworkStats, ClientNetworkStats, DeviceNetworkStats, INetworkQualityTracker, };
+export declare class NetworkQualityTracker implements INetworkQualityTracker {
+    private readonly devices;
+    private static readonly MAX_SAMPLES;
+    reportStreamStats(deviceId: number, streamId: string, bitrateKbps: number, packetLoss?: number): void;
+    reportClientStats(deviceId: number, stats: Omit<ClientNetworkStats, 'lastUpdated'>): void;
+    getDeviceStats(deviceId: number): DeviceNetworkStats | null;
+    getAllStats(): readonly DeviceNetworkStats[];
+    private getOrCreateDevice;
+}
+//# sourceMappingURL=network-quality.d.ts.map

package/dist/network/network-quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-quality.d.ts","sourceRoot":"","sources":["../../src/network/network-quality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,iBAAiB,CAAA;AAExB,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,GACvB,CAAA;AAUD,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGpB;IAEJ,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAK;IAExC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAqBrG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,aAAa,CAAC,GAAG,IAAI;IAKzF,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAmB3D,WAAW,IAAI,SAAS,kBAAkB,EAAE;IAS5C,OAAO,CAAC,iBAAiB;CAQ1B"}

package/dist/notification/notification-service.d.ts

@@ -0,0 +1,38 @@
+import { INotificationOutput, Notification, ICapabilityRegistry } from '@camstack/types';
+import { IScopedLogger } from '../logging/scoped-logger.js';
+/**
+ * Central notification service that routes notifications to configured outputs.
+ * Framework-agnostic — dependencies injected via constructor.
+ *
+ * Outputs are resolved from the ICapabilityRegistry's 'notification-output'
+ * collection on each call (proxy pattern). Falls back to a local map
+ * when no registry is provided (backward compat).
+ */
+export declare class NotificationService {
+    private readonly logger;
+    private readonly localOutputs;
+    private readonly routing;
+    private readonly rateLimits;
+    private readonly lastSent;
+    private registry;
+    constructor(logger: IScopedLogger);
+    /** Set the registry for live output lookup. Called once during boot. */
+    setRegistry(registry: ICapabilityRegistry): void;
+    /** Resolve all outputs — prefers registry, falls back to local map */
+    private get outputs();
+    /** Register an output in the local fallback map (used when no registry is set). */
+    registerLocalOutput(output: INotificationOutput): void;
+    /** Remove an output from the local fallback map. */
+    unregisterLocalOutput(id: string): void;
+    setRouting(category: string, outputIds: string[]): void;
+    setRateLimit(category: string, minIntervalMs: number): void;
+    notify(notification: Notification): Promise<void>;
+    getOutputs(): ReadonlyArray<{
+        id: string;
+        name: string;
+        icon: string;
+    }>;
+    getRouting(): ReadonlyMap<string, string[]>;
+    getOutput(id: string): INotificationOutput | undefined;
+}
+//# sourceMappingURL=notification-service.d.ts.map

package/dist/notification/notification-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-service.d.ts","sourceRoot":"","sources":["../../src/notification/notification-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAGhE;;;;;;;GAOG;AACH,qBAAa,mBAAmB;IAOlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAmC;gBAEtB,MAAM,EAAE,aAAa;IAElD,wEAAwE;IACxE,WAAW,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAIhD,sEAAsE;IACtE,OAAO,KAAK,OAAO,GAUlB;IAED,mFAAmF;IACnF,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAKtD,oDAAoD;IACpD,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKvC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAIvD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAIrD,MAAM,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CvD,UAAU,IAAI,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAIvE,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAI3C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;CAGvD"}

package/dist/notification/toast-service.d.ts

@@ -0,0 +1,23 @@
+import { Toast } from '@camstack/types';
+export type Unsubscribe = () => void;
+/**
+ * Service for broadcasting toast notifications to connected UI clients.
+ * Framework-agnostic — integrates with tRPC subscriptions via subscribe().
+ */
+export declare class ToastService {
+    private readonly listeners;
+    /**
+     * Subscribe to toast events for a specific user.
+     * Returns an unsubscribe function.
+     */
+    subscribe(connectionId: string, userId: string, callback: (toast: Toast) => void): Unsubscribe;
+    /**
+     * Broadcast a toast to all connected clients.
+     */
+    broadcast(toast: Toast): void;
+    /**
+     * Send a toast to a specific user's connections only.
+     */
+    sendToUser(userId: string, toast: Toast): void;
+}
+//# sourceMappingURL=toast-service.d.ts.map

package/dist/notification/toast-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast-service.d.ts","sourceRoot":"","sources":["../../src/notification/toast-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAE5C,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAA;AAOpC;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAE7D;;;OAGG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,WAAW;IAO9F;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAM7B;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;CAO/C"}

package/dist/pipeline/engine-manager-resolver.d.ts

@@ -0,0 +1,16 @@
+import { IAddonResolver, IAddonCaller, IEngineManager } from '@camstack/types';
+/**
+ * Adapter that wraps an IEngineManager + addonConfigs as an IAddonResolver.
+ *
+ * Used for backwards compatibility — the in-process AddonEngineManager
+ * still uses the old getOrCreateEngine(addonId, globalConfig, override) API.
+ * This adapter bridges it to the new resolve(addonId, config) interface.
+ */
+export declare class EngineManagerResolver implements IAddonResolver {
+    private readonly engineManager;
+    private readonly addonConfigs;
+    constructor(engineManager: IEngineManager, addonConfigs: Map<string, Record<string, unknown>>);
+    resolve(addonId: string, config: Record<string, unknown>): Promise<IAddonCaller>;
+    shutdownAll(): Promise<void>;
+}
+//# sourceMappingURL=engine-manager-resolver.d.ts.map

package/dist/pipeline/engine-manager-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-manager-resolver.d.ts","sourceRoot":"","sources":["../../src/pipeline/engine-manager-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EAIf,MAAM,iBAAiB,CAAA;AAExB;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IAExD,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,aAAa,EAAE,cAAc,EAC7B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAG/D,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAWhF,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAGnC"}

package/dist/pipeline/pipeline-runner.d.ts

@@ -0,0 +1,9 @@
+import { FrameInput, PipelineConfig, PipelineResult, IAddonResolver } from '@camstack/types';
+export declare class PipelineRunner {
+    private readonly addonResolver;
+    constructor(addonResolver: IAddonResolver);
+    run(frame: FrameInput, config: PipelineConfig): Promise<PipelineResult>;
+    private executeNode;
+    private executeChildren;
+}
+//# sourceMappingURL=pipeline-runner.d.ts.map

package/dist/pipeline/pipeline-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-runner.d.ts","sourceRoot":"","sources":["../../src/pipeline/pipeline-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAEV,cAAc,EAEd,cAAc,EAId,cAAc,EAEf,MAAM,iBAAiB,CAAA;AAIxB,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,cAAc;IAG1C,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;YAsB/D,WAAW;YAqFX,eAAe;CA0B9B"}

package/dist/pipeline/pipeline-validator.d.ts

@@ -0,0 +1,14 @@
+import { PipelineConfig, ValidationIssue, ValidationResult } from '@camstack/types';
+export type { ValidationIssue, ValidationResult };
+/**
+ * Check if a pipeline step is available in the system.
+ * Implementations should check the capability registry for `pipeline-step:{stepId}`.
+ */
+export type StepExistsFn = (stepId: string) => boolean;
+export declare class PipelineValidator {
+    private readonly stepExists;
+    constructor(stepExists: StepExistsFn);
+    validate(config: PipelineConfig): ValidationResult;
+    private validateNode;
+}
+//# sourceMappingURL=pipeline-validator.d.ts.map

package/dist/pipeline/pipeline-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-validator.d.ts","sourceRoot":"","sources":["../../src/pipeline/pipeline-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAgB,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEtG,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAA;AAEjD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;AAEtD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,YAAY;IAErD,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB;IAmBlD,OAAO,CAAC,YAAY;CAqBrB"}

package/dist/process/resource-monitor.d.ts

@@ -0,0 +1,12 @@
+export interface PidStats {
+    cpu: number;
+    memory: number;
+}
+/**
+ * Get CPU% and memory RSS for one or more PIDs.
+ * Returns a map of pid → stats. Missing/dead PIDs are silently omitted.
+ */
+export declare function getPidStats(pids: number | readonly number[]): Promise<ReadonlyMap<number, PidStats>>;
+/** Get CPU% and memory RSS for a single PID. Returns null if dead. */
+export declare function getSinglePidStats(pid: number): Promise<PidStats | null>;
+//# sourceMappingURL=resource-monitor.d.ts.map

package/dist/process/resource-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-monitor.d.ts","sourceRoot":"","sources":["../../src/process/resource-monitor.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACf;AAgCD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAU1G;AAED,sEAAsE;AACtE,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAG7E"}

package/dist/python/python-env-manager.d.ts

@@ -0,0 +1,13 @@
+import { IPythonEnvironment, PythonProbeResult, PythonEnvReady } from '@camstack/types';
+import { ChildProcess } from 'node:child_process';
+export declare class PythonEnvManager implements IPythonEnvironment {
+    private venvPath;
+    private cachedProbe;
+    constructor(dataDir: string);
+    probe(): Promise<PythonProbeResult>;
+    ensure(options: {
+        packages: readonly string[];
+    }): Promise<PythonEnvReady>;
+    spawn(script: string, args: readonly string[]): ChildProcess;
+}
+//# sourceMappingURL=python-env-manager.d.ts.map

package/dist/python/python-env-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-env-manager.d.ts","sourceRoot":"","sources":["../../src/python/python-env-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAE5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAOtD,qBAAa,gBAAiB,YAAW,kBAAkB;IACzD,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,WAAW,CAAiC;gBAExC,OAAO,EAAE,MAAM;IAIrB,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC;IA6BnC,MAAM,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IA2B/E,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY;CAO7D"}

package/dist/repl/interfaces.d.ts

@@ -0,0 +1,32 @@
+import { ReplResult } from '@camstack/types';
+export interface ReplScope {
+    readonly type: 'system' | 'provider' | 'device' | 'addon';
+    readonly providerId?: string;
+    readonly deviceId?: number;
+    readonly addonId?: string;
+}
+export interface ReplSessionContext {
+    readonly scope: ReplScope;
+    /** Pre-populated variables available in the REPL session */
+    readonly variables: Record<string, unknown>;
+}
+export type { ReplResult };
+export interface IReplEngine {
+    execute(code: string, context: ReplSessionContext): Promise<ReplResult>;
+    getCompletions(partial: string, context: ReplSessionContext): Promise<string[]>;
+}
+/**
+ * Context provider that the server kernel implements.
+ * The REPL engine calls this to build the sandbox for each scope type.
+ *
+ * Methods may return a Promise so the kernel can warm up async
+ * resources (e.g. `SystemManager.init()`) before exposing them — the
+ * engine awaits each before evaluating user code.
+ */
+export interface IReplContextProvider {
+    getSystemSandbox(): Record<string, unknown> | Promise<Record<string, unknown>>;
+    getDeviceSandbox(deviceId: number): Record<string, unknown> | Promise<Record<string, unknown>>;
+    getProviderSandbox(providerId: string): Record<string, unknown> | Promise<Record<string, unknown>>;
+    getAddonSandbox(addonId: string): Record<string, unknown> | Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/repl/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/repl/interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAA;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC5C;AAED,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,YAAY,EAAE,UAAU,EAAE,CAAA;AAE1B,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACvE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CAChF;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC9E,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC9F,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAClG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAC7F"}

package/dist/repl/repl-engine.d.ts

@@ -0,0 +1,9 @@
+import { IReplEngine, IReplContextProvider, ReplSessionContext, ReplResult } from './interfaces.js';
+export declare class ReplEngine implements IReplEngine {
+    private readonly contextProvider;
+    constructor(contextProvider: IReplContextProvider);
+    execute(code: string, context: ReplSessionContext): Promise<ReplResult>;
+    getCompletions(partial: string, context: ReplSessionContext): Promise<string[]>;
+    private buildSandbox;
+}
+//# sourceMappingURL=repl-engine.d.ts.map

package/dist/repl/repl-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl-engine.d.ts","sourceRoot":"","sources":["../../src/repl/repl-engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACX,MAAM,iBAAiB,CAAA;AAKxB,qBAAa,UAAW,YAAW,WAAW;IAE1C,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,EAAE,oBAAoB;IAGlD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAoDvE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAgCvE,YAAY;CA6C3B"}

package/dist/resource-monitor-CmuWlmap.js

@@ -0,0 +1,76 @@
+const require_chunk = require("./chunk-C13QxCFV.js");
+let node_child_process = require("node:child_process");
+//#region src/process/resource-monitor.ts
+var resource_monitor_exports = /* @__PURE__ */ require_chunk.__exportAll({
+	getPidStats: () => getPidStats,
+	getSinglePidStats: () => getSinglePidStats
+});
+function execPsForPids(pids) {
+	return new Promise((resolve, reject) => {
+		(0, node_child_process.execFile)("ps", [
+			"-o",
+			"pid=,pcpu=,rss=",
+			"-p",
+			pids.join(",")
+		], { timeout: 5e3 }, (err, stdout) => {
+			if (err) return reject(err);
+			resolve(stdout);
+		});
+	});
+}
+function parsePsOutput(stdout) {
+	const result = /* @__PURE__ */ new Map();
+	for (const line of stdout.trim().split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed) continue;
+		const parts = trimmed.split(/\s+/);
+		if (parts.length < 3) continue;
+		const pid = parseInt(parts[0], 10);
+		const cpu = parseFloat(parts[1]);
+		const rssKb = parseInt(parts[2], 10);
+		if (isNaN(pid) || isNaN(cpu) || isNaN(rssKb)) continue;
+		result.set(pid, {
+			cpu: Math.round(cpu * 10) / 10,
+			memory: rssKb * 1024
+		});
+	}
+	return result;
+}
+/**
+* Get CPU% and memory RSS for one or more PIDs.
+* Returns a map of pid → stats. Missing/dead PIDs are silently omitted.
+*/
+async function getPidStats(pids) {
+	const pidArray = typeof pids === "number" ? [pids] : [...pids];
+	if (pidArray.length === 0) return /* @__PURE__ */ new Map();
+	try {
+		return parsePsOutput(await execPsForPids(pidArray));
+	} catch {
+		return /* @__PURE__ */ new Map();
+	}
+}
+/** Get CPU% and memory RSS for a single PID. Returns null if dead. */
+async function getSinglePidStats(pid) {
+	return (await getPidStats([pid])).get(pid) ?? null;
+}
+//#endregion
+Object.defineProperty(exports, "getPidStats", {
+	enumerable: true,
+	get: function() {
+		return getPidStats;
+	}
+});
+Object.defineProperty(exports, "getSinglePidStats", {
+	enumerable: true,
+	get: function() {
+		return getSinglePidStats;
+	}
+});
+Object.defineProperty(exports, "resource_monitor_exports", {
+	enumerable: true,
+	get: function() {
+		return resource_monitor_exports;
+	}
+});
+
+//# sourceMappingURL=resource-monitor-CmuWlmap.js.map

package/dist/resource-monitor-CmuWlmap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-monitor-CmuWlmap.js","names":[],"sources":["../src/process/resource-monitor.ts"],"sourcesContent":["import { execFile } from 'node:child_process'\n\n// ===========================================================================\n// Per-PID resource usage — zero dependencies, uses ps (macOS/Linux).\n//\n// These are process-management utilities used by:\n// - native-metrics-provider.ts (system metrics collection)\n// - addon-registry.service.ts (addon process stats)\n//\n// System-wide metrics (CPU, memory, disk, network, GPU, temp, PSI)\n// have moved to @camstack/addon-metrics-native via the IMetricsProvider\n// interface defined in @camstack/types.\n// ===========================================================================\n\nexport interface PidStats {\n  cpu: number      // 0–100 percentage\n  memory: number   // RSS in bytes\n}\n\nfunction execPsForPids(pids: readonly number[]): Promise<string> {\n  return new Promise((resolve, reject) => {\n    execFile('ps', ['-o', 'pid=,pcpu=,rss=', '-p', pids.join(',')], {\n      timeout: 5000,\n    }, (err, stdout) => {\n      if (err) return reject(err)\n      resolve(stdout)\n    })\n  })\n}\n\nfunction parsePsOutput(stdout: string): ReadonlyMap<number, PidStats> {\n  const result = new Map<number, PidStats>()\n  for (const line of stdout.trim().split('\\n')) {\n    const trimmed = line.trim()\n    if (!trimmed) continue\n    const parts = trimmed.split(/\\s+/)\n    if (parts.length < 3) continue\n    const pid = parseInt(parts[0]!, 10)\n    const cpu = parseFloat(parts[1]!)\n    const rssKb = parseInt(parts[2]!, 10)\n    if (isNaN(pid) || isNaN(cpu) || isNaN(rssKb)) continue\n    result.set(pid, {\n      cpu: Math.round(cpu * 10) / 10,\n      memory: rssKb * 1024, // KB → bytes\n    })\n  }\n  return result\n}\n\n/**\n * Get CPU% and memory RSS for one or more PIDs.\n * Returns a map of pid → stats. Missing/dead PIDs are silently omitted.\n */\nexport async function getPidStats(pids: number | readonly number[]): Promise<ReadonlyMap<number, PidStats>> {\n  const pidArray = typeof pids === 'number' ? [pids] : [...pids]\n  if (pidArray.length === 0) return new Map()\n\n  try {\n    const stdout = await execPsForPids(pidArray)\n    return parsePsOutput(stdout)\n  } catch {\n    return new Map()\n  }\n}\n\n/** Get CPU% and memory RSS for a single PID. Returns null if dead. */\nexport async function getSinglePidStats(pid: number): Promise<PidStats | null> {\n  const stats = await getPidStats([pid])\n  return stats.get(pid) ?? null\n}\n"],"mappings":";;;;;;;AAmBA,SAAS,cAAc,MAA0C;CAC/D,OAAO,IAAI,SAAS,SAAS,WAAW;EACtC,CAAA,GAAA,mBAAA,UAAS,MAAM;GAAC;GAAM;GAAmB;GAAM,KAAK,KAAK,IAAI;GAAC,EAAE,EAC9D,SAAS,KACV,GAAG,KAAK,WAAW;GAClB,IAAI,KAAK,OAAO,OAAO,IAAI;GAC3B,QAAQ,OAAO;IACf;GACF;;AAGJ,SAAS,cAAc,QAA+C;CACpE,MAAM,yBAAS,IAAI,KAAuB;CAC1C,KAAK,MAAM,QAAQ,OAAO,MAAM,CAAC,MAAM,KAAK,EAAE;EAC5C,MAAM,UAAU,KAAK,MAAM;EAC3B,IAAI,CAAC,SAAS;EACd,MAAM,QAAQ,QAAQ,MAAM,MAAM;EAClC,IAAI,MAAM,SAAS,GAAG;EACtB,MAAM,MAAM,SAAS,MAAM,IAAK,GAAG;EACnC,MAAM,MAAM,WAAW,MAAM,GAAI;EACjC,MAAM,QAAQ,SAAS,MAAM,IAAK,GAAG;EACrC,IAAI,MAAM,IAAI,IAAI,MAAM,IAAI,IAAI,MAAM,MAAM,EAAE;EAC9C,OAAO,IAAI,KAAK;GACd,KAAK,KAAK,MAAM,MAAM,GAAG,GAAG;GAC5B,QAAQ,QAAQ;GACjB,CAAC;;CAEJ,OAAO;;;;;;AAOT,eAAsB,YAAY,MAA0E;CAC1G,MAAM,WAAW,OAAO,SAAS,WAAW,CAAC,KAAK,GAAG,CAAC,GAAG,KAAK;CAC9D,IAAI,SAAS,WAAW,GAAG,uBAAO,IAAI,KAAK;CAE3C,IAAI;EAEF,OAAO,cAAc,MADA,cAAc,SAAS,CAChB;SACtB;EACN,uBAAO,IAAI,KAAK;;;;AAKpB,eAAsB,kBAAkB,KAAuC;CAE7E,QAAO,MADa,YAAY,CAAC,IAAI,CAAC,EACzB,IAAI,IAAI,IAAI"}

package/dist/resource-monitor-DcQdKGYU.mjs

@@ -0,0 +1,59 @@
+import { n as __exportAll } from "./chunk-hT5z_Zn9.mjs";
+import { execFile } from "node:child_process";
+//#region src/process/resource-monitor.ts
+var resource_monitor_exports = /* @__PURE__ */ __exportAll({
+	getPidStats: () => getPidStats,
+	getSinglePidStats: () => getSinglePidStats
+});
+function execPsForPids(pids) {
+	return new Promise((resolve, reject) => {
+		execFile("ps", [
+			"-o",
+			"pid=,pcpu=,rss=",
+			"-p",
+			pids.join(",")
+		], { timeout: 5e3 }, (err, stdout) => {
+			if (err) return reject(err);
+			resolve(stdout);
+		});
+	});
+}
+function parsePsOutput(stdout) {
+	const result = /* @__PURE__ */ new Map();
+	for (const line of stdout.trim().split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed) continue;
+		const parts = trimmed.split(/\s+/);
+		if (parts.length < 3) continue;
+		const pid = parseInt(parts[0], 10);
+		const cpu = parseFloat(parts[1]);
+		const rssKb = parseInt(parts[2], 10);
+		if (isNaN(pid) || isNaN(cpu) || isNaN(rssKb)) continue;
+		result.set(pid, {
+			cpu: Math.round(cpu * 10) / 10,
+			memory: rssKb * 1024
+		});
+	}
+	return result;
+}
+/**
+* Get CPU% and memory RSS for one or more PIDs.
+* Returns a map of pid → stats. Missing/dead PIDs are silently omitted.
+*/
+async function getPidStats(pids) {
+	const pidArray = typeof pids === "number" ? [pids] : [...pids];
+	if (pidArray.length === 0) return /* @__PURE__ */ new Map();
+	try {
+		return parsePsOutput(await execPsForPids(pidArray));
+	} catch {
+		return /* @__PURE__ */ new Map();
+	}
+}
+/** Get CPU% and memory RSS for a single PID. Returns null if dead. */
+async function getSinglePidStats(pid) {
+	return (await getPidStats([pid])).get(pid) ?? null;
+}
+//#endregion
+export { getSinglePidStats as n, resource_monitor_exports as r, getPidStats as t };
+
+//# sourceMappingURL=resource-monitor-DcQdKGYU.mjs.map

package/dist/resource-monitor-DcQdKGYU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-monitor-DcQdKGYU.mjs","names":[],"sources":["../src/process/resource-monitor.ts"],"sourcesContent":["import { execFile } from 'node:child_process'\n\n// ===========================================================================\n// Per-PID resource usage — zero dependencies, uses ps (macOS/Linux).\n//\n// These are process-management utilities used by:\n// - native-metrics-provider.ts (system metrics collection)\n// - addon-registry.service.ts (addon process stats)\n//\n// System-wide metrics (CPU, memory, disk, network, GPU, temp, PSI)\n// have moved to @camstack/addon-metrics-native via the IMetricsProvider\n// interface defined in @camstack/types.\n// ===========================================================================\n\nexport interface PidStats {\n  cpu: number      // 0–100 percentage\n  memory: number   // RSS in bytes\n}\n\nfunction execPsForPids(pids: readonly number[]): Promise<string> {\n  return new Promise((resolve, reject) => {\n    execFile('ps', ['-o', 'pid=,pcpu=,rss=', '-p', pids.join(',')], {\n      timeout: 5000,\n    }, (err, stdout) => {\n      if (err) return reject(err)\n      resolve(stdout)\n    })\n  })\n}\n\nfunction parsePsOutput(stdout: string): ReadonlyMap<number, PidStats> {\n  const result = new Map<number, PidStats>()\n  for (const line of stdout.trim().split('\\n')) {\n    const trimmed = line.trim()\n    if (!trimmed) continue\n    const parts = trimmed.split(/\\s+/)\n    if (parts.length < 3) continue\n    const pid = parseInt(parts[0]!, 10)\n    const cpu = parseFloat(parts[1]!)\n    const rssKb = parseInt(parts[2]!, 10)\n    if (isNaN(pid) || isNaN(cpu) || isNaN(rssKb)) continue\n    result.set(pid, {\n      cpu: Math.round(cpu * 10) / 10,\n      memory: rssKb * 1024, // KB → bytes\n    })\n  }\n  return result\n}\n\n/**\n * Get CPU% and memory RSS for one or more PIDs.\n * Returns a map of pid → stats. Missing/dead PIDs are silently omitted.\n */\nexport async function getPidStats(pids: number | readonly number[]): Promise<ReadonlyMap<number, PidStats>> {\n  const pidArray = typeof pids === 'number' ? [pids] : [...pids]\n  if (pidArray.length === 0) return new Map()\n\n  try {\n    const stdout = await execPsForPids(pidArray)\n    return parsePsOutput(stdout)\n  } catch {\n    return new Map()\n  }\n}\n\n/** Get CPU% and memory RSS for a single PID. Returns null if dead. */\nexport async function getSinglePidStats(pid: number): Promise<PidStats | null> {\n  const stats = await getPidStats([pid])\n  return stats.get(pid) ?? null\n}\n"],"mappings":";;;;;;;AAmBA,SAAS,cAAc,MAA0C;CAC/D,OAAO,IAAI,SAAS,SAAS,WAAW;EACtC,SAAS,MAAM;GAAC;GAAM;GAAmB;GAAM,KAAK,KAAK,IAAI;GAAC,EAAE,EAC9D,SAAS,KACV,GAAG,KAAK,WAAW;GAClB,IAAI,KAAK,OAAO,OAAO,IAAI;GAC3B,QAAQ,OAAO;IACf;GACF;;AAGJ,SAAS,cAAc,QAA+C;CACpE,MAAM,yBAAS,IAAI,KAAuB;CAC1C,KAAK,MAAM,QAAQ,OAAO,MAAM,CAAC,MAAM,KAAK,EAAE;EAC5C,MAAM,UAAU,KAAK,MAAM;EAC3B,IAAI,CAAC,SAAS;EACd,MAAM,QAAQ,QAAQ,MAAM,MAAM;EAClC,IAAI,MAAM,SAAS,GAAG;EACtB,MAAM,MAAM,SAAS,MAAM,IAAK,GAAG;EACnC,MAAM,MAAM,WAAW,MAAM,GAAI;EACjC,MAAM,QAAQ,SAAS,MAAM,IAAK,GAAG;EACrC,IAAI,MAAM,IAAI,IAAI,MAAM,IAAI,IAAI,MAAM,MAAM,EAAE;EAC9C,OAAO,IAAI,KAAK;GACd,KAAK,KAAK,MAAM,MAAM,GAAG,GAAG;GAC5B,QAAQ,QAAQ;GACjB,CAAC;;CAEJ,OAAO;;;;;;AAOT,eAAsB,YAAY,MAA0E;CAC1G,MAAM,WAAW,OAAO,SAAS,WAAW,CAAC,KAAK,GAAG,CAAC,GAAG,KAAK;CAC9D,IAAI,SAAS,WAAW,GAAG,uBAAO,IAAI,KAAK;CAE3C,IAAI;EAEF,OAAO,cAAc,MADA,cAAc,SAAS,CAChB;SACtB;EACN,uBAAO,IAAI,KAAK;;;;AAKpB,eAAsB,kBAAkB,KAAuC;CAE7E,QAAO,MADa,YAAY,CAAC,IAAI,CAAC,EACzB,IAAI,IAAI,IAAI"}