@qwen-code/arena-agent 0.0.9-dev.26 → 0.0.9-dev.28

package/README.md

@@ -1,13 +1,17 @@
 # Arena CodeAgent Harness
 
-这是一个根据 `message.json` 与 `tools.json` 逆向实现的 TypeScript CodeAgent
-harness。运行时只依赖 Node.js，不再依赖 Python：
+这是一个基于 `message.json` 与 `tools.json` 所定义消息和工具契约的 TypeScript
+CodeAgent harness。运行时只依赖 Node.js，不再依赖 Python：
 
 - `arena -p ...`：headless 单轮入口，支持文本、完整 JSON 和 NDJSON 流。
 - `arena tui`：终端多轮对话，实时输出并自动保存、恢复历史。
 - `arena serve`：HTTP daemon、Web UI 与双通道 SSE 实时接口。
 - Agent loop：流式 assistant → tool call → tool result → assistant。
-- 11 个工具逐字使用 `tools.json` 的 Draft-07 schema。
+- 11 个工具按照 `tools.json` 中的 Draft-07 schema 提供参数校验。
+
+本文提及的第三方产品、模型与服务名称仅用于说明兼容性和配置方式，不表示相关
+权利人对本项目的认可或背书；相关商标归各自权利人所有。使用者应自行确认并遵守
+所接入模型、数据源和在线服务的许可、服务条款及适用法律。
 
 ## 源码与 SDK 安装
 
@@ -99,9 +103,9 @@ arena serve --system-prompt '只使用中文回复。'
 续跑已有 session 时，当前传入的值会替换历史中的 system message。未传参数时，
 日期、workspace 和 mode 对应的现有 prompt 生成逻辑保持不变。
 
-`arena serve` 是一个例外：未显式传入 `--system-prompt` 时，它会保留原系统提示词
-中的日期、workspace、工具和 mode 指令，但默认将身份声明改为 `Qwen`，并移除
-`Arena.ai` 身份描述。显式传入 `--system-prompt` 时仍会完整替换系统提示词。
+`arena serve` 是一个例外：未显式传入 `--system-prompt` 时，它会保留现有系统
+提示词中的日期、workspace、工具和 mode 指令，但默认将身份声明设为 `Qwen`。
+显式传入 `--system-prompt` 时仍会完整替换系统提示词。
 
 Arena 模式下，如需从 system prompt 的身份模型列表中移除 `Qwen`，可增加
 `--exclude-qwen-from-system-prompt`，或设置
