webaiapi 0.0.0-stage → 0.1.0

package/dist/browser/manager.d.ts

@@ -0,0 +1,144 @@
+import type { Browser, BrowserContext, Page } from 'playwright';
+import { type CapturedCookie } from './credentials.js';
+/** 账号在共享状态里的键（约定 `{platform}:{accountId}`）。 */
+export declare function accountKey(platform: string, accountId: string): string;
+/**
+ * 标记「正在这个账号上干活」（provider 在拿到锁之后调用）。
+ *
+ * ⚠️ 这是**重入计数**，必须与 {@link exitAccount} 成对（放 `finally`），
+ * 否则计数泄漏会让账号被永久当成「正忙」。
+ */
+export declare function enterAccount(platform: string, accountId: string): void;
+/** 解除「正在这个账号上干活」的标记（与 {@link enterAccount} 配对）。 */
+export declare function exitAccount(platform: string, accountId: string): void;
+/** 该账号此刻是否有人正在用。 */
+export declare function isAccountBusy(platform: string, accountId: string): boolean;
+/**
+ * 把 busy 占用从旧账号转移到新账号。
+ *
+ * ⚠️ **换号时必须调用**。原因：`enterAccount()` 是按**进入时**的账号登记 busy 的，
+ * 而 `chatStream()` 的 `finally` 只会 `exitAccount(当前账号)` —— 主通道被限流换号后
+ * 账号已经变了，两个账号对不上：**旧账号的 busy 计数永远不会归零**
+ * （被永久当成「正忙」，辅助通道挑账号、主通道再换号都会一直避开它）。
+ * 这里一次性完成「旧的退出 + 新的进入」，使重入计数配平。
+ */
+export declare function transferAccountBusy(platform: string, oldAccountId: string, newAccountId: string): void;
+/** 登记某账号当前服务的角色（main / aux）。 */
+export declare function setAccountRole(platform: string, accountId: string, role: string): void;
+/** 查询某账号的服务角色（未登记返回 undefined）。 */
+export declare function getAccountRole(platform: string, accountId: string): string | undefined;
+/** 释放某账号的角色占用（传了 `role` 时只在匹配时释放）。 */
+export declare function clearAccountRole(platform: string, accountId: string, role?: string): void;
+/** 把账号标记为冷却中（例如被平台限流），返回冷却截止时间戳。 */
+export declare function markAccountCooldown(platform: string, accountId: string, seconds: number, now?: () => number): number;
+/** 账号剩余冷却秒数（0 表示不在冷却中）。 */
+export declare function accountCooldownRemaining(platform: string, accountId: string, now?: () => number): number;
+/** 该账号是否在冷却中。 */
+export declare function isAccountCooling(platform: string, accountId: string, now?: () => number): boolean;
+/** 仅供测试：清空全部账号状态。 */
+export declare function resetAccountState(): void;
+/**
+ * 关闭所有通道。
+ *
+ * ⚠️ 浏览器重建/关闭时**必须**调用，否则会留下孤儿 context
+ * （占内存，且再也无法从 Node 侧关掉）。
+ */
+export declare function disposeAllChannels(): Promise<void>;
+/**
+ * 返回（必要时创建）某个「通道」的页面：**独立 context** + 指定账号的 cookie。
+ *
+ * ⚠️ 与 {@link newWorkPage} 的区别：`newWorkPage()` 是在**同一个 context** 里再开一页
+ * （cookie 与主页面共享 → 同一个账号）；本函数开的是**另一个 context**
+ * （cookie 独立 → 可以换账号，从而绕开「同一账号同时只能有一个对话」的平台限制）。
+ *
+ * 这是辅助任务能与主对话**真并行**的唯一方式。
+ */
+export declare function getChannelPage(channelKey: string, platform: string, accountId: string): Promise<Page | null>;
+/**
+ * 清理**孤儿** playwright Firefox / driver 进程（上一次服务运行留下的）。
+ *
+ * 只在启动全新实例前调用。判据是「父进程是 init(1)」—— 说明启动它的进程已经退出，
+ * 没有任何一方还持有它，属于纯垃圾。
+ *
+ * ⚠️ 只匹配 `ms-playwright/.../firefox`，不会碰用户自己登录用的系统 Firefox。
+ */
+export declare function sweepOrphanBrowsers(): number;
+/**
+ * 释放当前（多半已失效的）浏览器实例。
+ *
+ * ⚠️ **重建前必须先释放**：旧实现只把 `initialized` 置 false 就 `launch()` 新实例，
+ * 旧 Firefox 永远不会退出（Python 侧引用被覆盖后没有任何代码再去关它）。
+ */
+export declare function disposeSharedBrowser(): Promise<void>;
+export interface SharedBrowser {
+    browser: Browser;
+    context: BrowserContext;
+    page: Page;
+}
+/**
+ * 获取或创建共享的 Playwright Firefox 实例。
+ *
+ * 健康检查**只读本地状态**（不发 RPC），见文件头「三条铁律」。
+ */
+export declare function getBrowser(): Promise<SharedBrowser>;
+/**
+ * 在同一浏览器上下文里再开一个「工作页面」。
+ *
+ * 用途：需要在**独立对话**里再问一次模型的场景（两轮策略的 reparse）。
+ * 若共用主页面，reparse 会把主页面上的会话切走 —— 主会话上下文丢失、
+ * 会话复用（只补发增量）失效。
+ *
+ * ⚠️ 返回的是**新页面**，不会改动共享单例 `page`。
+ * Cookie / localStorage 属于 context，页面间共享，登录态自动沿用。
+ */
+export declare function newWorkPage(): Promise<Page | null>;
+/**
+ * 标记共享浏览器实例已失效，下次 `getBrowser()` 会重建它。
+ *
+ * 用于「操作时报了连接类错误」的场景：此时 `isConnected()` 可能还没更新，
+ * 不主动失效就会一直拿到坏实例、每个请求都失败，只能重启服务。
+ */
+export declare function invalidateBrowser(reason?: string): void;
+/** 关闭共享浏览器（服务优雅退出时调用）。 */
+export declare function closeBrowser(): Promise<void>;
+/**
+ * 把某账号的 Cookie 注入**主 context**。
+ *
+ * ⚠️ 注入后**必须重新导航**才生效（调用方负责）。
+ * 另外：旧实现把这段嵌在 `if (!page)` 里，导致 `checkLoginStatus()` 先赋好 `page` 之后
+ * 整块被跳过 —— 表现为「凭证明明在却永远是访客」。
+ * 所以本函数**每次都要独立调用**，不要加任何前置条件。
+ */
+export declare function loadCookies(platformName: string, accountId?: string, targetContext?: BrowserContext): Promise<boolean>;
+/** 获取当前共享页面。 */
+export declare function getPage(): Page;
+/** 当前共享页面（可能为 null，不抛异常）。 */
+export declare function peekPage(): Page | null;
+/** 导航到指定 URL（主导航一律等 `networkidle`，见 hard-constraints）。 */
+export declare function navigateTo(url: string, timeout?: number): Promise<void>;
+/**
+ * 在页面里注册通用的响应提取函数（兜底用）。
+ *
+ * 注册 `window.__ai_api_get_response()` / `__ai_api_clear_input()` / `__ai_api_set_input()`。
+ * ⚠️ ChatGLM 的正文**不用**这个（DOM innerText 已被 Markdown 渲染破坏），
+ * 只作为其它场景的兜底。
+ */
+export declare function injectResponseJs(targetPage?: Page): Promise<void>;
+/** 供测试/诊断：当前实例状态。 */
+export declare function browserState(): {
+    initialized: boolean;
+    hasBrowser: boolean;
+    hasPage: boolean;
+    channels: string[];
+};
+/** 供测试：把一个假的 page/context/browser 塞进去（不启动真实浏览器）。 */
+export declare function __setSharedForTest(state: {
+    browser?: Browser | null;
+    context?: BrowserContext | null;
+    page?: Page | null;
+    initialized?: boolean;
+}): void;
+/** 落盘一份 cookie（供 CLI 复用）；目录不存在会自动创建。 */
+export declare function writeAuthFile(platform: string, accountId: string, payload: Record<string, unknown>): string;
+export type { CapturedCookie };
+//# sourceMappingURL=manager.d.ts.map

package/dist/browser/manager.d.ts.map

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