@camstack/types 0.1.2 → 0.1.3

package/dist/index.d.ts.map

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

package/dist/interfaces/addon-i18n.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Addon i18n interface -- allows addons to provide translations
+ * for their UI labels, descriptions, and config schema fields.
+ *
+ * Addons implement IAddonTranslationProvider to supply translations
+ * either as a static map or via a dynamic lookup method.
+ */
+/** A flat key-value map of translation strings for a single locale */
+export type TranslationMap = Readonly<Record<string, string>>;
+/** A complete translations bundle keyed by locale code (e.g. 'en', 'it', 'de') */
+export type TranslationBundle = Readonly<Record<string, TranslationMap>>;
+/**
+ * Provider interface for addons that supply translations.
+ *
+ * Addons can provide translations in two ways:
+ * 1. A static bundle via `getTranslationBundle()` containing all locales
+ * 2. A per-locale lookup via `getTranslations(locale)` for lazy loading
+ *
+ * At least one method must be implemented. If both are present,
+ * `getTranslations()` takes precedence for the requested locale.
+ */
+export interface IAddonTranslationProvider {
+    readonly id: string;
+    /**
+     * Return translations for a specific locale.
+     * Returns undefined if the locale is not supported.
+     */
+    getTranslations?(locale: string): TranslationMap | undefined;
+    /**
+     * Return the full translation bundle containing all supported locales.
+     * Useful when the addon ships all translations statically.
+     */
+    getTranslationBundle?(): TranslationBundle;
+}
+/**
+ * Resolve a translation key against a provider for the given locale.
+ * Falls back to 'en' if the requested locale is not available,
+ * then falls back to the key itself if no translation is found.
+ */
+export declare function resolveTranslation(provider: IAddonTranslationProvider, locale: string, key: string): string;
+//# sourceMappingURL=addon-i18n.d.ts.map

package/dist/interfaces/addon-i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addon-i18n.d.ts","sourceRoot":"","sources":["../../src/interfaces/addon-i18n.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sEAAsE;AACtE,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAE7D,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;AAExE;;;;;;;;;GASG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,eAAe,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;IAE5D;;;OAGG;IACH,oBAAoB,CAAC,IAAI,iBAAiB,CAAA;CAC3C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,yBAAyB,EACnC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,MAAM,CA4BR"}

package/dist/interfaces/addon-routes.d.ts

@@ -0,0 +1,50 @@
+import type { TokenScope } from './scoped-token.js';
+export type RouteAccess = 'public' | 'authenticated' | 'admin';
+/**
+ * Request object passed to addon route handlers.
+ */
+export interface AddonHttpRequest {
+    readonly params: Record<string, string>;
+    readonly query: Record<string, string>;
+    readonly body: unknown;
+    readonly headers: Record<string, string>;
+    /** Populated for 'authenticated' and 'admin' routes */
+    readonly user?: {
+        readonly id: string;
+        readonly username: string;
+        readonly role: string;
+    };
+    /** Populated when request uses a scoped token */
+    readonly scopedToken?: {
+        readonly id: string;
+        readonly userId: string;
+        readonly scopes: TokenScope[];
+    };
+}
+/**
+ * Reply object for addon route handlers.
+ */
+export interface AddonHttpReply {
+    status(code: number): AddonHttpReply;
+    send(data: unknown): void;
+    redirect(url: string): void;
+    header(name: string, value: string): AddonHttpReply;
+}
+/**
+ * A single HTTP route registered by an addon.
+ */
+export interface IAddonHttpRoute {
+    readonly method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    readonly path: string;
+    readonly access: RouteAccess;
+    readonly description?: string;
+    readonly handler: (request: AddonHttpRequest, reply: AddonHttpReply) => Promise<void>;
+}
+/**
+ * Provider interface for addons that expose HTTP endpoints.
+ */
+export interface IAddonRouteProvider {
+    readonly id: string;
+    getRoutes(): IAddonHttpRoute[];
+}
+//# sourceMappingURL=addon-routes.d.ts.map

package/dist/interfaces/addon-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addon-routes.d.ts","sourceRoot":"","sources":["../../src/interfaces/addon-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,eAAe,GAAG,OAAO,CAAA;AAE9D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,uDAAuD;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE;QACd,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,iDAAiD;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAA;KAC9B,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAA;IACpC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAA;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAA;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACtF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,SAAS,IAAI,eAAe,EAAE,CAAA;CAC/B"}

