@camstack/types 0.1.13 → 0.1.15

package/dist/addon/base-addon.d.ts

@@ -0,0 +1,262 @@
+import type { AddonContext, AddonInitResult, CapabilitiesAccess, ProviderRegistration } from '../interfaces/addon.js';
+import type { ConfigUISchema, ConfigUISchemaWithValues, ConfigField, ConfigSection } from '../interfaces/config-ui.js';
+export type { CapabilitiesAccess };
+/**
+ * Utility type that constrains a ConfigField's `key` to only accept
+ * keys of TConfig. Usage inside schema builders:
+ *
+ * ```ts
+ * protected globalSettingsSchema() {
+ *   return this.schema({
+ *     sections: [{
+ *       id: 'main',
+ *       title: 'Settings',
+ *       fields: [
+ *         this.field({ type: 'number', key: 'maxRetries', label: 'Max Retries' }),
+ *         //                                ^^^^^^^^^^^ — autocomplete + compile error if wrong
+ *       ],
+ *     }],
+ *   })
+ * }
+ * ```
+ */
+type TypedConfigField<TConfig extends object> = ConfigField extends infer F ? F extends {
+    readonly key: string;
+} ? Omit<F, 'key'> & {
+    readonly key: keyof TConfig & string;
+} : F : never;
+/**
+ * A ConfigSection whose fields are key-constrained to TConfig.
+ */
+interface TypedConfigSection<TConfig extends object> extends Omit<ConfigSection, 'fields'> {
+    readonly fields: ReadonlyArray<TypedConfigField<TConfig> | ConfigField>;
+}
+/**
+ * A ConfigUISchema whose sections use typed fields.
+ */
+interface TypedConfigUISchema<TConfig extends object> extends Omit<ConfigUISchema, 'sections'> {
+    readonly sections: ReadonlyArray<TypedConfigSection<TConfig>>;
+}
+/**
+ * Base class for CamStack addons. Eliminates settings boilerplate:
+ *
+ * - Typed `config` property with automatic resolution from store + defaults
+ * - `getGlobalSettings()` / `updateGlobalSettings()` auto-implemented
+ * - `getAddonSettings()` / `updateAddonSettings()` auto-implemented
+ * - `getDeviceSettings()` / `updateDeviceSettings()` auto-implemented
+ * - `ctx` accessor for the AddonContext (no manual `this.ctxRef` storage)
+ * - `field()` helper that constrains field keys to TConfig keys
+ * - `schema()` helper that validates the full schema structure
+ *
+ * Subclasses override:
+ * - `onInitialize()` — addon-specific init logic, return ProviderRegistration[]
+ * - `onShutdown()` — cleanup
+ * - `globalSettingsSchema()` / `deviceSettingsSchema()` — UI schemas
+ *
+ * @example
+ * ```ts
+ * interface MyConfig {
+ *   maxRetries: number
+ *   endpoint: string
+ * }
+ *
+ * export default class MyAddon extends BaseAddon<MyConfig> {
+ *   constructor() {
+ *     super({ maxRetries: 3, endpoint: 'http://localhost' })
+ *   }
+ *
+ *   protected globalSettingsSchema() {
+ *     return this.schema({
+ *       sections: [{
+ *         id: 'main', title: 'Settings',
+ *         fields: [
+ *           this.field({ type: 'number', key: 'maxRetries', label: 'Max Retries', default: 3 }),
+ *           this.field({ type: 'text', key: 'endpoint', label: 'Endpoint' }),
+ *         ],
+ *       }],
+ *     })
+ *   }
+ *
+ *   protected async onInitialize(): Promise<ProviderRegistration[]> {
+ *     const client = new Client(this.config.endpoint, this.config.maxRetries)
+ *     return [{ capability: 'my-feature', provider: client }]
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class BaseAddon<TConfig extends object = Record<string, unknown>> {
+    private _ctx;
+    private _config;
+    /**
+     * Per-process random id used as the `generation` stamp on every
+     * `system.ready-state` event this addon emits. Constant for the
+     * lifetime of this addon instance (== one process boot); consumer-
+     * side registries derive a monotonic `epoch` by watching for
+     * generation transitions.
+     */
+    private readonly _readinessGeneration;
+    /** Capability names this addon registered at init — used to emit matching `down` events on shutdown. */
+    private _registeredCapNames;
+    /** Default config values. Provided via constructor. */
+    protected readonly defaults: TConfig;
+    constructor(defaults: TConfig);
+    /**
+     * Override to opt out of the automatic `system.ready-state` emission.
+     * Returns `true` by default — addons that don't map cleanly to the
+     * readiness protocol (e.g. pure collection providers whose readiness
+     * is already reported per-device by upstream) can override to `false`
+     * and emit manually.
+     */
+    protected get autoEmitReadiness(): boolean;
+    /** The AddonContext, available after initialize(). */
+    get ctx(): AddonContext;
+    /**
+     * Non-throwing ctx accessor for code paths that can legitimately run
+     * before `initialize()` has resolved — most commonly cap handlers the
+     * hub invokes eagerly at page load (device-details aggregator pings
+     * every addon's `getDeviceSettingsContribution` as soon as the page
+     * mounts). Prefer `ctx` for the normal case; reach for this only in
+     * capability methods that may be queried before the addon is wired up.
+     */
+    protected get ctxIfReady(): AddonContext | null;
+    /** Current resolved config (defaults merged with persisted store values). */
+    get config(): Readonly<TConfig>;
+    initialize(context: AddonContext): Promise<AddonInitResult | void>;
+    /**
+     * Called by the isolated-process runner AFTER `broker.start()`.
+     * In-process addons never need this because the hub broker is already
+     * running when `initialize()` fires. For forked children the broker
+     * starts AFTER `initialize()`, so the readiness emit inside initialize()
+     * fires before the broker can broadcast it. This method re-emits the
+     * ready state once the transport is live.
+     */
+    postBrokerStart(): void;
+    /**
+     * Called by the isolated-process runner / agent bootstrap once the broker
+     * has started AND the hub node is connected — the moment `ctx.api.*` calls
+     * to hub-provided capabilities become safe. Wrap any bootstrap work that
+     * must query the hub (device restore, settings fetch, initial sync) in
+     * `onHubConnected()` rather than `onInitialize()` — during `initialize()`
+     * on a worker the broker is not yet connected and remote cap calls either
+     * time out or throw "Service not found".
+     *
+     * Default implementation is a no-op. Override in subclasses that need it.
+     * Never fires on hub-local in-process addons (the hub is its own node).
+     */
+    onHubReachable(): Promise<void>;
+    shutdown(): Promise<void>;
+    /**
+     * Addon-specific initialization. Called after config is resolved.
+     *
+     * Subclasses may return:
+     * - an array of `ProviderRegistration` (back-compat, most common),
+     * - an `AddonInitResult` envelope to also declare `customActions`,
+     * - `void` for pure consumers.
+     */
+    protected abstract onInitialize(): Promise<ProviderRegistration[] | AddonInitResult | void>;
+    /** Addon-specific cleanup. Override if needed. */
+    protected onShutdown(): Promise<void>;
+    /**
+     * Called after config is resolved during updateGlobalSettings/updateAddonSettings.
+     * Override to react to config changes (e.g. restart a sampler, reconnect a service).
+     * Not called during initialize() — use onInitialize() for initial setup.
+     */
+    protected onConfigChanged(): Promise<void>;
+    /**
+     * Create a ConfigField with `key` constrained to keys of TConfig.
+     * Provides autocomplete and compile-time validation.
+     */
+    protected field<F extends ConfigField>(field: F extends {
+        readonly key: string;
+    } ? Omit<F, 'key'> & {
+        readonly key: keyof TConfig & string;
+    } : F): ConfigField;
+    /**
+     * Create a full ConfigUISchema with typed sections.
+     * Fields created via `this.field()` get key validation automatically.
+     */
+    protected schema(schema: TypedConfigUISchema<TConfig>): ConfigUISchema;
+    /** Override to provide global-level settings UI schema. */
+    protected globalSettingsSchema(): ConfigUISchema | null;
+    /** Override to provide device-level settings UI schema. */
+    protected deviceSettingsSchema(): ConfigUISchema | null;
+    getGlobalSettings(overlay?: Record<string, unknown>): Promise<ConfigUISchemaWithValues>;
+    updateGlobalSettings(patch: Partial<TConfig>): Promise<void>;
+    /**
+     * If any field in `patch` is marked `requiresRestart` in `schema`,
+     * schedule an addon restart for the next tick. Deferred via
+     * `setImmediate` so the tRPC mutation that triggered the write has
+     * time to return its response before the addon is torn down and
+     * re-initialised by `AddonRegistryService.restartAddon`.
+     */
+    private maybeAutoRestart;
+    getDeviceSettings(deviceId: number): Promise<ConfigUISchemaWithValues>;
+    updateDeviceSettings(deviceId: number, patch: Record<string, unknown>): Promise<void>;
+    private _subscriptions;
+    /**
+     * Subscribe to an event bus category. The subscription is automatically
+     * unsubscribed on shutdown — no manual cleanup needed.
+     *
+     * @example
+     * ```ts
+     * this.subscribe({ category: EventCategory.DeviceRegistered }, (event) => {
+     *   void this.handleDevice(event)
+     * })
+     * ```
+     */
+    /**
+     * Subscribe to `system.ready-state` events for one or more capabilities.
+     * Abstracts the boilerplate type-narrowing + nodeId extraction that every
+     * resilience subscription duplicates. Cleanup is automatic (registered on
+     * `_subscriptions` like a normal `subscribe` call).
+     */
+    protected watchCapability(capNames: string | readonly string[], handlers: {
+        readonly onDown?: (nodeId: string, capName: string) => void;
+        readonly onReady?: (nodeId: string, capName: string) => void;
+    }): void;
+    protected subscribe<C extends import('../interfaces/event-bus.js').KnownEventCategory>(filter: import('../interfaces/event-bus.js').TypedEventFilter<C>, handler: (event: import('../interfaces/event-bus.js').TypedSystemEvent<C>) => void): void;
+    protected subscribe(filter: import('../interfaces/event-bus.js').EventFilter, handler: (event: import('../interfaces/event-bus.js').SystemEvent) => void): void;
+    private emitLifecycle;
+    /**
+     * Emit a `system.ready-state` event for every capability this addon
+     * registered at init. Scope is `{type:'node', nodeId}` — readiness is
+     * tied to the node that hosts the provider. Consumers that care about
+     * per-device readiness can subscribe with `{type:'device', ...}` if
+     * the provider emits at finer granularity (collection addons may
+     * opt-out via `autoEmitReadiness` and emit manually).
+     */
+    private emitReadinessForProviders;
+    /**
+     * Resolve the shared models directory path via the storage capability.
+     * Falls back to `camstack-data/models` if storage is unavailable.
+     * Used by inference addons (detection-pipeline, audio-classifier, embedding-encoder).
+     */
+    protected resolveModelsDir(): Promise<string>;
+    /**
+     * Access the runtime capability registry for in-process provider lookups.
+     * Returns null if the registry is not available (e.g. on agents).
+     * Used by addons that consume other capabilities directly (snapshot, stream-broker, enrichment).
+     */
+    protected get capabilities(): CapabilitiesAccess | null;
+    /**
+     * Resolve config by merging defaults with persisted store values.
+     * Called automatically during initialize() and after every updateSettings().
+     *
+     * The merge is shallow: each key in `defaults` is checked against the store.
+     * Only keys present in defaults are read — the store can contain extra keys
+     * (e.g. from older versions) without polluting the typed config.
+     */
+    protected resolveConfig(): Promise<void>;
+}
+/**
+ * Normalize an `ICamstackAddon.initialize()` return value into the
+ * `AddonInitResult` envelope. Arrays are wrapped into `{ providers }`;
+ * envelopes pass through; void stays void.
+ *
+ * Exported so the kernel boot path and the backend addon registry can
+ * share the same normalizer instead of duplicating the shim. Addons that
+ * extend `BaseAddon` already emit the envelope, so this helper is only a
+ * safety net for direct `ICamstackAddon` implementations (mostly tests).
+ */
+export declare function normalizeAddonInitResult(result: ProviderRegistration[] | AddonInitResult | void): AddonInitResult | void;
+//# sourceMappingURL=base-addon.d.ts.map

