@roll-agent/browser-use-agent 0.8.0 → 0.9.0

package/dist/pages/zhipin/native-page.d.ts

@@ -76,6 +76,15 @@ export type NativeRecommendCardInspection = {
     readonly cardSelector: string;
     readonly candidateId: string;
     readonly name: string;
+    readonly age?: string;
+    readonly experience?: string;
+    readonly education?: string;
+    readonly workStatus?: string;
+    readonly company?: string;
+    readonly currentPosition?: string;
+    readonly expectedLocation?: string;
+    readonly expectedPosition?: string;
+    readonly expectedSalary?: string;
     readonly hasGreetButton: boolean;
     readonly error?: string;
 };

package/dist/recruitment-events/client.d.ts

@@ -0,0 +1,41 @@
+import type { AgentLogger } from "@roll-agent/sdk";
+export declare const RECRUITMENT_EVENT_TYPES: readonly ["message_received", "message_sent", "candidate_contacted", "wechat_exchanged"];
+type RecruitmentEventType = (typeof RECRUITMENT_EVENT_TYPES)[number];
+type RecruitmentCandidate = {
+    readonly name: string;
+    readonly position: string;
+    readonly age?: string;
+    readonly gender?: string;
+    readonly education?: string;
+    readonly expectedSalary?: string;
+    readonly expectedLocation?: string;
+};
+type RecruitmentJob = {
+    readonly jobId?: number;
+    readonly jobName?: string;
+};
+type RecruitmentEventDetails = Readonly<Record<string, string | number | boolean | undefined>>;
+export type RecruitmentEventPayload = {
+    readonly idempotencyKey: string;
+    readonly agentId: string;
+    readonly sourcePlatform: "zhipin";
+    readonly dataSource: "api_callback";
+    readonly eventType: RecruitmentEventType;
+    readonly eventTime: string;
+    readonly candidate: RecruitmentCandidate;
+    readonly job?: RecruitmentJob;
+    readonly details: RecruitmentEventDetails;
+};
+export type RecruitmentEventDraft = Omit<RecruitmentEventPayload, "agentId" | "eventTime"> & {
+    readonly eventTime?: string;
+};
+type RecruitmentEventPostDeps = {
+    readonly fetch: typeof fetch;
+    readonly env: NodeJS.ProcessEnv;
+};
+type RecruitmentEventRecorder = (event: RecruitmentEventDraft, logger: AgentLogger) => Promise<void> | void;
+export declare function buildRecruitmentIdempotencyKey(prefix: string, parts: ReadonlyArray<string | number | boolean | undefined>): string;
+export declare function recordRecruitmentEventAsync(event: RecruitmentEventDraft, logger: AgentLogger): void;
+export declare function setRecruitmentEventRecorderForTests(recorder: RecruitmentEventRecorder | undefined): void;
+export declare function setRecruitmentEventPostDepsForTests(deps: Partial<RecruitmentEventPostDeps> | undefined): void;
+export {};

package/dist/recruitment-events/zhipin-events.d.ts

@@ -0,0 +1,34 @@
+import type { AgentLogger } from "@roll-agent/sdk";
+import type { NativeCandidateChatDetails, NativeRecommendGreetResult } from "../pages/zhipin/native-page.ts";
+type ZhipinUnreadCandidate = {
+    readonly conversationId: string;
+    readonly candidateId: string;
+    readonly name: string;
+    readonly position: string;
+    readonly preview: string;
+    readonly unreadCount: number;
+    readonly hasUnread: boolean;
+};
+type ZhipinMessageSentInput = {
+    readonly conversationId: string;
+    readonly candidateId: string;
+    readonly replyId: string;
+    readonly candidateName: string;
+    readonly message: string;
+    readonly unreadCountBeforeReply: number;
+    readonly candidateDetails?: NativeCandidateChatDetails;
+};
+type ZhipinWechatRequestedInput = {
+    readonly conversationId: string;
+    readonly candidateId: string;
+    readonly candidateName: string;
+    readonly exchangeType?: "requested" | "accepted";
+    readonly wechatNumber?: string;
+    readonly candidateDetails?: NativeCandidateChatDetails;
+};
+export declare function recordZhipinMessageReceivedEvents(candidates: ReadonlyArray<ZhipinUnreadCandidate>, logger: AgentLogger): void;
+export declare function recordZhipinMessageSentEvent(input: ZhipinMessageSentInput, logger: AgentLogger): void;
+export declare function recordZhipinCandidateContactedEvent(result: NativeRecommendGreetResult, logger: AgentLogger): void;
+export declare function recordZhipinWechatRequestedEvent(input: ZhipinWechatRequestedInput, logger: AgentLogger): void;
+export declare function recordZhipinWechatCompletedEvents(details: NativeCandidateChatDetails, conversationId: string, candidateId: string, logger: AgentLogger): void;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/browser-use-agent",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "type": "module",
   "repository": {
     "type": "git",

package/references/env.yaml

@@ -2,7 +2,21 @@ required:
   - name: REPLY_AUTHORITY_KEYS_URL
     purpose: Reply Authority Service 公钥分发端点；`zhipin_send_reply` 启动预热和本地 Ed25519 验签都依赖它
     example: https://reply-authority.duliday.com/.well-known/reply-authority-keys
+  - name: RECRUITMENT_EVENTS_DEFAULT_AGENT_ID
+    purpose: 单 browser-use 实例 / 单 Boss 账号部署下的默认招聘业务 Agent ID；招聘事件默认启用，上报时必须用它做归因
+    example: zhipin-shanghai-kfc-001
+  - name: RECRUITMENT_EVENTS_API_TOKEN
+    purpose: 招聘事件 Open API Bearer token；公开 npm 包不内置兜底 token，必须由部署环境提供
+    example: token_xxx
 optional:
+  - name: RECRUITMENT_EVENTS_ENABLED
+    purpose: 是否启用招聘事件埋点上报；未设置时默认启用，设为 `"false"` 可关闭
+    default: "true"
+    example: "false"
+  - name: RECRUITMENT_EVENTS_API_BASE_URL
+    purpose: 招聘事件 Open API base URL；工具成功后会调用 `/api/v1/recruitment-events`
+    default: https://huajune.duliday.com
+    example: https://example.com
   - name: BROWSER_VISUAL_CURSOR
     purpose: 在可见浏览器页面内显示 browser-use 的页内虚拟指针和点击波纹；默认开启，设为 `"false"` 可关闭
     default: "true"