package/dist/interfaces/addon.d.ts

@@ -0,0 +1,294 @@
+import type { PipelineSlot } from '../types/pipeline.js';
+import type { ConfigUISchema } from './config-ui.js';
+import type { IAddonRouter } from './router.js';
+import type { INetworkProvider } from './network.js';
+import type { IScopedLogger } from './logging.js';
+import type { IEventBus } from './event-bus.js';
+import type { IStorageProvider, IStorageLocation, ISettingsBackend, IEmbeddingsBackend } from './storage.js';
+import type { CapabilityDeclaration, CapabilityProviderMap } from './capability.js';
+import type { IElementConfig } from './context.js';
+import type { ITaskHandler } from './task-handler.js';
+import type { SubProcessInfo, WorkerProcessStats } from './worker-protocol.js';
+/** Storage interface for addon file operations */
+export interface IAddonFileStorage {
+    readFile(path: string): Promise<Buffer>;
+    writeFile(path: string, data: Buffer): Promise<void>;
+    deleteFile(path: string): Promise<void>;
+    listFiles(prefix?: string): Promise<readonly string[]>;
+    exists(path: string): Promise<boolean>;
+}
+/** Storage interface for addon structured data (DB) */
+export interface IAddonStructuredStorage {
+    query(collection: string, filter?: Record<string, unknown>): Promise<readonly unknown[]>;
+    insert(collection: string, data: Record<string, unknown>): Promise<void>;
+    update(collection: string, id: string, data: Record<string, unknown>): Promise<void>;
+    delete(collection: string, id: string): Promise<void>;
+}
+/** Named file storage locations available to addons */
+export type AddonFileLocationName = 'data' | 'media' | 'recordings' | 'models' | 'cache' | 'logs';
+/** Named structured storage locations available to addons */
+export type AddonStructuredLocationName = 'data' | 'events' | 'config';
+/** Combined storage location name (union of file and structured) */
+export type AddonStorageLocationName = AddonFileLocationName | AddonStructuredLocationName;
+/** Storage access for addons -- replaces raw AddonLocationPaths */
+export interface AddonStorageLocations {
+    /** Get file storage for a named location */
+    getFiles(location: AddonFileLocationName): IAddonFileStorage;
+    /** Get structured storage (DB) for a named location */
+    getStructured(location: AddonStructuredLocationName): IAddonStructuredStorage;
+}
+export type AddonCapability = 'storage' | 'backup' | 'log-destination' | 'device-exporter' | 'network-access' | 'turn-provider' | 'webrtc-provider' | 'remote-access' | 'recording-engine' | 'notification-output' | 'streaming-engine' | 'pipeline-consumer' | 'detection-engine' | 'object-detector' | 'motion-analyzer' | 'sub-detector' | 'face-detector' | 'plate-detector' | 'recognizer' | 'face-recognizer' | 'plate-recognizer' | 'audio-classifier' | 'device-provider' | 'stream-broker' | 'analysis-data-persistence' | 'analysis-pipeline';
+export interface RequiredStep {
+    readonly slot: PipelineSlot;
+    readonly outputClasses: readonly string[];
+    readonly description: string;
+}
+export interface AddonManifest {
+    readonly id: string;
+    readonly name: string;
+    readonly version: string;
+    readonly description?: string;
+    /** Relative path to SVG icon asset within the addon package */
+    readonly icon?: string;
+    /** Brand hex color for UI display (e.g., "#3b82f6") */
+    readonly color?: string;
+    /**
+     * Whether multiple instances of this provider can be created.
+     * 'unique' — only one instance allowed (e.g., RTSP, ONVIF)
+     * 'multiple' — user can create N instances (e.g., Frigate, Scrypted)
+     * Default: 'multiple'
+     */
+    readonly instanceMode?: 'unique' | 'multiple';
+    /** Whether this addon is protected (required by the system, cannot be uninstalled) */
+    readonly protected?: boolean;
+    readonly packageName?: string;
+    readonly capabilities?: readonly (AddonCapability | {
+        name: string;
+        mode: string;
+    })[];
+    readonly requiredFeatures?: readonly string[];
+    readonly slot?: PipelineSlot;
+    readonly inputClasses?: readonly string[];
+    readonly outputClasses?: readonly string[];
+    readonly requiredSteps?: readonly RequiredStep[];
+    readonly supportsCustomModels?: boolean;
+    readonly mayRequirePython?: boolean;
+    readonly defaultConfig?: Readonly<Record<string, unknown>>;
+    /** Whether this addon performs active inference with models.
+     *  Passive addons (e.g. motion-detection) set this to false
+     *  and are excluded from the inference pipeline schema. Default: true. */
+    readonly passive?: boolean;
+    /**
+     * Label output type — declares what kind of label this addon produces
+     * when used as a classifier/recognizer in the pipeline.
+     * Used to tag LabelData.origin so the UI can render labels appropriately.
+     */
+    readonly labelOutputType?: import('../types/detection.js').LabelOrigin;
+}
+/** @deprecated Use IStorageProvider.resolve() instead of raw paths */
+export interface AddonLocationPaths {
+    readonly data: string;
+    readonly media: string;
+    readonly recordings: string;
+    readonly models: string;
+    readonly logs: string;
+    readonly cache: string;
+}
+/**
+ * Minimal model-management API exposed to addons via AddonContext.
+ */
+export interface IAddonModelManager {
+    /** Ensure a model is downloaded. Returns the local file path. */
+    ensure(modelId: string, format?: import('../types/models.js').ModelFormat): Promise<string>;
+    /** Ensure extra files for a model are downloaded. Returns paths. */
+    ensureExtraFiles(modelId: string): Promise<readonly string[]>;
+    /** Absolute path to the shared models directory. */
+    getModelsDir(): string;
+    /** Check if a model is already downloaded. */
+    isDownloaded(modelId: string, format?: import('../types/models.js').ModelFormat): boolean;
+    /** @deprecated Use ensure() instead. Legacy API kept for backward compatibility. */
+    downloadModel(id: string): Promise<string>;
+}
+/** Process management for addon sub-processes (ffmpeg, python, etc.) */
+export interface IAddonProcessManager {
+    /** Spawn a child process managed by this addon's worker */
+    spawn(config: SubProcessConfig): Promise<IManagedSubProcess>;
+    /** List all sub-processes spawned by this addon */
+    listProcesses(): readonly SubProcessInfo[];
+    /** Get worker stats (this addon's worker process) */
+    getWorkerStats(): WorkerProcessStats;
+}
+export interface SubProcessConfig {
+    readonly name: string;
+    readonly command: string;
+    readonly args?: readonly string[];
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string>>;
+    readonly autoRestart?: boolean;
+    readonly maxRestarts?: number;
+}
+export interface IManagedSubProcess {
+    readonly pid: number;
+    readonly name: string;
+    getStats(): WorkerProcessStats;
+    write(data: Buffer): void;
+    readonly stdout: AsyncIterable<Buffer>;
+    readonly stderr: AsyncIterable<Buffer>;
+    kill(signal?: NodeJS.Signals): void;
+    wait(): Promise<{
+        code: number | null;
+        signal: string | null;
+    }>;
+    onExit(handler: (code: number | null) => void): void;
+    onError(handler: (error: Error) => void): void;
+}
+/** Dependency manager — ensures binaries/tools are available for addons */
+export interface IAddonDepsManager {
+    /** Ensure a named binary is available (check local -> PATH -> download) */
+    ensureBinary(opts: {
+        readonly name: string;
+        readonly downloadUrl: string;
+        readonly isArchive?: boolean;
+        readonly archiveFormat?: 'zip' | 'tar.gz' | 'tar.xz';
+        readonly archiveInnerPath?: string;
+    }): Promise<string>;
+    /** Ensure ffmpeg is available */
+    ensureFfmpeg(): Promise<string>;
+    /** Ensure Python is available, returns path or null if unavailable */
+    ensurePython(): Promise<string | null>;
+    /** Install Python packages in the managed Python environment */
+    installPythonPackages(packages: readonly string[]): Promise<void>;
+    /** Get the deps directory path */
+    getDepsDir(): string;
+}
+/**
+ * AddonContext -- injected into every addon at initialize().
+ *
+ * The context includes both the CamstackContext fields (id, logger, eventBus, storage, config)
+ * and addon-specific extras (addonConfig, models, locationPaths, router, network).
+ */
+/**
+ * AddonContext -- injected into every addon at initialize().
+ *
+ * The `api` field is typed as `AddonApi` — a generated interface that
+ * mirrors the server's tRPC router namespaces. This gives addons type-safe
+ * access to server procedures without depending on the server package.
+ *
+ * To regenerate after changing routers: npx tsx scripts/generate-api-types.ts
+ */
+export interface AddonContext {
+    /** Immutable progressive ID */
+    readonly id: string;
+    /** Pre-scoped logger */
+    readonly logger: IScopedLogger;
+    /** System event bus */
+    readonly eventBus: IEventBus;
+    /** Scoped storage location (legacy — use storageProvider instead) */
+    readonly storage: IStorageLocation;
+    /** Persisted config store */
+    readonly config: IElementConfig;
+    /** Bootstrap configuration from server settings (read-only) */
+    readonly addonConfig: Readonly<Record<string, unknown>>;
+    /** Model management -- download default models or retrieve cached paths. */
+    models?: IAddonModelManager;
+    /** @deprecated Use storageProvider.resolve() instead */
+    readonly locationPaths: AddonLocationPaths;
+    /** File storage provider — resolve paths, read/write files per location type */
+    readonly storageProvider?: IStorageProvider;
+    /** Settings backend — query/insert structured data (events, settings, metadata) */
+    readonly settingsBackend?: ISettingsBackend;
+    /** Embeddings backend — vector storage for similarity search */
+    readonly embeddingsBackend?: IEmbeddingsBackend;
+    /**
+     * Private data directory for this addon.
+     * Resolved via storageProvider.resolve('addons-data', '{addonId}/').
+     * The addon owns this directory exclusively.
+     */
+    readonly dataDir: string;
+    /** HTTP router for registering addon routes */
+    readonly router?: IAddonRouter;
+    /** Network access provider */
+    readonly network?: INetworkProvider;
+    /**
+     * Register a task handler that can be dispatched by the hub.
+     * Only effective in agent mode — in hub mode, handlers are stored but not dispatched.
+     */
+    registerTaskHandler?(handler: ITaskHandler): void;
+    /** Process management — spawn and monitor sub-processes */
+    readonly process?: IAddonProcessManager;
+    /** Dependency management — ensure binary/tool availability */
+    readonly deps?: IAddonDepsManager;
+    /**
+     * Full tRPC client — same API as the frontend.
+     * Transport is transparent: direct caller (in-process), WSS (worker), or WSS (remote agent).
+     * Use this for all server interactions: storage, events, devices, streaming, etc.
+     */
+    readonly api?: import('../generated/addon-api.js').AddonApi;
+}
+export interface ICamstackAddon {
+    readonly id?: string;
+    readonly manifest: AddonManifest;
+    initialize(context: AddonContext): Promise<void>;
+    shutdown(): Promise<void>;
+    getConfigSchema?(): ConfigUISchema;
+    /**
+     * Return the provider instance for a declared capability.
+     * Called by CapabilityRegistry after initialize() succeeds.
+     * Returns null if this addon does not provide the requested capability.
+     */
+    getCapabilityProvider?<K extends keyof CapabilityProviderMap>(name: K): CapabilityProviderMap[K] | null;
+}
+/** Declaration of a UI page provided by an addon */
+export interface AddonPageDeclaration {
+    /** Unique page ID (scoped to addon) */
+    readonly id: string;
+    /** Display label for sidebar */
+    readonly label: string;
+    /** Lucide icon name for sidebar */
+    readonly icon: string;
+    /** Route path (e.g., '/benchmark') */
+    readonly path: string;
+    /** Relative path to JS bundle within addon package (default export = React component) */
+    readonly bundle: string;
+    /** @deprecated Web component element name — addon pages now export React components */
+    readonly element?: string;
+}
+/** Provider interface for addons that expose UI pages */
+export interface IAddonPageProvider {
+    readonly id: string;
+    getPages(): readonly AddonPageDeclaration[];
+}
+/** Provider interface for the admin UI shell (singleton capability) */
+export interface IAdminUI {
+    getStaticDir(): string;
+    getVersion(): string;
+}
+export interface AddonDeclaration {
+    readonly id: string;
+    readonly entry: string;
+    readonly slot: PipelineSlot;
+    /** Relative path to SVG icon asset within the addon package */
+    readonly icon?: string;
+    /** Brand hex color for UI display */
+    readonly color?: string;
+    /** Instance mode: 'unique' or 'multiple'. Default: 'multiple' */
+    readonly instanceMode?: 'unique' | 'multiple';
+    /** @deprecated Use inProcess instead. Legacy opt-in flag for forking. */
+    readonly forkable?: boolean;
+    /**
+     * Force this addon to stay in-process (no forking).
+     * Default: false — all non-infra addons are forked by default.
+     * Use CAMSTACK_FORCE_INPROCESS=true env var for emergency global fallback.
+     */
+    readonly inProcess?: boolean;
+    /** Capabilities this addon provides. Declared in package.json camstack.addons[].capabilities */
+    readonly capabilities?: readonly CapabilityDeclaration[];
+    /** UI pages provided by this addon */
+    readonly pages?: readonly AddonPageDeclaration[];
+}
+export interface AddonPackageManifest {
+    /** Human-readable package name for UI display (e.g., "CamStack Vision") */
+    readonly displayName?: string;
+    readonly addons: readonly AddonDeclaration[];
+}
+//# sourceMappingURL=addon.d.ts.map

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

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