package/dist/addon/base-addon.d.ts.map

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

package/dist/capabilities/accessories.cap.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+import { DeviceType } from '../device/device-type.js';
+/**
+ * List of accessory children linked to a parent device (camera, hub).
+ * Returns only numeric device ids — the rest (role, deviceType, name,
+ * caps) is derived by fetching each child via `device-manager.getDevice`.
+ *
+ * The single-source-of-truth for what an accessory IS remains the child
+ * device itself; this cap only surfaces the grouping.
+ */
+export declare const AccessoriesStatusSchema: z.ZodObject<{
+    childDeviceIds: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strip>;
+export type AccessoriesStatus = z.infer<typeof AccessoriesStatusSchema>;
+export declare const accessoriesCapability: {
+    readonly name: "accessories";
+    readonly scope: "device";
+    readonly mode: "singleton";
+    readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Hub];
+    readonly methods: {};
+    readonly events: {
+        /**
+         * Emitted when a child device is created, removed, or its parent
+         * assignment changes. Payload carries the fresh list.
+         */
+        readonly onAccessoriesChanged: {
+            readonly data: z.ZodObject<{
+                deviceId: z.ZodNumber;
+                childDeviceIds: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+            }, z.core.$strip>;
+        };
+    };
+    readonly status: {
+        readonly schema: z.ZodObject<{
+            childDeviceIds: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+        }, z.core.$strip>;
+        readonly kind: "command-driven";
+    };
+};
+export type IAccessoriesProvider = InferProvider<typeof accessoriesCapability>;
+//# sourceMappingURL=accessories.cap.d.ts.map

