@zhin.js/host-http 1.0.0 → 1.0.2

package/lib/console-events.d.ts

@@ -0,0 +1,13 @@
+import type { ServerResponse } from 'node:http';
+/**
+ * Console 实时事件枢纽（Plugin Runtime Host 的 `/api/events` SSE 事件源）。
+ * 单进程内 fan-out：`publish` 向所有已订阅的 SSE response 写帧；
+ * write 失败或连接断开自动摘除订阅。
+ */
+export interface ConsoleEventHub {
+    publish(type: string, data: unknown): void;
+    /** 订阅事件流；返回 unsubscribe。连接断开时也会自动摘除。 */
+    subscribe(response: ServerResponse): () => void;
+    readonly subscriberCount: number;
+}
+export declare function createConsoleEventHub(): ConsoleEventHub;

package/lib/console-events.js

@@ -0,0 +1,33 @@
+export function createConsoleEventHub() {
+    let nextId = 0;
+    const subscribers = new Set();
+    const remove = (response) => {
+        subscribers.delete(response);
+    };
+    return {
+        get subscriberCount() {
+            return subscribers.size;
+        },
+        publish(type, data) {
+            nextId += 1;
+            const frame = `id: ${nextId}\nevent: ${type}\ndata: ${JSON.stringify(data)}\n\n`;
+            for (const response of [...subscribers]) {
+                try {
+                    response.write(frame, (error) => {
+                        if (error)
+                            remove(response);
+                    });
+                }
+                catch {
+                    remove(response);
+                }
+            }
+        },
+        subscribe(response) {
+            subscribers.add(response);
+            response.once('close', () => remove(response));
+            response.once('error', () => remove(response));
+            return () => remove(response);
+        },
+    };
+}

package/lib/console-rpc-extended.d.ts

@@ -9,9 +9,10 @@
  * - cron：`ctx.scheduleHost`（Plugin Runtime ScheduleHost，仅 register/list，
  *   无持久化引擎，故 cron:add/remove/pause/resume 报"未接线"）。
  * - inbox：`ctx.databaseHost.models`（unified_inbox_message/request/notice 三张表，
- *   表不存在或查询失败 → 空数组 + inboxEnabled:false）。
- * - 社交/群管：`ctx.resolveEndpoint` 拿 live endpoint 实例，
- *   实例上探测到对应方法才调用，否则报"该平台不支持"。
+ *   表不存在或查询失败 → 空数组 + inboxEnabled:false；requestConsumed/noticeConsumed
+ *   按行 id update consumed=1，表/model 缺失时报"未接线"）。
+ * - 社交/群管：`ctx.resolveEndpoint` 拿 live endpoint 实例，只消费其
+ *   `management` 语义端口；平台 SDK 兼容与字段归一化由 Adapter 负责。
  */
 export interface ConsoleRpcExtendedCtx {
     /** full scope 才允许写操作；demo scope 只放行只读 RPC。 */
@@ -19,7 +20,9 @@ export interface ConsoleRpcExtendedCtx {
     projectRoot: string;
     /** Plugin Runtime ScheduleHost（basic/cli schedule-host-installer 提供）。 */
     scheduleHost?: unknown;
-    /** 经 ImRuntime / AdapterEndpointIndex 解析 live endpoint 实例。 */
+    /** 经 ImRuntime / AdapterEndpointIndex 解析管理语义端口。 */
+    resolveEndpointManagement?: (adapter: string, endpointId: string) => EndpointManagementPort | null | undefined;
+    /** @deprecated Use `resolveEndpointManagement`; accepted for one compatibility cycle. */
     resolveEndpoint?: (adapter: string, endpointId: string) => unknown;
     /** Plugin Runtime DatabaseHost 的 models 视图。 */
     databaseHost?: {
@@ -27,10 +30,47 @@ export interface ConsoleRpcExtendedCtx {
             get(name: string): unknown;
         };
     };
+    /** Agent Host 持久化调度引擎（@zhin.js/agent getAssistantRuntime().engine），未 init 时返回 null。 */
+    resolveScheduleEngine?: () => ConsoleScheduleEngine | null | undefined;
+}
+export interface ConsoleScheduleEngine {
+    addJob(job: Record<string, unknown>): Promise<Record<string, unknown>>;
+    removeJob(id: string): Promise<boolean>;
+    pauseJob(id: string): Promise<boolean>;
+    resumeJob(id: string): Promise<boolean>;
+    listJobs(): Promise<Record<string, unknown>[]>;
 }
 export type ExtendedRpcResult = {
     data: unknown;
 } | {
     error: string;
 };
+interface EndpointManagementPort {
+    listFriends?(): Promise<readonly {
+        user_id: number;
+        nickname: string;
+        remark: string;
+    }[]>;
+    listGroups?(): Promise<readonly {
+        group_id: number;
+        name: string;
+    }[]>;
+    listChannels?(): Promise<readonly {
+        id: string;
+        name?: string;
+        parent?: {
+            type: string;
+            id: string;
+            name?: string;
+        };
+    }[]>;
+    listGroupMembers?(groupId: string): Promise<readonly unknown[]>;
+    approveRequest?(requestId: string, remark?: string): Promise<void>;
+    rejectRequest?(requestId: string, reason?: string): Promise<void>;
+    kickGroupMember?(groupId: string, userId: string): Promise<void>;
+    muteGroupMember?(groupId: string, userId: string, durationSeconds: number): Promise<void>;
+    setGroupAdmin?(groupId: string, userId: string, enabled: boolean): Promise<void>;
+    deleteFriend?(userId: string): Promise<void>;
+}
 export declare function dispatchExtendedConsoleRpc(type: string, data: Record<string, unknown> | undefined, ctx: ConsoleRpcExtendedCtx): Promise<ExtendedRpcResult | undefined>;
+export {};