@@ -113,7 +117,7 @@ arena tui --exclude-qwen-from-system-prompt
 arena serve --exclude-qwen-from-system-prompt
 ```
 
-三个 Code Arena 模式的 150 个历史 case、工具 replay 和真实模型行为实验入口见
+三个 Code Arena 模式的兼容性测试集、工具回归测试和模型行为评估入口见
 [`tasks/code-harness/README.md`](tasks/code-harness/README.md)；这些开发数据不会
 进入 npm 或 SEA 发布包。
 
@@ -177,11 +181,11 @@ Anthropic 直连在原生协议上完整支持 thinking。旧版 Claude 和非 C
 budget。Anthropic 要求启用 thinking 时不调整 temperature，此时不发送该
 参数。带签名的 thinking/redacted_thinking block 会原样保存在对应 assistant
 消息的 `reasoning_details` 字段——
-Anthropic 要求 tool-use 续跑时回传签名 thinking block，重放历史时会按
+Anthropic 要求 tool-use 续跑时回传签名 thinking block，恢复历史上下文时会按
 原顺序还原；无签名的 thinking block（部分网关返回 `signature: ""`）
-不参与重放，因为协议不需要它们，而且某些网关收到会挂起。
+不会再次发送，因为协议不需要它们，而且某些网关收到会挂起。
 `reasoning_content` 仍是纯文本推理，历史契约不变。向
-OpenAI-compatible 服务重放同一份历史时，`reasoning_details` 与 `usage`
+OpenAI-compatible 服务发送同一份历史时，`reasoning_details` 与 `usage`
 一样在 wire 边界剥离。usage 会映射为 OpenAI 风格字段（`prompt_tokens`
 含 cache 创建/读取部分），同时保留 `input_tokens`、
 `cache_read_input_tokens` 等原生字段。`OPENAI_BASE_URL` 对 anthropic
@@ -234,7 +238,7 @@ Jina Reader。
 Harness 会在每次模型调用前估算消息、reasoning、工具 schema 和图片占用；达到
 `ARENA_CONTEXT_WINDOW × ARENA_CONTEXT_COMPACTION_RATIO`（默认 80%）时，调用
 当前模型把已完成的旧回合生成结构化续作摘要。只有发给模型的内存上下文会把
-旧前缀替换为与 Arena trace 一致的 leading `<arena-system-message>`；持久化的
+旧前缀替换为符合既有会话格式的 leading `<arena-system-message>`；持久化的
 `history.json.messages` 保留原始消息，不会因压缩删除或替换前缀。当前用户回合及
 其后的 tool-call / result 链在模型上下文中保持原样。摘要重点保留目标、硬约束、
 发现、已完成/未完成事项、下一步和相关文件路径；摘要调用默认关闭 thinking，
@@ -242,14 +246,14 @@ Harness 会在每次模型调用前估算消息、reasoning、工具 schema 和
 `ARENA_COMPACTION_SUMMARY_MAX_TOKENS` 控制（默认 8192）。
 
 `ARENA_CONTEXT_WINDOW` 应设置为所用模型的真实上下文窗口；默认 `1000000` 是
-当前 trace 模型的暂定值。token 数目前是本地保守估算，并非 provider tokenizer
+当前默认模型的暂定值。token 数目前是本地保守估算，并非 provider tokenizer
 的精确计数。如果摘要请求失败，Harness 会保留原历史并继续正常模型请求，避免
 摘要服务的瞬时故障直接中断任务。
 
 每次模型请求都会通过 OpenAI-compatible 的 `stream_options.include_usage`
 请求 token 用量，并把服务端在最终 chunk 上报的 `usage` 对象原样记录到该轮
 assistant 消息的 `usage` 字段（`history.json` 与事件流中均可见），供训练
-和成本统计使用。向模型重放历史时，`usage` 会在 wire 边界剥离，不会发回
+和成本统计使用。再次发送历史上下文时，`usage` 会在 wire 边界剥离，不会发回
 服务端。`model.complete` 事件同样携带该轮 `usage`；上下文压缩的摘要调用
 不会在历史中留下消息，其用量通过 `compaction` 事件上报，只在事件流中可
 见。不支持 `stream_options` 的服务可通过 `ARENA_EXTRA_BODY` 覆盖该参数。
@@ -377,17 +381,17 @@ arena -p 'redraw this photo with the reference face' \
 每个附件会被保存到工作区 `uploads/`（模型内可通过
 `/home/user/uploads/<name>` 访问；重名自动加 `-2`、`-3` 后缀，URL 无扩展名
 时按图片字节特征补全扩展名）。本轮 user message 与 daemon 附件上传共用同
-一构造逻辑，并使用与 Arena trace 相同的原生部件格式：图片部件
+一构造逻辑，并使用统一的会话部件格式：图片部件
 `{"image": ...}` 在前，随后是 prompt 文本 `{"text": ...}`，最后追加一条
 `<arena-system-message>`，列出保存到 `/home/user/uploads/` 的文件名。单条
 消息最多 10 个附件，单个附件上限 20 MB、总量上限 50 MB，与 daemon 一致。
 
 多模态 user 消息（附件、图片 `read_file` 回灌、中断通知）在历史与事件流中
-一律使用 Arena 原生部件 `{"image": ...}` / `{"text": ...}`，与 baseline
-trace 逐字段同构；仅在向模型发起 chat-completions 请求的边界处转换为
+一律使用 `{"image": ...}` / `{"text": ...}` 原生部件并保持字段格式一致；仅在
+向模型发起 chat-completions 请求的边界处转换为
 OpenAI 风格的 `image_url` 部件。`--attach` 传 URL 时 `image` 直接记录该
-URL（与 baseline 引用附件的方式一致，模型服务端会自行下载；重放历史要求
-该 URL 仍可访问）；本地文件没有可引用的 URL，`image` 存自包含的 base64
+URL（模型服务端会自行下载；恢复历史上下文时要求该 URL 仍可访问）；本地文件
+没有可引用的 URL，`image` 存自包含的 base64
 data-URI。
 
 `stream-json` 每行一个 JSON 对象。`start`、`message`、`result` 事件中的
@@ -401,7 +405,7 @@ data-URI。
 
 `assistant.delta` 实时提供 content、reasoning 与 tool-call 参数碎片；
 `model.start`、`model.complete`、`model.retry`、`tool.start`、`tool.complete`
-标记阶段。最后的 `result` 带完整可重放消息。
+标记阶段。最后的 `result` 带完整消息。
 
 `ask_user` 只有在注入 handler 时才会提供给模型。TUI 和 WebUI 使用真人交互
 handler；headless（`-p`）默认仍不开放该工具，但可配置远程 User Agent handler：
@@ -692,7 +696,7 @@ curl -N -X POST \
 
 ## 工具
 
-原始规范在源码仓库中逐字保存在：
+消息与工具契约配置保存在：
 
 - `spec/message.json`
 - `spec/tools.json`
@@ -706,35 +710,32 @@ Draft-07 schema。repo mode 的动态提示词模板保存在 `src/prompts.ts`
 `generate_speech`。
 
 `web_search` 使用 Routify 网关提供的 Brave LLM Context，从工作区 `.env`
-读取 `ROUTIFY_API_KEY`，默认调用
-`https://routify-pub.alibaba-inc.com/protocol/compatible-mode/res/v1/llm/context`
-并使用 `brave.llm-context` 路由。实现按 depth 请求最多 3/5/8 条结果，并将
+读取 `ROUTIFY_API_KEY`，默认通过内置的 ModelRouter 兼容接口调用
+`brave.llm-context` 路由。实现按 depth 请求最多 3/5/8 条结果，并将
 `grounding.generic` 的内容片段及 `sources` 的来源信息转换成 Arena 的既有工具
 结果。请求固定考虑最多 20 个搜索候选，再通过 `maximum_number_of_urls` 将
 最终来源数限制为 3/5/8。depth 还分别对应 1024/3072/8192 的总 token 预算和
 512/552/2048 的单 URL token 预算；description 使用预算内的全部 grounding
 snippets，仅在没有 grounding 内容时回退到来源摘要。三个 Code Arena 模式