package/dist/interfaces/advanced-notifier.d.ts

@@ -0,0 +1,59 @@
+export interface NotificationRule {
+    readonly id: string;
+    readonly name: string;
+    readonly enabled: boolean;
+    readonly eventTypes: readonly string[];
+    readonly conditions: {
+        readonly deviceIds?: readonly string[];
+        readonly classNames?: readonly string[];
+        readonly zoneIds?: readonly string[];
+        readonly minConfidence?: number;
+        readonly source?: 'pipeline' | 'onboard' | 'any';
+        readonly schedule?: {
+            readonly days: readonly number[];
+            readonly startHour: number;
+            readonly endHour: number;
+        };
+        readonly cooldownSeconds?: number;
+        readonly minDwellSeconds?: number;
+    };
+    readonly outputs: readonly string[];
+    readonly template?: {
+        readonly title: string;
+        readonly body: string;
+        readonly imageMode: 'crop' | 'annotated' | 'full' | 'none';
+    };
+    readonly priority: 'low' | 'normal' | 'high' | 'critical';
+}
+export interface NotificationTestResult {
+    readonly ruleId: string;
+    readonly eventId: string;
+    readonly timestamp: number;
+    readonly wouldFire: boolean;
+    readonly reason?: string;
+}
+export interface NotificationHistoryFilter {
+    readonly ruleId?: string;
+    readonly deviceId?: string;
+    readonly from?: number;
+    readonly to?: number;
+    readonly limit?: number;
+}
+export interface NotificationHistoryEntry {
+    readonly id: string;
+    readonly ruleId: string;
+    readonly ruleName: string;
+    readonly eventId: string;
+    readonly timestamp: number;
+    readonly outputs: readonly string[];
+    readonly success: boolean;
+    readonly error?: string;
+}
+export interface IAdvancedNotifier {
+    getRules(): readonly NotificationRule[];
+    upsertRule(rule: NotificationRule): void;
+    deleteRule(ruleId: string): void;
+    testRule(ruleId: string, lookbackMinutes: number): Promise<NotificationTestResult[]>;
+    getHistory(filter?: NotificationHistoryFilter): Promise<NotificationHistoryEntry[]>;
+}
+//# sourceMappingURL=advanced-notifier.d.ts.map

