@qlingzzy/qling 1.0.0 → 1.1.0

package/dist/skills/types.d.ts

@@ -2,6 +2,8 @@ export interface SkillMeta {
     name: string;
     description: string;
     tags: string[];
+    /** 触发关键词/场景，仅进入索引，不进正文 */
+    triggers: string[];
     path: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/skills/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/statusline.d.ts

@@ -9,8 +9,9 @@ export interface StatusLineSnapshot {
     goalStatus: string | null;
     activeTasks: number;
     tokens: number;
-    tokenSource?: "provider" | "estimate" | "unknown";
-    maxTokens?: number | null;
+    promptTokens?: number;
+    completionTokens?: number;
+    tokenSource?: "provider" | "unknown";
     costPer1kTokens?: number | null;
     inputQueue?: StatusLineInputQueueSnapshot;
 }
@@ -23,7 +24,6 @@ export interface LocalStatusLineSnapshotOptions {
     workspaceDir?: string | null;
     model?: string | null;
     permissionMode?: string | null;
-    maxTokens?: number | null;
     costPer1kTokens?: number | null;
 }
 export declare function resolveGitBranch(workspaceDir?: string): string | null;

package/dist/statusline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"statusline.d.ts","sourceRoot":"","sources":["../src/statusline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,8BAA8B;IAC7C,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AA4BD,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWrE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAa5E;AAiBD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEpE;AAmCD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAyBrE;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,8BAA8B,GAAG,kBAAkB,CAc1G;AAED,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkDzG;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnF"}
+{"version":3,"file":"statusline.d.ts","sourceRoot":"","sources":["../src/statusline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,8BAA8B;IAC7C,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AA4BD,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWrE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAa5E;AAiBD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEpE;AAqBD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CA4BrE;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,8BAA8B,GAAG,kBAAkB,CAe1G;AAED,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmDzG;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnF"}

package/dist/statusline.js

@@ -80,15 +80,6 @@ function normalizePositiveNumber(value) {
 export function parseStatusLineCostPer1k(raw) {
     return normalizePositiveNumber(raw);
 }
-function formatContextUsage(tokens, maxTokens) {
-    const used = Math.max(0, Math.floor(Number(tokens ?? 0)));
-    const max = normalizePositiveNumber(maxTokens);
-    if (!max)
-        return `${used.toLocaleString()}/-`;
-    const roundedMax = Math.floor(max);
-    const pct = Math.round((used / roundedMax) * 100);
-    return `${used.toLocaleString()}/${roundedMax.toLocaleString()}(${pct}%)`;
-}
 function formatCostEstimate(tokens, costPer1kTokens) {
     const costPer1k = normalizePositiveNumber(costPer1kTokens);
     if (!costPer1k)
@@ -98,11 +89,7 @@ function formatCostEstimate(tokens, costPer1kTokens) {
     return `≈$${estimate.toFixed(4)}`;
 }
 function normalizeTokenSource(value) {
-    return value === "provider" || value === "estimate" ? value : "unknown";
-}
-function resolveTokenBudgetMax(agentLoop) {
-    const value = agentLoop.getTokenBudget?.()?.maxTokens ?? agentLoop.tokenBudget?.maxTokens;
-    return normalizePositiveNumber(value);
+    return value === "provider" ? "provider" : "unknown";
 }
 function formatSessionMode(mode) {
     const m = String(mode ?? "").trim().toLowerCase();
@@ -119,6 +106,8 @@ export function formatStatusLine(snapshot) {
     const permission = formatPermissionMode(snapshot.permissionMode);
     const sessionMode = formatSessionMode(snapshot.sessionMode);
     const cost = formatCostEstimate(snapshot.tokens, snapshot.costPer1kTokens);
+    const prompt = Math.max(0, Math.floor(Number(snapshot.promptTokens ?? 0)));
+    const completion = Math.max(0, Math.floor(Number(snapshot.completionTokens ?? 0)));
     const parts = [
         `模型=${snapshot.model || "未知"}`,
         `模式=${sessionMode}`,
@@ -128,8 +117,9 @@ export function formatStatusLine(snapshot) {
         `目标=${goal}`,
         `任务=${snapshot.activeTasks}`,
         `令牌=${Number(snapshot.tokens ?? 0).toLocaleString()}`,
+        `in=${prompt.toLocaleString()}`,
+        `out=${completion.toLocaleString()}`,
         `来源=${normalizeTokenSource(snapshot.tokenSource)}`,
-        `上下文=${formatContextUsage(snapshot.tokens, snapshot.maxTokens)}`,
         cost === "-" ? "成本=-" : `成本${cost}`,
     ];
     const queue = formatInputQueueStatus(snapshot.inputQueue);
@@ -148,8 +138,9 @@ export function collectLocalStatusLineSnapshot(options) {
         goalStatus: null,
         activeTasks: 0,
         tokens: 0,
+        promptTokens: 0,
+        completionTokens: 0,
         tokenSource: "unknown",
-        maxTokens: normalizePositiveNumber(options.maxTokens),
         costPer1kTokens: parseStatusLineCostPer1k(options.costPer1kTokens),
     };
 }
@@ -196,8 +187,9 @@ export async function collectStatusLineSnapshot(context) {
         goalStatus: goal?.status ?? null,
         activeTasks,
         tokens: Number(stats.tokens ?? 0),
+        promptTokens: Number(stats.promptTokens ?? 0),
+        completionTokens: Number(stats.completionTokens ?? 0),
         tokenSource: normalizeTokenSource(stats.tokenSource),
-        maxTokens: resolveTokenBudgetMax(agentLoop),
         costPer1kTokens: parseStatusLineCostPer1k(process.env.QLING_STATUSLINE_COST_PER_1K_TOKENS),
         inputQueue,
     };

package/dist/token-usage.d.ts

@@ -0,0 +1,27 @@
+export type TokenUsageSource = "provider" | "unknown";
+export interface ChatUsage {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens: number;
+    raw?: Record<string, unknown>;
+}
+export interface ResolvedTokenUsage {
+    tokens: number;
+    promptTokens: number;
+    completionTokens: number;
+    source: TokenUsageSource;
+}
+/**
+ * 从 chat/completions 或 Ollama 等响应中提取官方 usage。
+ * 支持嵌套 `usage` 与顶层计数字段。
+ */
+export declare function extractProviderUsage(raw: unknown): ChatUsage | undefined;
+/** 将本轮官方 usage 解析为可累加的会话增量。 */
+export declare function resolveRoundTokenUsage(usage: ChatUsage | undefined): ResolvedTokenUsage;
+export declare function formatProviderTokenLine(options: {
+    tokens: number;
+    promptTokens?: number;
+    completionTokens?: number;
+    source?: TokenUsageSource;
+}): string;
+//# sourceMappingURL=token-usage.d.ts.map

package/dist/token-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-usage.d.ts","sourceRoot":"","sources":["../src/token-usage.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,SAAS,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAoBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAqDxE;AAED,+BAA+B;AAC/B,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,kBAAkB,CAevF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GAAG,MAAM,CAaT"}

package/dist/token-usage.js

@@ -0,0 +1,107 @@
+// ============================================================
+// 轻灵 — 模型官方 Token Usage 解析
+// 仅信任 provider 返回字段，不做字符启发式账单估算。
+// ============================================================
+function positiveInt(value) {
+    const n = typeof value === "number" ? value : Number(value);
+    if (!Number.isFinite(n) || n < 0)
+        return undefined;
+    const floored = Math.floor(n);
+    return floored >= 0 ? floored : undefined;
+}
+function firstPositive(obj, keys) {
+    for (const key of keys) {
+        if (!(key in obj))
+            continue;
+        const n = positiveInt(obj[key]);
+        if (n !== undefined && n > 0)
+            return n;
+        // 允许 0（空 completion 等）
+        if (n === 0)
+            return 0;
+    }
+    return undefined;
+}
+/**
+ * 从 chat/completions 或 Ollama 等响应中提取官方 usage。
+ * 支持嵌套 `usage` 与顶层计数字段。
+ */
+export function extractProviderUsage(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const root = raw;
+    const nested = root.usage && typeof root.usage === "object"
+        ? root.usage
+        : root;
+    const promptTokens = firstPositive(nested, [
+        "prompt_tokens",
+        "promptTokens",
+        "input_tokens",
+        "inputTokens",
+        "prompt_eval_count",
+        "promptEvalCount",
+    ]);
+    const completionTokens = firstPositive(nested, [
+        "completion_tokens",
+        "completionTokens",
+        "output_tokens",
+        "outputTokens",
+        "eval_count",
+        "evalCount",
+    ]);
+    let totalTokens = firstPositive(nested, [
+        "total_tokens",
+        "totalTokens",
+        "total",
+    ]);
+    if (totalTokens === undefined) {
+        if (promptTokens !== undefined || completionTokens !== undefined) {
+            totalTokens = (promptTokens ?? 0) + (completionTokens ?? 0);
+        }
+    }
+    if (totalTokens === undefined || totalTokens <= 0) {
+        // 若 total 为 0 但有明确 prompt/completion 0 之和，仍视为无有效用量
+        if (totalTokens === 0 && (promptTokens ?? 0) + (completionTokens ?? 0) === 0) {
+            return undefined;
+        }
+        if (totalTokens === undefined)
+            return undefined;
+    }
+    if (totalTokens <= 0)
+        return undefined;
+    return {
+        promptTokens,
+        completionTokens,
+        totalTokens,
+        raw: nested,
+    };
+}
+/** 将本轮官方 usage 解析为可累加的会话增量。 */
+export function resolveRoundTokenUsage(usage) {
+    if (usage && Number.isFinite(usage.totalTokens) && usage.totalTokens > 0) {
+        return {
+            tokens: Math.floor(usage.totalTokens),
+            promptTokens: Math.max(0, Math.floor(usage.promptTokens ?? 0)),
+            completionTokens: Math.max(0, Math.floor(usage.completionTokens ?? 0)),
+            source: "provider",
+        };
+    }
+    return {
+        tokens: 0,
+        promptTokens: 0,
+        completionTokens: 0,
+        source: "unknown",
+    };
+}
+export function formatProviderTokenLine(options) {
+    const tokens = Math.max(0, Math.floor(options.tokens ?? 0));
+    const prompt = options.promptTokens;
+    const completion = options.completionTokens;
+    const source = options.source ?? "unknown";
+    if (typeof prompt === "number" &&
+        typeof completion === "number" &&
+        (prompt > 0 || completion > 0)) {
+        return `${tokens.toLocaleString()} (in ${prompt.toLocaleString()} + out ${completion.toLocaleString()}, ${source})`;
+    }
+    return `${tokens.toLocaleString()} (${source})`;
+}

package/dist/tools/bash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzD,eAAO,MAAM,QAAQ,EAAE,cA+FtB,CAAC;AAEF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC,GAAG,OAAO,CAAC,UAAU,CAAC,CAyJtB"}
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzD,eAAO,MAAM,QAAQ,EAAE,cAiGtB,CAAC;AAEF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC,GAAG,OAAO,CAAC,UAAU,CAAC,CAyJtB"}

package/dist/tools/bash.js

@@ -12,7 +12,7 @@ const MAX_COMMAND_LENGTH = 5000;
 const MAX_OUTPUT_BYTES = 1024 * 1024; // 1MB per stream
 export const bashTool = {
     name: "bash",
-    description: "Execute shell commands on Linux/Windows (git, npm, file operations, CLI tools). Returns stdout/stderr. Hook intercepts dangerous operations (rm -rf, disk format, etc.).",
+    description: "Execute shell commands (git, npm, opencli, file ops). For Douyin/Xiaohongshu/Weibo/etc. run opencli after skill name=opencli; prefer opencli … -f json. Not for raw fetch of anti-bot pages.",
     longDescription: `执行 shell 命令的万能工具。**Linux**: 通过 /bin/sh 执行。**Windows**: 通过 cmd.exe 执行（而非 PowerShell）。
 **重要 - Windows 用户**：Windows 上请使用标准的 cmd.exe 命令（dir, type, copy, del 等），不要使用 PowerShell 独有语法（Invoke-WebRequest 等）。cmd.exe 不支持 PowerShell cmdlet。
 **Linux 用户**：通过 /bin/sh 执行标准 POSIX 命令。
@@ -20,15 +20,17 @@ export const bashTool = {
 **使用场景**:
 - git 操作（git add, git commit, git push）
 - npm/node 命令（npm install, node scripts）
+- **opencli**（本机已安装时）：opencli list / opencli douyin search … -f json（先 skill name="opencli"）
 - 文件操作（ls, cp, mv, mkdir）
 - 进程管理（ps, kill, pgrep）
-- 网络工具（curl, wget, ping）
+- 网络工具（curl, wget, ping）— 强反爬社交站不要用 curl 硬抓
 - 编译构建（make, gcc, cargo）
 
 **注意事项**:
 - rm -rf 等危险操作会被 Hook 拦截并要求确认
 - Windows 下需要通过 cmd.exe /c 执行
-- 长时间运行的命令建议设置 timeout`,
+- 长时间运行的命令建议设置 timeout
+- opencli 写操作（delete/publish）须用户确认`,
     parameters: {
         type: "object",
         properties: {

package/dist/tools/browser-act-session.d.ts

@@ -0,0 +1,48 @@
+import { type Browser, type BrowserContext, type Page } from "playwright";
+export interface BrowserSessionHandle {
+    id: string;
+    browser: Browser;
+    context: BrowserContext;
+    page: Page;
+    lastUrl: string;
+    createdAt: number;
+    lastUsedAt: number;
+    requestGuardInstalled: boolean;
+}
+export type BrowserRequestGuard = (url: string) => Promise<boolean>;
+export interface BrowserSessionPoolOptions {
+    /** 最大并发会话数 */
+    maxSessions?: number;
+    /** 空闲超时 ms，超过则自动关闭 */
+    idleTtlMs?: number;
+    /** 注入的 launch 工厂（测试用） */
+    launchBrowser?: () => Promise<Browser>;
+}
+export declare class BrowserSessionPool {
+    private sessions;
+    private maxSessions;
+    private idleTtlMs;
+    private launchBrowser;
+    constructor(options?: BrowserSessionPoolOptions);
+    list(): Array<{
+        id: string;
+        lastUrl: string;
+        ageMs: number;
+        idleMs: number;
+    }>;
+    has(id: string): boolean;
+    get(id: string): BrowserSessionHandle | undefined;
+    /** 关闭并移除空闲超时会话 */
+    sweepIdle(now?: number): Promise<string[]>;
+    open(id: string, requestGuard?: BrowserRequestGuard): Promise<BrowserSessionHandle>;
+    private installRequestGuard;
+    touch(id: string, lastUrl?: string): void;
+    close(id: string): Promise<boolean>;
+    closeAll(): Promise<void>;
+    size(): number;
+}
+export declare function getBrowserSessionPool(): BrowserSessionPool;
+/** 测试用：替换 / 清空默认池 */
+export declare function resetBrowserSessionPool(pool?: BrowserSessionPool | null): void;
+export declare function normalizeSessionId(raw: unknown): string;
+//# sourceMappingURL=browser-act-session.d.ts.map

package/dist/tools/browser-act-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-act-session.d.ts","sourceRoot":"","sources":["../../src/tools/browser-act-session.ts"],"names":[],"mappings":"AAIA,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAEpF,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpE,MAAM,WAAW,yBAAyB;IACxC,cAAc;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACxC;AAiBD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAyB;gBAElC,OAAO,GAAE,yBAA8B;IAWnD,IAAI,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAU7E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAIjD,kBAAkB;IACZ,SAAS,CAAC,GAAG,SAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAY9C,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;YAiD3E,mBAAmB;IAgBjC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAOnC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQnC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B,IAAI,IAAI,MAAM;CAGf;AAKD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAG1D;AAED,qBAAqB;AACrB,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAK9E;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKvD"}

package/dist/tools/browser-act-session.js

@@ -0,0 +1,168 @@
+// ============================================================
+// browser_act 跨步会话：进程内 Playwright page 保活
+// ============================================================
+import { chromium } from "playwright";
+const DEFAULT_MAX = 3;
+const DEFAULT_IDLE_TTL_MS = 10 * 60 * 1000;
+function resolveMaxSessions(env = process.env) {
+    const n = Number(env.QLING_BROWSER_ACT_MAX_SESSIONS ?? DEFAULT_MAX);
+    if (!Number.isFinite(n) || n < 1)
+        return DEFAULT_MAX;
+    return Math.min(8, Math.floor(n));
+}
+function resolveIdleTtlMs(env = process.env) {
+    const n = Number(env.QLING_BROWSER_ACT_IDLE_TTL_MS ?? DEFAULT_IDLE_TTL_MS);
+    if (!Number.isFinite(n) || n < 0)
+        return DEFAULT_IDLE_TTL_MS;
+    return Math.floor(n);
+}
+export class BrowserSessionPool {
+    sessions = new Map();
+    maxSessions;
+    idleTtlMs;
+    launchBrowser;
+    constructor(options = {}) {
+        this.maxSessions = options.maxSessions ?? resolveMaxSessions();
+        this.idleTtlMs = options.idleTtlMs ?? resolveIdleTtlMs();
+        this.launchBrowser =
+            options.launchBrowser ??
+                (() => chromium.launch({
+                    headless: true,
+                }));
+    }
+    list() {
+        const now = Date.now();
+        return Array.from(this.sessions.values()).map((s) => ({
+            id: s.id,
+            lastUrl: s.lastUrl,
+            ageMs: now - s.createdAt,
+            idleMs: now - s.lastUsedAt,
+        }));
+    }
+    has(id) {
+        return this.sessions.has(id);
+    }
+    get(id) {
+        return this.sessions.get(id);
+    }
+    /** 关闭并移除空闲超时会话 */
+    async sweepIdle(now = Date.now()) {
+        if (this.idleTtlMs <= 0)
+            return [];
+        const closed = [];
+        for (const [id, s] of this.sessions) {
+            if (now - s.lastUsedAt >= this.idleTtlMs) {
+                await this.close(id);
+                closed.push(id);
+            }
+        }
+        return closed;
+    }
+    async open(id, requestGuard) {
+        await this.sweepIdle();
+        const existing = this.sessions.get(id);
+        if (existing) {
+            if (requestGuard && !existing.requestGuardInstalled) {
+                await this.installRequestGuard(existing.context, requestGuard);
+                existing.requestGuardInstalled = true;
+            }
+            existing.lastUsedAt = Date.now();
+            return existing;
+        }
+        if (this.sessions.size >= this.maxSessions) {
+            // 驱逐最久未用
+            let oldestId = null;
+            let oldest = Infinity;
+            for (const [sid, s] of this.sessions) {
+                if (s.lastUsedAt < oldest) {
+                    oldest = s.lastUsedAt;
+                    oldestId = sid;
+                }
+            }
+            if (oldestId)
+                await this.close(oldestId);
+        }
+        const browser = await this.launchBrowser();
+        const context = await browser.newContext({
+            userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+        });
+        if (requestGuard) {
+            await this.installRequestGuard(context, requestGuard);
+        }
+        const page = await context.newPage();
+        const now = Date.now();
+        const handle = {
+            id,
+            browser,
+            context,
+            page,
+            lastUrl: "",
+            createdAt: now,
+            lastUsedAt: now,
+            requestGuardInstalled: Boolean(requestGuard),
+        };
+        this.sessions.set(id, handle);
+        return handle;
+    }
+    async installRequestGuard(context, requestGuard) {
+        await context.route("**/*", async (route) => {
+            let allowed = false;
+            try {
+                allowed = await requestGuard(route.request().url());
+            }
+            catch {
+                allowed = false;
+            }
+            if (allowed)
+                await route.continue();
+            else
+                await route.abort("blockedbyclient");
+        });
+    }
+    touch(id, lastUrl) {
+        const s = this.sessions.get(id);
+        if (!s)
+            return;
+        s.lastUsedAt = Date.now();
+        if (lastUrl !== undefined)
+            s.lastUrl = lastUrl;
+    }
+    async close(id) {
+        const s = this.sessions.get(id);
+        if (!s)
+            return false;
+        this.sessions.delete(id);
+        await s.browser.close().catch(() => undefined);
+        return true;
+    }
+    async closeAll() {
+        const ids = Array.from(this.sessions.keys());
+        for (const id of ids) {
+            await this.close(id);
+        }
+    }
+    size() {
+        return this.sessions.size;
+    }
+}
+/** 进程内默认池（browser_act 共用） */
+let defaultPool = null;
+export function getBrowserSessionPool() {
+    if (!defaultPool)
+        defaultPool = new BrowserSessionPool();
+    return defaultPool;
+}
+/** 测试用：替换 / 清空默认池 */
+export function resetBrowserSessionPool(pool) {
+    if (defaultPool) {
+        void defaultPool.closeAll();
+    }
+    defaultPool = pool === undefined ? null : pool;
+}
+export function normalizeSessionId(raw) {
+    const s = String(raw ?? "default").trim();
+    if (!s)
+        return "default";
+    // 防止路径穿越式 id
+    return s.replace(/[^\w.-]+/g, "_").slice(0, 64) || "default";
+}

package/dist/tools/browser-act.d.ts

@@ -0,0 +1,14 @@
+import type { ToolDefinition, ToolResult } from "../types.js";
+export type BrowserActAction = "open" | "close" | "status" | "goto" | "click" | "type" | "wait_for" | "extract" | "press";
+export declare function isBrowserActEnabled(env?: NodeJS.ProcessEnv | Record<string, string | undefined>): boolean;
+export declare const browserActTool: ToolDefinition;
+export declare function runBrowserAct(args: {
+    action?: string;
+    session?: string;
+    url?: string;
+    selector?: string;
+    text?: string;
+    key?: string;
+    timeout_ms?: number;
+}): Promise<ToolResult>;
+//# sourceMappingURL=browser-act.d.ts.map

package/dist/tools/browser-act.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-act.d.ts","sourceRoot":"","sources":["../../src/tools/browser-act.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAS9D,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,MAAM,GACN,UAAU,GACV,SAAS,GACT,OAAO,CAAC;AAIZ,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACxE,OAAO,CAGT;AAED,eAAO,MAAM,cAAc,EAAE,cA+C5B,CAAC;AAwDF,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsNtB"}