-使用独立的复刻参数：来源数 3/5/10、总 token 预算 1280/4096/6144、单 URL
+使用独立的模式参数：来源数 3/5/10、总 token 预算 1280/4096/6144、单 URL
 token 预算 512/1280/1536。
 可用 `ROUTIFY_WEB_SEARCH_URL` 和 `ARENA_WEB_SEARCH_MODEL` 覆盖默认值。
 
 `image_search` 使用 Routify 网关提供的 Brave Images Search，同样读取
-`ROUTIFY_API_KEY`，通过 `X-Subscription-Token` 发送 GET 请求。默认接口为
-`https://routify-pub.alibaba-inc.com/protocol/brave/res/v1/images/search`，可用
-`ROUTIFY_IMAGE_SEARCH_URL` 覆盖。实现优先下载 Brave 返回的原图地址，原图不可用
+`ROUTIFY_API_KEY`，通过 `X-Subscription-Token` 发送 GET 请求。默认使用内置的
+ModelRouter 兼容接口，可用 `ROUTIFY_IMAGE_SEARCH_URL` 覆盖。实现优先下载 Brave
+返回的原图地址，原图不可用
 时回退到 Brave 代理缩略图，并保持既有工具结果格式和工作区文件命名不变。
 
 Arena 的 `fetch_page` 和 Code Arena 的 `web_fetch` 默认仍使用本地抓取与正文
-解析。设置 `CODE_HARNESS_ROUTIFY_WEB_FETCH_ENABLED=true` 后，两者改走 Routify 的
-`POST /protocol/search/tools`：先使用 `readpage-firecrawl-inner`，调用失败、HTTP
-非 200 或响应不可用时回退到 `readpage-jina-inner`；两者都失败则返回普通工具
+解析。设置 `CODE_HARNESS_ROUTIFY_WEB_FETCH_ENABLED=true` 后，两者改走 Routify
+页面读取接口，并在首选读取服务不可用时使用备用服务；两者都失败则返回普通工具
 错误。`fetch_page` 仍按 8000 字符分块并缓存同一 URL 的后续 chunk。认证复用
 `ROUTIFY_API_KEY`。
 
 `generate_image`、`generate_speech` 使用 ModelRouter/Routify，并从工作区