package/dist/interfaces/advanced-notifier.d.ts.map

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

package/dist/interfaces/agent-protocol.d.ts

@@ -0,0 +1,189 @@
+import type { TaskProgress } from './task-handler.js';
+export type AgentCapability = 'decoder' | 'transcoder' | 'detector' | 'recorder';
+export type RolePriority = 'primary' | 'backup' | 'overflow';
+export interface CameraRoleAssignment {
+    cameraId: string;
+    role: AgentCapability;
+    agentId: string;
+    priority: RolePriority;
+    rtspUrl?: string;
+    detectionConfig?: {
+        modelId: string;
+        runtime: string;
+        confidence: number;
+        fps: number;
+        classes?: string[];
+    };
+}
+export type HubToAgentMessage = {
+    type: 'assign';
+    assignment: CameraRoleAssignment;
+} | {
+    type: 'unassign';
+    cameraId: string;
+    role: AgentCapability;
+} | {
+    type: 'recording.start';
+    cameraId: string;
+    rtspUrl: string;
+} | {
+    type: 'recording.stop';
+    cameraId: string;
+} | {
+    type: 'benchmark.run';
+    config: RemoteBenchmarkConfig;
+} | {
+    type: 'config.update';
+    addonId: string;
+    config: Record<string, unknown>;
+} | {
+    type: 'task.execute';
+    taskId: string;
+    taskType: string;
+    payload: unknown;
+} | {
+    type: 'task.cancel';
+    taskId: string;
+} | {
+    type: 'addon.install';
+    package: string;
+    version?: string;
+} | {
+    type: 'addon.uninstall';
+    package: string;
+} | {
+    type: 'addon.update';
+    package: string;
+    version?: string;
+} | {
+    type: 'addon.restart';
+} | {
+    type: 'ping';
+};
+export type AgentToHubMessage = {
+    type: 'register';
+    info: AgentRegistrationInfo;
+} | {
+    type: 'heartbeat';
+    status: AgentRuntimeStatus;
+} | {
+    type: 'detection.result';
+    cameraId: string;
+    detections: DetectionResult[];
+    timestamp: number;
+    inferenceMs: number;
+} | {
+    type: 'recording.segment';
+    cameraId: string;
+    segment: RecordingSegmentInfo;
+} | {
+    type: 'recording.status';
+    cameraId: string;
+    recording: boolean;
+} | {
+    type: 'benchmark.progress';
+    event: BenchmarkStreamEvent;
+} | {
+    type: 'benchmark.result';
+    report: BenchmarkReport;
+} | {
+    type: 'task.result';
+    taskId: string;
+    success: boolean;
+    result?: unknown;
+    error?: string;
+} | {
+    type: 'task.progress';
+    taskId: string;
+    progress: TaskProgress;
+} | {
+    type: 'addon.install-result';
+    package: string;
+    success: boolean;
+    version?: string;
+    error?: string;
+} | {
+    type: 'addon.uninstall-result';
+    package: string;
+    success: boolean;
+    error?: string;
+} | {
+    type: 'addon.update-result';
+    package: string;
+    success: boolean;
+    version?: string;
+    error?: string;
+} | {
+    type: 'log';
+    level: string;
+    scope: string;
+    message: string;
+} | {
+    type: 'pong';
+};
+export declare const BINARY_FRAME_HEADER_SIZE = 29;
+export declare const BINARY_FRAME_TYPE = 1;
+export interface AgentRegistrationInfo {
+    id: string;
+    name: string;
+    capabilities: AgentCapability[];
+    host: string;
+    port: number;
+    platform: string;
+    arch: string;
+    cpuCores: number;
+    memoryMB: number;
+    gpuModel?: string;
+    pythonRuntimes: string[];
+    httpPort: number;
+    /** Task types this agent can handle (e.g., 'pipeline.decode', 'system.info') */
+    taskTypes?: string[];
+    /** Installed addons on this agent */
+    installedAddons?: string[];
+}
+export interface AgentRuntimeStatus {
+    activeCameras: number;
+    cpuPercent: number;
+    memoryPercent: number;
+    fps: Record<string, number>;
+    errors: string[];
+}
+export interface DetectionResult {
+    className: string;
+    score: number;
+    bbox: [number, number, number, number];
+}
+export interface RecordingSegmentInfo {
+    id: string;
+    startTime: number;
+    endTime: number;
+    duration: number;
+    sizeBytes: number;
+    path: string;
+    format: 'mp4' | 'ts';
+}
+export interface RemoteBenchmarkConfig {
+    runtime: string;
+    modelId?: string;
+    durationMs: number;
+    warmupMs: number;
+    inputWidth: number;
+    inputHeight: number;
+}
+export interface BenchmarkStreamEvent {
+    phase: 'warmup' | 'running';
+    iteration: number;
+    inferenceMs: number;
+}
+export interface BenchmarkReport {
+    runtime: string;
+    modelId?: string;
+    iterations: number;
+    meanMs: number;
+    p50Ms: number;
+    p95Ms: number;
+    p99Ms: number;
+    minMs: number;
+    maxMs: number;
+}
+//# sourceMappingURL=agent-protocol.d.ts.map