package/dist/capabilities/accessories.cap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessories.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/accessories.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;iBAElC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,qBAAqB;;;;;;;QAO9B;;;WAGG;;;;;;;;;;;;;;CAUkC,CAAA;AAEzC,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC,OAAO,qBAAqB,CAAC,CAAA"}

package/dist/capabilities/addon-pages-source.cap.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+/**
+ * `addon-pages-source` — collection cap exposing per-provider raw page
+ * declarations. Every addon that contributes a UI page registers a
+ * provider here. The hub-side singleton aggregator (`addon-pages` cap,
+ * see `addon-pages.cap.ts`) walks this collection, stamps versioned
+ * `bundleUrl` values, and returns the enriched `AddonPageInfo[]` list
+ * that admin-ui consumes.
+ *
+ * The split exists because the public listing has a different output
+ * shape than the per-provider raw declarations, and we want both ends
+ * to flow through codegen instead of relying on a hand-written wrapper.
+ */
+declare const AddonPageDeclarationSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    icon: z.ZodString;
+    path: z.ZodString;
+    remoteName: z.ZodString;
+    bundle: z.ZodString;
+}, z.core.$strip>;
+export declare const addonPagesSourceCapability: {
+    readonly name: "addon-pages-source";
+    readonly scope: "system";
+    readonly mode: "collection";
+    readonly internal: true;
+    readonly methods: {
+        readonly listPages: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            icon: z.ZodString;
+            path: z.ZodString;
+            remoteName: z.ZodString;
+            bundle: z.ZodString;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+    };
+};
+export type IAddonPagesSourceProvider = InferProvider<typeof addonPagesSourceCapability>;
+export { AddonPageDeclarationSchema };
+//# sourceMappingURL=addon-pages-source.cap.d.ts.map