-`.env` 读取 `ROUTIFY_API_KEY`。两个工具均锚定 Google 原厂协议，通过
-`/protocol/vertex/v1beta/models/{model}:generateContent` 调用；可用
-`ROUTIFY_VERTEX_BASE_URL` 覆盖 `/protocol/vertex/v1beta` 根地址。
+`.env` 读取 `ROUTIFY_API_KEY`。两个工具均使用 Google 兼容协议调用；可用
+`ROUTIFY_VERTEX_BASE_URL` 覆盖默认根地址。
 
 `fetch_page` 使用 Defuddle 将 HTML 正文转换为 Markdown，并使用
 `pdf-parse` 提取 PDF 的前 30 页。响应按 Markdown 边界稳定分块，同一轮内

package/dist/audit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Non-secret description of an endpoint: the origin is recorded as-is, while
+ * the path is reduced to a hash so that same-origin routes stay distinguishable
+ * without writing userinfo, tokens, query strings or fragments to disk.
+ */
+export declare function describeUrlForAudit(value: string): {
+    origin: string;
+    fingerprint: string | null;
+};
+/**
+ * Hash of an already normalized, credential-free descriptor. Use it when two
+ * runs must be distinguishable without recording the value itself.
+ */
+export declare function fingerprintForAudit(value: string): string;

package/dist/audit.js

