@songsid/agend 0.0.1

package/dist/web-api.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Web UI HTTP API handler.
+ * All /ui/* routes are handled here, extracted from fleet-manager.ts.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { LifecycleCreateArgs } from "./instance-lifecycle.js";
+/**
+ * Push a single SSE frame to every client. If a client throws (closed socket
+ * after a network drop, etc.), evict it from the set and continue — without
+ * the eviction the dead entry leaks forever, and without the try/catch a
+ * single dead client breaks delivery to every client iterated after it.
+ */
+export declare function broadcastSseEvent(clients: Set<ServerResponse>, event: string, data: unknown, onError?: (err: unknown) => void): void;
+/** Minimal interface — only what web-api needs from FleetManager. */
+export interface WebApiContext {
+    readonly webToken: string | null;
+    readonly dataDir: string;
+    readonly sseClients: Set<ServerResponse>;
+    readonly fleetConfig: {
+        channel?: {
+            group_id?: number | string;
+            mode?: string;
+        };
+        instances: Record<string, {
+            topic_id?: number | string;
+            working_directory: string;
+            description?: string;
+            display_name?: string;
+        }>;
+        teams?: Record<string, {
+            members: string[];
+            description?: string;
+        }>;
+    } | null;
+    readonly instanceIpcClients: Map<string, {
+        send(msg: unknown): void;
+    }>;
+    readonly adapter: {
+        sendText(chatId: string, text: string, opts?: {
+            threadId?: string;
+        }): Promise<unknown>;
+    } | null;
+    getAdapterForInstance?(name: string): {
+        sendText(chatId: string, text: string, opts?: {
+            threadId?: string;
+        }): Promise<unknown>;
+    } | null;
+    getGroupIdForInstance?(name: string): string;
+    readonly daemons: Map<string, unknown>;
+    readonly eventLog: {
+        logActivity(event: string, sender: string, summary: string, receiver?: string, detail?: string): void;
+        listActivity(opts?: {
+            since?: string;
+            limit?: number;
+        }): unknown[];
+    } | null;
+    readonly logger: {
+        info(obj: unknown, msg?: string): void;
+        debug(obj: unknown, msg?: string): void;
+        error(obj: unknown, msg?: string): void;
+    };
+    getInstanceDir(name: string): string;
+    getInstanceStatus(name: string): "running" | "stopped" | "crashed";
+    getUiStatus(): unknown;
+    emitSseEvent(event: string, data: unknown): void;
+    startInstance(name: string, config: unknown, topicMode: boolean): Promise<void>;
+    stopInstance(name: string): Promise<void>;
+    restartSingleInstance(name: string): Promise<void>;
+    removeInstance(name: string): Promise<void>;
+    lastInboundUser: Map<string, string>;
+    saveFleetConfig(): void;
+    readonly lifecycle: {
+        handleCreate(args: LifecycleCreateArgs, respond: (result: unknown, error?: string) => void): Promise<void>;
+    };
+    connectIpcToInstance(name: string): Promise<void>;
+    readonly scheduler: {
+        db: {
+            listTasks(opts?: {
+                assignee?: string;
+                status?: string;
+            }): unknown[];
+            createTask(params: {
+                title: string;
+                description?: string;
+                priority?: string;
+                assignee?: string;
+                created_by: string;
+            }): unknown;
+            updateTask(id: string, params: Record<string, unknown>): unknown;
+            claimTask(id: string, assignee: string): unknown;
+            completeTask(id: string, result?: string): unknown;
+        };
+        list(target?: string): unknown[];
+        create(params: unknown): unknown;
+        delete(id: string): void;
+    } | null;
+}
+/**
+ * Handle a Web UI request. Returns true if handled, false to pass through.
+ */
+export declare function handleWebRequest(req: IncomingMessage, res: ServerResponse, url: URL, ctx: WebApiContext): boolean;