package/dist/capabilities/addon-pages-source.cap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addon-pages-source.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/addon-pages-source.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAElG;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,0BAA0B;;;;;;;iBAqB9B,CAAA;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;CAQE,CAAA;AAEzC,MAAM,MAAM,yBAAyB,GAAG,aAAa,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAExF,OAAO,EAAE,0BAA0B,EAAE,CAAA"}

package/dist/capabilities/addon-pages.cap.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+declare const AddonPageInfoSchema: z.ZodObject<{
+    addonId: z.ZodString;
+    page: z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        icon: z.ZodString;
+        path: z.ZodString;
+        remoteName: z.ZodString;
+        bundle: z.ZodString;
+    }, z.core.$strip>;
+    bundleUrl: z.ZodString;
+}, z.core.$strip>;
+export declare const addonPagesCapability: {
+    readonly name: "addon-pages";
+    readonly scope: "system";
+    readonly mode: "singleton";
+    readonly methods: {
+        readonly listPages: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            addonId: z.ZodString;
+            page: z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                icon: z.ZodString;
+                path: z.ZodString;
+                remoteName: z.ZodString;
+                bundle: z.ZodString;
+            }, z.core.$strip>;
+            bundleUrl: z.ZodString;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+    };
+};
+export type IAddonPagesAggregatorProvider = InferProvider<typeof addonPagesCapability>;
+export { AddonPageInfoSchema };
+//# sourceMappingURL=addon-pages.cap.d.ts.map

