@kici-dev/orchestrator 0.1.11 → 0.1.13

package/dist/cli/service/types.d.ts

@@ -59,6 +59,15 @@ export interface ServiceConfig {
     isUserLevel: boolean;
     /** Restart policy configuration. */
     restartPolicy: RestartPolicy;
+    /**
+     * Which KiCI component this service runs. Embedded in the unit (X-KiCI-Component
+     * for systemd, KiCIComponent for launchd, dev.kici.component label for compose,
+     * description prefix for Windows) so per-driver `list()` scans can classify
+     * a discovered unit without relying on naming conventions.
+     *
+     * Optional during lifecycle ops that don't regenerate the unit; required on install.
+     */
+    component?: 'orchestrator' | 'agent';
 }
 /** Current state of a service. */
 export type ServiceState = 'running' | 'stopped' | 'failed' | 'unknown';
@@ -84,6 +93,15 @@ export interface LogOptions {
     /** Follow (tail -f) mode. */
     follow?: boolean;
 }
+/** Result of a per-driver discovery scan. */
+export interface DiscoveredInstance {
+    name: string;
+    /** Always set; the driver knows its own platform. */
+    platform: ServicePlatform;
+    isUserLevel: boolean;
+    /** The component this unit belongs to, decoded from the unit's KiCI marker. */
+    component: 'orchestrator' | 'agent';
+}
 /**
  * Interface that all platform-specific service managers must implement.
  *
@@ -106,5 +124,15 @@ export interface ServiceManager {
     logs(config: ServiceConfig, options: LogOptions): Promise<void>;
     /** Check if the service is currently installed/registered. */
     isInstalled(config: ServiceConfig): Promise<boolean>;
+    /**
+     * Discover KiCI-managed services on this platform. The driver enumerates
+     * its native registry (systemctl/launchctl/sc/podman) and decodes each
+     * unit's component marker. Used by resolve.ts#listInstances to reconcile
+     * the index cache against ground truth.
+     *
+     * `isUserLevel` selects user vs system scope on platforms where that matters
+     * (systemd, launchd); ignored on Windows/compose.
+     */
+    list(isUserLevel: boolean): Promise<DiscoveredInstance[]>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/cli/service/windows.d.ts

@@ -6,7 +6,7 @@
  * dependency on first use. Service configuration (auto-start, recovery)
  * is handled via sc.exe.
  */
-import type { ServiceManager, ServiceConfig, ServiceStatus, LogOptions } from './types.js';
+import type { ServiceManager, ServiceConfig, ServiceStatus, LogOptions, DiscoveredInstance } from './types.js';
 export declare class WindowsServiceManager implements ServiceManager {
     install(config: ServiceConfig): Promise<void>;
     uninstall(config: ServiceConfig): Promise<void>;
@@ -16,5 +16,6 @@ export declare class WindowsServiceManager implements ServiceManager {
     status(config: ServiceConfig): Promise<ServiceStatus>;
     logs(config: ServiceConfig, _options: LogOptions): Promise<void>;
     isInstalled(config: ServiceConfig): Promise<boolean>;
+    list(isUserLevel: boolean): Promise<DiscoveredInstance[]>;
 }
 //# sourceMappingURL=windows.d.ts.map