@@ -0,0 +1,31 @@
+import { createHash } from "node:crypto";
+/**
+ * Non-secret description of an endpoint: the origin is recorded as-is, while
+ * the path is reduced to a hash so that same-origin routes stay distinguishable
+ * without writing userinfo, tokens, query strings or fragments to disk.
+ */
+export function describeUrlForAudit(value) {
+    try {
+        const parsed = new URL(value);
+        if (parsed.origin === "null") {
+            return { origin: "invalid-url", fingerprint: null };
+        }
+        return {
+            origin: parsed.origin,
+            fingerprint: createHash("sha256")
+                .update(parsed.origin + parsed.pathname)
+                .digest("hex"),
+        };
+    }
+    catch {
+        return { origin: "invalid-url", fingerprint: null };
+    }
+}
+/**
+ * Hash of an already normalized, credential-free descriptor. Use it when two
+ * runs must be distinguishable without recording the value itself.
+ */
+export function fingerprintForAudit(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAI/C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC7B,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QACtD,CAAC;QACD,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,UAAU,CAAC,QAAQ,CAAC;iBAC9B,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;iBACvC,MAAM,CAAC,KAAK,CAAC;SACjB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACtD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC"}

package/dist/dashscope.d.ts

@@ -0,0 +1,5 @@
+export declare function record(value: unknown): Record<string, unknown>;
+export declare function stringValue(value: unknown): string;
+export declare function dashScopeRoot(): string;
+export declare function dashScopeFetch(protocol: "api" | "compatible", pathname: string, init: RequestInit, label: string): Promise<Response>;
+export declare function dashScopeJson(protocol: "api" | "compatible", pathname: string, init: RequestInit, label: string): Promise<Record<string, unknown>>;

package/dist/dashscope.js

@@ -0,0 +1,55 @@
+export function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+export function stringValue(value) {
+    return typeof value === "string" ? value : "";
+}
+function dashScopeApiKey() {
+    const apiKey = process.env.DASHSCOPE_API_KEY;
+    if (!apiKey) {
+        throw new Error("DashScope tools require DASHSCOPE_API_KEY");
+    }
+    return apiKey;
+}
+export function dashScopeRoot() {
+    return (process.env.DASHSCOPE_API_BASE ||
+        process.env.DASHSCOPE_BASE_URL ||
+        "https://dashscope.aliyuncs.com")
+        .replace(/\/+$/, "")
+        .replace(/\/(?:api\/v1|compatible-mode\/v1)$/i, "");
+}
+function dashScopeUrl(protocol, pathname) {
+    const prefix = protocol === "api" ? "/api/v1" : "/compatible-mode/v1";
+    const normalized = pathname.startsWith("/") ? pathname : `/${pathname}`;
+    return `${dashScopeRoot()}${prefix}${normalized}`;
+}
+export async function dashScopeFetch(protocol, pathname, init, label) {
+    const headers = new Headers(init.headers);
+    headers.set("authorization", `Bearer ${dashScopeApiKey()}`);
+    const response = await fetch(dashScopeUrl(protocol, pathname), {
+        ...init,
+        headers,
+    });
+    if (response.ok)
+        return response;
+    const body = await response.text();
+    let detail = body;
+    try {
+        const payload = record(JSON.parse(body));
+        detail =
+            stringValue(payload.message) ||
+                stringValue(record(payload.error).message) ||
+                body;
+    }
+    catch {
+        // Keep the response text as the diagnostic.
+    }
+    throw new Error(`${label} failed (${response.status} ${response.statusText}): ${detail.slice(0, 2000)}`);
+}
+export async function dashScopeJson(protocol, pathname, init, label) {
+    const response = await dashScopeFetch(protocol, pathname, init, label);
+    return record(await response.json());
+}
+//# sourceMappingURL=dashscope.js.map

package/dist/dashscope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashscope.js","sourceRoot":"","sources":["../src/dashscope.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,eAAe;IACtB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAC9B,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAC9B,gCAAgC,CACjC;SACE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,OAAO,CAAC,qCAAqC,EAAE,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,YAAY,CACnB,QAA8B,EAC9B,QAAgB;IAEhB,MAAM,MAAM,GAAG,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC;IACtE,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;IACxE,OAAO,GAAG,aAAa,EAAE,GAAG,MAAM,GAAG,UAAU,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAA8B,EAC9B,QAAgB,EAChB,IAAiB,EACjB,KAAa;IAEb,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,eAAe,EAAE,EAAE,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE;QAC7D,GAAG,IAAI;QACP,OAAO;KACR,CAAC,CAAC;IACH,IAAI,QAAQ,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAC;IAEjC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,MAAM;YACJ,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC;gBAC5B,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;gBAC1C,IAAI,CAAC;IACT,CAAC;IAAC,MAAM,CAAC;QACP,4CAA4C;IAC9C,CAAC;IACD,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,YAAY,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CACxF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAA8B,EAC9B,QAAgB,EAChB,IAAiB,EACjB,KAAa;IAEb,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACvE,OAAO,MAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACvC,CAAC"}

package/dist/fetch-page/aparat.d.ts

@@ -0,0 +1,30 @@
+import type { ParsedPage, SiteAdapterContext } from "./types.js";
+/**
+ * Aparat adapter.
+ *
+ * Only the profile page types observed in the source history are covered, and
+ * every value comes from Aparat's current public API rather than a replayed
+ * snapshot — live figures are expected to differ from the history. Per the
+ * golden spec this is an [H] local choice.
+ */
+export interface AparatTarget {
+    kind: "aparat";
+    username: string;
+    tab: string;
+}
+export declare function matchAparat(url: URL, hostname: string): AparatTarget | undefined;
+export declare function aparatShellReason(html: string): string | undefined;
+interface AparatProfile {
+    id: string;
+    name: string;
+    avatar: string;
+    followers: string;
+    videoCount: string;
+    totalVisit: string;
+    description: string;
+    startDate: string;
+    monthVisit: string;
+}
+export declare function aparatPage(target: AparatTarget, profile: AparatProfile, finalUrl: string, videos?: Record<string, unknown>[], shorts?: Record<string, unknown>[]): ParsedPage | undefined;
+export declare function loadAparat(target: AparatTarget, ctx: SiteAdapterContext): Promise<ParsedPage | undefined>;
+export {};

package/dist/fetch-page/aparat.js

@@ -0,0 +1,209 @@
+import { jsonObject, recordArray, recordValue, stringField } from "./json-path.js";
+import { normalizeMarkdown, requireReadableContent } from "./text.js";
+export function matchAparat(url, hostname) {
+    if (hostname !== "aparat.com")
+        return undefined;
+    const match = url.pathname.match(/^\/([^/]+?)(?:\/(about|short-videos|videos))?\/?$/);
+    const username = match?.[1] || "";
+    if (!username || ["etc", "video", "v", "login"].includes(username)) {
+        return undefined;
+    }
+    return { kind: "aparat", username, tab: match?.[2] || "home" };
+}
+export function aparatShellReason(html) {
+    return /enable javascript/i.test(html) ||
+        /جاوا\s*اسکریپت[^<]{0,80}فعال/i.test(html)
+        ? "requires JavaScript"
+        : undefined;
+}
+function aparatProfile(value) {
+    const legacyProfile = recordValue(value.profile);
+    const data = recordValue(value.data);
+    const attributes = recordValue(data?.attributes);
+    const fields = attributes || legacyProfile;
+    if (!fields)
+        return undefined;
+    return {
+        id: stringField(data || fields, "id") || stringField(fields, "userid"),
+        name: stringField(fields, "name"),
+        avatar: stringField(fields, "pic_m") || stringField(fields, "pic_b"),
+        followers: stringField(fields, "follower_cnt").trim(),
+        videoCount: stringField(fields, "video_cnt").trim(),
+        totalVisit: stringField(fields, "video_visit").trim() ||
+            stringField(fields, "total_visit").trim(),
+        description: stringField(fields, "description") || stringField(fields, "descr"),
+        startDate: stringField(fields, "start_date_jalali"),
+        monthVisit: stringField(fields, "month_visit").trim(),
+    };
+}
+function mergeAparatAbout(profile, value) {
+    const meta = recordValue(value?.meta);
+    const data = recordValue(meta?.data);
+    if (!data)
+        return profile;
+    return {
+        ...profile,
+        description: stringField(data, "description") || profile.description,
+        videoCount: stringField(data, "video_cnt").trim() || profile.videoCount,
+        totalVisit: stringField(data, "total_visit").trim() || profile.totalVisit,
+        startDate: stringField(data, "start_date_jalali") || profile.startDate,
+        monthVisit: stringField(data, "month_visit").trim() || profile.monthVisit,
+    };
+}
+function aparatVideos(value) {
+    if (!value)
+        return [];
+    const legacy = recordArray(value.videobyuser);
+    if (legacy.length)
+        return legacy;
+    return recordArray(value.included).flatMap((item) => {
+        if (item.type !== "Video")
+            return [];
+        const attributes = recordValue(item.attributes);
+        return attributes ? [attributes] : [];
+    });
+}
+function aparatShorts(value) {
+    const data = recordValue(value?.data);
+    return recordArray(data?.posts);
+}
+export function aparatPage(target, profile, finalUrl, videos = [], shorts = []) {
+    const name = profile.name || target.username;
+    const root = `https://www.aparat.com/${encodeURIComponent(target.username)}`;
+    const lines = [
+        ...(profile.avatar ? [`![${name}](${profile.avatar})`] : []),
+        "",
+        `## ${name}`,
+        "",
+        "دنبال کردن",
+        ...(profile.followers ? ["", `${profile.followers} دنبال‌کننده`] : []),
+        ...(profile.totalVisit ? ["", `${profile.totalVisit} بازدید کل`] : []),
+        "",
+        `- [خانه](${root})`,
+        `- [ویدیو‌ها](${root}/videos)`,
+        `- [ویدیوهای کوتاه](${root}/short-videos)`,
+        `- [لیست‌های پخش](${root}/playlists)`,
+        `- [درباره کانال](${root}/about)`,
+    ];
+    if (target.tab === "about") {
+        lines.push("", "درباره کانال", "", profile.description);
+        if (profile.totalVisit)
+            lines.push("", `بازدید کل${profile.totalVisit}`);
+        if (profile.startDate)
+            lines.push("", `شروع فعالیت${profile.startDate}`);
+        if (profile.monthVisit)
+            lines.push("", `بازدید این ماه${profile.monthVisit}`);
+        if (profile.videoCount)
+            lines.push("", `تعداد ویدیو${profile.videoCount}`);
+    }
+    if (target.tab === "short-videos") {
+        lines.push("", "همه ویدیوهای کوتاه", "", "- تازه‌ترین", "- پربازدید ترین");
+        for (const short of shorts) {
+            const title = stringField(short, "description") || "ویدیوی کوتاه";
+            const id = stringField(short, "id");
+            const cover = recordValue(short.cover);
+            const stats = recordValue(short.stats);
+            const poster = stringField(cover || {}, "cdn_link");
+            const views = stringField(stats || {}, "views");
+            if (!id)
+                continue;
+            const shortUrl = `https://aparat.com/shorts/${id}`;
+            if (poster) {
+                lines.push("", `[![${title}](${poster})\\\\`, `\\\\`, `${views}](${shortUrl})`);
+            }
+            lines.push("", `[${title}](${shortUrl})`);
+        }
+    }
+    if (target.tab === "videos") {
+        lines.push("", "همه ویدیوها");
+        for (const video of videos) {
+            const videoTitle = stringField(video, "title");
+            const uid = stringField(video, "uid");
+            const poster = stringField(video, "big_poster") || stringField(video, "small_poster");
+            if (!videoTitle || !uid)
+                continue;
+            if (poster)
+                lines.push("", `![${videoTitle}](${poster})`);
+            lines.push(`- [${videoTitle}](https://www.aparat.com/v/${uid})`);
+        }
+    }
+    if (target.tab === "home") {
+        if (!videos.length && profile.videoCount === "0") {
+            lines.push("", "![no result video](https://www.aparat.com/redesign/static/img/empty-box-v2/light/empty-video.gif)", "", "### این کانال محتوایی ندارد!", "", "هنوز هیچ ویدیویی در این کانال منتشر نشده است.");
+        }
+        else if (videos.length) {
+            lines.push("", "آخرین ویدیوها");
+            for (const video of videos) {
+                const videoTitle = stringField(video, "title");
+                const uid = stringField(video, "uid");
+                const poster = stringField(video, "big_poster") || stringField(video, "small_poster");
+                if (!videoTitle || !uid)
+                    continue;
+                if (poster)
+                    lines.push("", `![${videoTitle}](${poster})`);
+                lines.push(`[${videoTitle}](https://www.aparat.com/v/${uid})`);
+            }
+        }
+    }
+    return {
+        finalUrl,
+        contentType: "text/html",
+        markdown: requireReadableContent(normalizeMarkdown(lines.join("\n"))),
+        title: `آپارات | ${name}`,
+    };
+}
+export async function loadAparat(target, ctx) {
+    try {
+        const username = encodeURIComponent(target.username);
+        let profilePayload;
+        try {
+            const profileResponse = await ctx.download(`https://www.aparat.com/api/fa/v1/user/user/information/username/${username}`);
+            profilePayload = jsonObject(profileResponse.bytes, profileResponse.contentType);
+        }
+        catch {
+            ctx.throwIfAborted();
+            const profileResponse = await ctx.download(`https://www.aparat.com/etc/api/profile/username/${username}`);
+            profilePayload = jsonObject(profileResponse.bytes, profileResponse.contentType);
+        }
+        let profile = aparatProfile(profilePayload);
+        if (!profile)
+            return undefined;
+        let videos = [];
+        let shorts = [];
+        try {
+            if (target.tab === "about") {
+                const response = await ctx.download(`https://www.aparat.com/api/fa/v1/user/user/about/username/${username}`);
+                profile = mergeAparatAbout(profile, jsonObject(response.bytes, response.contentType));
+            }
+            else if (target.tab === "short-videos" && profile.id) {
+                const response = await ctx.download(`https://shorts.aparat.com/api/v1/web/profile/${encodeURIComponent(profile.id)}/posts`);
+                shorts = aparatShorts(jsonObject(response.bytes, response.contentType));
+            }
+            else {
+                const endpoint = target.tab === "home"
+                    ? `user/user/profilehome_v2/username/${username}`
+                    : `user/video/list/username/${username}`;
+                const response = await ctx.download(`https://www.aparat.com/api/fa/v1/${endpoint}`);
+                videos = aparatVideos(jsonObject(response.bytes, response.contentType));
+            }
+        }
+        catch {
+            ctx.throwIfAborted();
+            if (target.tab === "videos") {
+                try {
+                    const response = await ctx.download(`https://www.aparat.com/etc/api/videoByUser/username/${username}/perpage/10`);
+                    videos = aparatVideos(jsonObject(response.bytes, response.contentType));
+                }
+                catch {
+                    ctx.throwIfAborted();
+                }
+            }
+        }
+        return aparatPage(target, profile, ctx.finalUrl, videos, shorts);
+    }
+    catch {
+        ctx.throwIfAborted();
+        return undefined;
+    }
+}
+//# sourceMappingURL=aparat.js.map

package/dist/fetch-page/aparat.js.map

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

package/dist/fetch-page/json-path.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Navigation helpers for the undocumented JSON blobs embedded in dynamic site
+ * pages. Every accessor is total: a missing or wrongly typed field yields an
+ * empty value rather than throwing, because these shapes change without notice.
+ */
+export declare function jsonObject(bytes: Uint8Array, contentType: string): Record<string, unknown>;
+export declare function stringField(value: Record<string, unknown>, key: string): string;
+export declare function recordValue(value: unknown): Record<string, unknown> | undefined;
+export declare function recordArray(value: unknown): Record<string, unknown>[];
+export declare function findNestedValue(value: unknown, key: string): unknown;
+export declare function findNestedRecord(value: unknown, predicate: (record: Record<string, unknown>) => boolean): Record<string, unknown> | undefined;
+export declare function extractAssignedJson(html: string, marker: string): Record<string, unknown> | undefined;