package/dist/capabilities/addon-pages.cap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addon-pages.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/addon-pages.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AA4BlG,QAAA,MAAM,mBAAmB;;;;;;;;;;;iBAIvB,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;CAOQ,CAAA;AAEzC,MAAM,MAAM,6BAA6B,GAAG,aAAa,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEtF,OAAO,EAAE,mBAAmB,EAAE,CAAA"}

package/dist/capabilities/addon-routes.cap.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+export declare const addonRoutesCapability: {
+    readonly name: "addon-routes";
+    readonly scope: "system";
+    readonly mode: "collection";
+    readonly internal: true;
+    readonly methods: {
+        readonly getRoutes: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodArray<z.ZodObject<{
+            method: z.ZodEnum<{
+                GET: "GET";
+                POST: "POST";
+                PUT: "PUT";
+                DELETE: "DELETE";
+                PATCH: "PATCH";
+            }>;
+            path: z.ZodString;
+        }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
+    };
+};
+export type IAddonRoutesProvider = InferProvider<typeof addonRoutesCapability>;
+//# sourceMappingURL=addon-routes.cap.d.ts.map

package/dist/capabilities/addon-routes.cap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addon-routes.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/addon-routes.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAOlG,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;CAQO,CAAA;AAEzC,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC,OAAO,qBAAqB,CAAC,CAAA"}

package/dist/capabilities/addon-settings.cap.d.ts

