@tolinax/ayoune-interfaces 2026.33.1 → 2026.35.0

package/interfaces/IComputingEntity.d.ts

@@ -29,6 +29,27 @@ export interface IComputingEntityProgramHealthCheck {
     intervalMs?: number;
     timeoutMs?: number;
 }
+export interface IProgramHook {
+    type: 'http' | 'event' | 'beacon';
+    url?: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    body?: any;
+    headers?: Record<string, string>;
+    /** If 'fanOut', fires once per value in program.fanOut[]; ${fanOutValue} available in url/body templates */
+    repeatForEach?: 'fanOut' | 'none';
+    event?: string;
+    timeoutMs?: number;
+}
+export interface IProgramHooks {
+    onStarted?: IProgramHook[];
+    onStopped?: IProgramHook[];
+    onCrashed?: IProgramHook[];
+    onSetupDone?: IProgramHook[];
+}
+export interface IProgramConfig {
+    /** Reference to CustomConfigFiles — program-level template bundle (multi-file) */
+    customConfig?: ObjectId;
+}
 export interface IComputingEntityProgram {
     _id?: ObjectId;
     pid?: number;
@@ -87,6 +108,16 @@ export interface IComputingEntityProgram {
     healthCheck?: IComputingEntityProgramHealthCheck;
     adapter?: string;
     adapterConfig?: Record<string, any>;
+    /** Program-level reference to a CustomConfigFiles template bundle */
+    config?: IProgramConfig;
+    /** Generic iteration list — MT4: symbols; ERP: table names; Backup: drive letters */
+    fanOut?: string[];
+    /** Hooks fired at lifecycle events. 'http' hooks support repeatForEach: 'fanOut'. */
+    hooks?: IProgramHooks;
+    /** Sequence steps executed on first boot (setupDone=false) or via admin action */
+    initSequence?: IRemoteSequenceStep[];
+    /** Optional HTTP path/URL the managed process exposes for liveness probes */
+    beaconPath?: string;
 }
 export interface IComputingEntitySetting {
     mode?: string;
@@ -101,9 +132,19 @@ export interface IComputingEntityConfigFile {
     name?: string;
 }
 export interface IComputingEntityBinary {
+    /** One-shot binary via Uploads collection (e.g. custom EA one-off file) */
     _file?: ObjectId;
+    /** Versioned binary via updates.ayoune.app (Electron-updater protocol, channels, staged rollouts) */
+    appId?: string;
+    /** Download auth key (pairs with appId) */
+    key?: string;
+    /** Update channel: 'latest' | 'beta' | 'alpha' */
+    channel?: string;
+    /** Target path on the agent's filesystem */
     targetPath?: string;
+    /** SHA-256 of the expected content (verified after download when using _file) */
     checksum?: string;
+    /** Human-readable label for admin UI */
     name?: string;
 }
 export interface IComputingEntityConfig {
@@ -170,7 +211,11 @@ export interface IComputingEntity extends IDefaultFields {
     agentType?: 'desktop-client' | 'standalone' | 'legacy';
     capabilities?: string[];
     lastHeartbeat?: Date;
-    agentStatus?: 'online' | 'offline' | 'stale' | 'updating';
+    agentStatus?: 'online' | 'offline' | 'stale' | 'updating' | 'provisioning';
     tags?: string[];
     pendingCommands?: IRemoteCommand[];
+    bootstrapToken?: string;
+    bootstrapTokenExpiresAt?: Date;
+    bootstrapTokenUsedAt?: Date;
+    machineRefreshTokenHash?: string;
 }

package/interfaces/IComputingEntityTemplate.d.ts

@@ -1,4 +1,18 @@
 import { IDefaultFields } from "./IDefaultFields";
+import { IComputingEntityProgram, IComputingEntityBinary, IComputingEntityConfigFile } from "./IComputingEntity";
+export interface IComputingEntityFeatureFlags {
+    sync?: boolean;
+    nfc?: boolean;
+    barcode?: boolean;
+    iot?: boolean;
+    communication?: boolean;
+    ai?: boolean;
+    quickActions?: boolean;
+    clipboard?: boolean;
+    screenShare?: boolean;
+    remoteControl?: boolean;
+    processAgent?: boolean;
+}
 export interface IComputingEntityTemplate extends IDefaultFields {
     _customerID: ObjectId;
     _clientID?: ObjectId[];
@@ -11,4 +25,11 @@ export interface IComputingEntityTemplate extends IDefaultFields {
     password?: string;
     template?: string;
     parameters?: string;
+    adapter?: string;
+    featureFlags?: IComputingEntityFeatureFlags;
+    programs?: IComputingEntityProgram[];
+    binaries?: IComputingEntityBinary[];
+    configFiles?: IComputingEntityConfigFile[];
+    desktopClientInstaller?: string;
+    bootstrapTtlHours?: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tolinax/ayoune-interfaces",
-  "version": "2026.33.1",
+  "version": "2026.35.0",
   "description": "Houses TypeScript interfaces for aYOUne",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",