@@ -0,0 +1,170 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+declare const ConfigTabDeclarationSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    icon: z.ZodString;
+    order: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const ConfigSectionWithValuesSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    style: z.ZodOptional<z.ZodEnum<{
+        card: "card";
+        accordion: "accordion";
+    }>>;
+    defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+    tab: z.ZodOptional<z.ZodString>;
+    location: z.ZodOptional<z.ZodEnum<{
+        settings: "settings";
+        "top-tab": "top-tab";
+    }>>;
+    order: z.ZodOptional<z.ZodNumber>;
+    fields: z.ZodArray<z.ZodAny>;
+}, z.core.$strip>;
+declare const SettingsSchemaWithValuesSchema: z.ZodObject<{
+    tabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        icon: z.ZodString;
+        order: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    sections: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        style: z.ZodOptional<z.ZodEnum<{
+            card: "card";
+            accordion: "accordion";
+        }>>;
+        defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+        columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+        tab: z.ZodOptional<z.ZodString>;
+        location: z.ZodOptional<z.ZodEnum<{
+            settings: "settings";
+            "top-tab": "top-tab";
+        }>>;
+        order: z.ZodOptional<z.ZodNumber>;
+        fields: z.ZodArray<z.ZodAny>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Patch object — keys are field names, values are the new field values. */
+declare const SettingsPatchSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/** Standard success response for update operations. */
+declare const SettingsUpdateResultSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+}, z.core.$strip>;
+/**
+ * addon-settings — singleton gateway for three-level addon settings.
+ *
+ * Works like `device-manager`: a single hub-side provider that resolves
+ * `addonId` to the target addon and delegates the call. For hub-local
+ * addons the call is direct; for remote agents it proxies via the
+ * per-addon Moleculer service.
+ *
+ * Replaces the `$addonHost` Moleculer service. Transport transparency
+ * is handled by the provider implementation — callers (admin UI, other
+ * addons via `ctx.api`) never know which node hosts the target addon.
+ *
+ * Three levels:
+ *   - **addon**: addon-scoped settings (installation config, API keys, …)
+ *   - **global**: settings applied to all devices by default
+ *   - **device**: per-device overrides
+ *
+ * Optional `nodeId` allows explicit node targeting. When absent the
+ * provider resolves the addon's host node automatically.
+ */
+/**
+ * `addon-settings` is a **hub-centric** cap: the hub hosts the single
+ * provider, and `nodeId` in the input is data for the hub provider's
+ * internal dispatcher, not a routing hint for the cap-router. See
+ * `CapabilityDefinition.nodeIdMode` for the contract.
+ */
+export declare const addonSettingsCapability: {
+    readonly name: "addon-settings";
+    readonly scope: "system";
+    readonly mode: "singleton";
+    readonly nodeIdMode: "data";
+    readonly methods: {
+        readonly getGlobalSettings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            addonId: z.ZodString;
+            nodeId: z.ZodOptional<z.ZodString>;
+            overlay: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
+            tabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                icon: z.ZodString;
+                order: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            sections: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodEnum<{
+                    card: "card";
+                    accordion: "accordion";
+                }>>;
+                defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+                columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+                tab: z.ZodOptional<z.ZodString>;
+                location: z.ZodOptional<z.ZodEnum<{
+                    settings: "settings";
+                    "top-tab": "top-tab";
+                }>>;
+                order: z.ZodOptional<z.ZodNumber>;
+                fields: z.ZodArray<z.ZodAny>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly updateGlobalSettings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            addonId: z.ZodString;
+            nodeId: z.ZodOptional<z.ZodString>;
+            patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>, z.ZodObject<{
+            success: z.ZodLiteral<true>;
+        }, z.core.$strip>, "mutation">;
+        readonly getDeviceSettings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            addonId: z.ZodString;
+            deviceId: z.ZodNumber;
+            nodeId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
+            tabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                icon: z.ZodString;
+                order: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            sections: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodEnum<{
+                    card: "card";
+                    accordion: "accordion";
+                }>>;
+                defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+                columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+                tab: z.ZodOptional<z.ZodString>;
+                location: z.ZodOptional<z.ZodEnum<{
+                    settings: "settings";
+                    "top-tab": "top-tab";
+                }>>;
+                order: z.ZodOptional<z.ZodNumber>;
+                fields: z.ZodArray<z.ZodAny>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly updateDeviceSettings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            addonId: z.ZodString;
+            deviceId: z.ZodNumber;
+            nodeId: z.ZodOptional<z.ZodString>;
+            patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>, z.ZodObject<{
+            success: z.ZodLiteral<true>;
+        }, z.core.$strip>, "mutation">;
+    };
+};
+export type IAddonSettingsProvider = InferProvider<typeof addonSettingsCapability>;
+export { SettingsSchemaWithValuesSchema, ConfigSectionWithValuesSchema, ConfigTabDeclarationSchema, SettingsPatchSchema, SettingsUpdateResultSchema, };
+//# sourceMappingURL=addon-settings.cap.d.ts.map

package/dist/capabilities/addon-settings.cap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addon-settings.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/addon-settings.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AASlG,QAAA,MAAM,0BAA0B;;;;;iBAK9B,CAAA;AAEF,QAAA,MAAM,6BAA6B;;;;;;;;;;;;;;;;;iBAcjC,CAAA;AAEF,QAAA,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;iBAGlC,CAAA;AAEF,4EAA4E;AAC5E,QAAA,MAAM,mBAAmB,wCAAoC,CAAA;AAE7D,uDAAuD;AACvD,QAAA,MAAM,0BAA0B;;iBAE9B,CAAA;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCK,CAAA;AAEzC,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAElF,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,EAC7B,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,GAC3B,CAAA"}