shennian 0.2.105 → 0.2.107

package/dist/src/channels/wechat-channel/observer.js

@@ -1,6 +1,6 @@
-import{defaultWeChatChannelAttachmentDir as _e,resolveVisibleWeChatChannelMedia as Te}from"./media-resolver.js";import{updateWeChatChannelBindingLedger as We}from"./ledger.js";import{defaultWeChatChannelVectorStorePath as Be,loadWeChatChannelVectorStore as Ae,saveWeChatChannelVectorStore as Ee,upsertWeChatChannelVectorReferences as Fe}from"./vector-store.js";import{normalizeWeChatChannelAttachmentAvailability as H,normalizeWeChatChannelMessageKind as Re}from"./core/schema.js";import{waitForWeChatChannelPacing as Y,weChatChannelPacingDelayMs as Le}from"./pacing.js";import{matchWeChatConversationFingerprints as Oe}from"./fingerprint.js";import{normalizeWeChatAnchorText as v,weChatTextSimilarity as X}from"./anchor.js";import{decideWeChatChannelActivityGate as $e,normalizeWeChatChannelActivitySnapshot as ze}from"./human-coordination.js";const De=3,Pe=5,D="wechat_login_required",F="wechat_duplicate_instance";class T extends Error{reasonCode;stage;action;constructor(t){super(`user_active:${t.reasonCode}:${t.stage}:${t.action}`),this.name="WeChatChannelUserActivityAbort",this.reasonCode=t.reasonCode,this.stage=t.stage,this.action=t.action}}async function sn(e){return await Ve(e.helper,e.activityGuard,e.traceId).withLease("observe","observe-binding",async n=>Ke({...e,helper:n}))}async function Ke(e){const t=e.foregroundMode??"required";let n=await bt(e.helper,e.traceId,{foreground:t});if(t!=="background"&&(n=await Ct(e.helper,n,e.traceId)),t==="background"){const{capture:a,ocr:s}=await M({helper:e.helper,window:n,traceId:e.traceId}),c=B({capture:a,ocr:s,window:n});if(c)throw new Error(c);if(!$(s,a,e.binding.conversationDisplayName))throw new Error("conversation_not_visible_background");if(j({capture:a,ocr:s,binding:e.binding}))throw new Error("wechat_window_obstructed_background");return e.onObservationEvidence?.({window:n,capture:a,ocr:s}),J(e)?Q({...e,window:n,capture:a,ocr:s}):P({...e,window:n,capture:a,ocr:s})}const i=await fe({helper:e.helper,window:n,binding:e.binding,traceId:e.traceId});if(!i.opened)throw new Error(i.reason||"conversation_not_opened");let{capture:r,ocr:o}=await M({helper:e.helper,window:n,traceId:e.traceId});if(j({capture:r,ocr:o,binding:e.binding})){n=await kt(e.helper,e.traceId);const a=await fe({helper:e.helper,window:n,binding:e.binding,traceId:e.traceId});if(!a.opened)throw new Error(a.reason||"wechat_window_obstructed");if({capture:r,ocr:o}=await M({helper:e.helper,window:n,traceId:e.traceId}),j({capture:r,ocr:o,binding:e.binding}))throw new Error("wechat_window_obstructed")}return e.onObservationEvidence?.({window:n,capture:r,ocr:o}),J(e)?Q({...e,window:n,capture:r,ocr:o}):P({...e,window:n,capture:r,ocr:o})}function Ve(e,t,n){if(!t)return{helper:e,withLease:async(s,c,d)=>await d(e)};let i=null;const r=s=>{t.onEvent?.({...s,at:new Date().toISOString()})},o=async(s,c)=>{if(i){const u=await e.request("automation.lease.status",{},n),h=u.result??{},w=u.ok&&h.interrupted?Z(h.interruptReason):u.ok?void 0:u.errorCode||"user_activity_unknown";if(r({phase:"lease-status",stage:s,action:c,ok:u.ok===!0&&!h.interrupted,...w?{reasonCode:w}:{}}),!u.ok)throw new T({reasonCode:u.errorCode||"user_activity_unknown",stage:s,action:c});if(h.active===!1||h.leaseId!==i||!h.interrupted)return;throw new T({reasonCode:Z(h.interruptReason),stage:s,action:c})}const d=await e.request("activity.snapshot",{},n);if(!d.ok)throw r({phase:"snapshot",stage:s,action:c,ok:!1,reasonCode:d.errorCode||"user_activity_unknown"}),new T({reasonCode:d.errorCode||"user_activity_unknown",stage:s,action:c});const l=$e({snapshot:ze(d.result),stage:s,policy:t.policy});if(r({phase:"snapshot",stage:s,action:c,ok:l.ok,...l.ok?{}:{reasonCode:l.reasonCode,waitMs:l.waitMs}}),!l.ok)throw new T({reasonCode:l.reasonCode,stage:s,action:c})},a={request:async(s,c,d)=>{const l=qe(s);l&&await o(l.stage,`${s}:before`);const u=await e.request(s,c,d);return l&&u.ok&&await o(l.stage,`${s}:after`),u}};return{helper:a,async withLease(s,c,d){if(await o(s,`${c}:preflight`),t.useAutomationLease===!1)return await d(a);const l=await e.request("automation.lease.acquire",{owner:"wechat-channel",purpose:`observe:${c}`,ttlMs:12e4},n);if(i=typeof l.result?.leaseId=="string"?l.result.leaseId:null,r({phase:"lease-acquire",stage:s,action:c,ok:l.ok===!0,...l.ok?{}:{reasonCode:l.errorCode||"user_activity_unknown"}}),!l.ok)throw i=null,new T({reasonCode:l.errorCode||"user_activity_unknown",stage:s,action:c});try{const u=await d(a);return await o(s,`${c}:complete`),u}finally{const u=i;if(i=null,u){const h=await e.request("automation.lease.release",{leaseId:u},n).catch(w=>({ok:!1,errorCode:"automation_lease_release_failed",errorSummary:w instanceof Error?w.message:String(w)}));r({phase:"lease-release",stage:s,action:c,ok:h.ok===!0,...h.ok?{}:{reasonCode:h.errorCode||"automation_lease_release_failed"}})}}}}}function qe(e){return e==="windows.ensureReady"||e==="windows.focus"||e==="wechat.searchConversation"?{stage:"open_conversation"}:e==="keyboard.shortcut"||e==="mouse.click"||e==="mouse.rightClick"||e==="mouse.scroll"||e==="clipboard.snapshot"||e==="clipboard.readAttachment"||e==="menu.pickItem"?{stage:"dangerous_action"}:null}function Z(e){return e==="recent_mouse_activity"||e==="recent_mouse_click"||e==="recent_scroll_activity"||e==="recent_keyboard_activity"||e==="frontmost_app_changed"?e:"user_activity_unknown"}function J(e){return e.observePipeline==="edge-structure"?!0:e.observePipeline==="server-observe"?!1:!!e.api.structureWindow}async function P(e){const t=await me(e),n=await e.api.observe(e.runtime,e.binding,{screenshots:[{captureIndex:0,mimeType:t.mimeType,dataBase64:t.dataBase64,width:t.width,height:t.height}],edgeOcrBlocks:e.ocr.blocks??[],visibleConversationFingerprints:e.ocr.visibleConversationFingerprints??[],localLedgerTailAnchors:e.localLedgerTailAnchors??[]}),i=await re({helper:e.helper,runtime:e.runtime,binding:e.binding,messages:n.observedMessages??[],workDir:e.workDir,attachmentsDir:e.attachmentsDir,window:e.window,screenshot:t,windowId:e.window.windowId,traceId:e.traceId,mediaAnchorText:e.mediaAnchorText});return Ne(i,ke({ocr:e.ocr,screenshot:t,binding:e.binding,anchors:e.localOutboundEchoAnchors??[]}))}async function Q(e){if(!e.api.structureWindow)throw new Error("wechat_structure_window_unavailable");const t=await me(e);let n;try{n=await e.api.structureWindow(e.runtime,e.binding,{screenshots:[{captureIndex:0,mimeType:t.mimeType,dataBase64:t.dataBase64,width:t.width,height:t.height}],edgeOcrBlocks:e.ocr.blocks??[],visibleConversationFingerprints:e.ocr.visibleConversationFingerprints??[],localLedgerTailAnchors:e.localLedgerTailAnchors??[]})}catch(c){if(Ue(c))return P(e);throw c}const i=et(n.structuredMessages??n.observedMessages??[]),r=await je({...e,messages:i,screenshot:t}),o=await re({helper:e.helper,runtime:e.runtime,binding:e.binding,messages:r.messages,workDir:e.workDir,attachmentsDir:e.attachmentsDir,window:e.window,screenshot:t,windowId:e.window.windowId,traceId:e.traceId,mediaAnchorText:e.mediaAnchorText}),a=Ne(o,ke({ocr:e.ocr,screenshot:t,binding:e.binding,anchors:e.localOutboundEchoAnchors??[]}));return e.localLedger?We({ledger:e.localLedger,bindingId:e.binding.bindingId,observedMessages:a,baselineOnly:e.baselineOnly,vectorReferences:r.vectorReferences}).newMessages:a}function Ue(e){return e instanceof Error&&/\bedge_runtime_disabled\b/.test(e.message)}async function je(e){const t=Ge(e.messages);if(!t.length)return{messages:e.messages,vectorReferences:[]};const n=e.api.embedVisual?await Ye({...e,seedBlocks:t}):t.filter(a=>f(a.vectorBase64)||f(a.signature));if(!n.length)return{messages:e.messages,vectorReferences:[]};const i=e.vectorStorePath??Be(e.workDir||process.cwd(),e.runtime.runtimeId),r=Ae(i,e.runtime.runtimeId),o=Fe({store:r,bindingId:e.binding.bindingId,blocks:n});return o.length?(Ee(i,r),{messages:Je(e.messages,o),vectorReferences:o}):{messages:e.messages,vectorReferences:[]}}function Ge(e){const t=[];for(const n of e)for(const[i,r]of(n.visualBlocks??[]).entries()){const o=f(r.blockId)||`${n.stableMessageKey}:visual-${i}`,a=f(r.blockKind)||n.kind||"visual";t.push({...r,stableMessageKey:n.stableMessageKey,blockId:o,blockKind:a,...r.bbox!==void 0?{bbox:r.bbox}:n.bbox!==void 0?{bbox:n.bbox}:{}})}return t}async function He(e){if(!e.api.embedVisual)return[];const t=await e.api.embedVisual(e.runtime,e.binding,{screenshots:[{captureIndex:0,mimeType:e.screenshot.mimeType,dataBase64:e.screenshot.dataBase64,width:e.screenshot.width,height:e.screenshot.height}],visualBlocks:e.seedBlocks,traceId:e.traceId});return Ze(t.visualBlocks??t.embeddedBlocks??[],e.seedBlocks)}async function Ye(e){try{return await He(e)}catch(t){if(Xe(t))throw t;return[]}}function Xe(e){return!e||typeof e!="object"?!1:e.reasonCode==="insufficient_credits"?!0:e instanceof Error&&/\binsufficient_credits\b/.test(e.message)}function Ze(e,t){return e.map((n,i)=>{const r=t[i];return{...n,stableMessageKey:f(n.stableMessageKey)||f(r?.stableMessageKey),blockId:f(n.blockId)||f(r?.blockId),blockKind:f(n.blockKind)||f(r?.blockKind)||"visual",...n.bbox!==void 0?{bbox:n.bbox}:r?.bbox!==void 0?{bbox:r.bbox}:{}}}).filter(n=>f(n.stableMessageKey)&&f(n.blockId))}function Je(e,t){const n=new Map;for(const i of t){const r=n.get(i.stableMessageKey)??[];r.push(i),n.set(i.stableMessageKey,r)}return e.map(i=>{const r=n.get(i.stableMessageKey);return r?.length?{...i,visualBlocks:Qe(i,r)}:i})}function Qe(e,t){const i=(e.visualBlocks??[]).map((o,a)=>{const s=f(o.blockId)||`${e.stableMessageKey}:visual-${a}`,c=t.find(d=>d.blockId===s);return c?ee(c,o):te(o)}),r=new Set(i.map(o=>o.blockId));for(const o of t)r.has(o.blockId)||i.push(ee(o));return i}function ee(e,t){return{...t?te(t):{},stableMessageKey:e.stableMessageKey,blockId:e.blockId,blockKind:e.blockKind,vectorStoreKey:e.vectorStoreKey,model:e.model,...e.modelVersion!==void 0?{modelVersion:e.modelVersion}:{},dims:e.dims,...e.signature?{signature:e.signature}:{},...e.bbox!==void 0?{bbox:e.bbox}:{}}}function te(e){const{vectorBase64:t,...n}=e;return n}function et(e){return e.map((t,n)=>tt(t,n)).filter(t=>t!=null)}function tt(e,t){if(!m(e))return null;const n=Re(e.kind),i=it(e.senderRole),r=g(e.normalizedText),o=g(e.anchorText)??r??g(e.textExcerpt),a=f(e.stableMessageKey)||nt({message:e,index:t,senderRole:i,kind:n,anchorText:o});return{stableMessageKey:a,senderRole:i,...g(e.senderName)!==null?{senderName:g(e.senderName)}:{},kind:n,...r!==null?{normalizedText:r}:{},...o!==null?{anchorText:o}:{},...k(e,"anchorMetadata")?{anchorMetadata:e.anchorMetadata}:{},...k(e,"neighborContext")?{neighborContext:e.neighborContext}:{},...g(e.textExcerpt)!==null?{textExcerpt:g(e.textExcerpt)}:{},...k(e,"bbox")?{bbox:e.bbox}:{},...k(e,"mediaMetadata")?{mediaMetadata:rt(e.mediaMetadata)}:{},...typeof e.isBaseline=="boolean"?{isBaseline:e.isBaseline}:{},...g(e.deliveryStatus)!==null?{deliveryStatus:g(e.deliveryStatus)??void 0}:{},...g(e.observedAt)!==null?{observedAt:g(e.observedAt)??void 0}:{},...Array.isArray(e.visualBlocks)?{visualBlocks:e.visualBlocks}:{},...o?{}:{anchorText:a}}}function nt(e){const t=m(e.message.bbox)?JSON.stringify(e.message.bbox):"";return`structured-window:${[e.index,e.senderRole,e.kind,e.anchorText||f(e.message.textExcerpt)||"",t].join(":").slice(0,180)}`}function rt(e){if(!m(e))return e;const t={...e};return k(t,"availability")&&(t.availability=H(t.availability)),m(t.attachment)&&(t.attachment=ne(t.attachment)),Array.isArray(t.attachments)&&(t.attachments=t.attachments.map(n=>m(n)?ne(n):n)),t}function ne(e){const t={...e};return k(t,"availability")&&(t.availability=H(t.availability)),t}function it(e){return e==="self"||e==="contact"||e==="system"||e==="unknown"?e:"unknown"}async function re(e){if(e.binding.downloadMedia===!1)return e.messages;const t=e.messages.map((o,a)=>ut(o,e.screenshot,e.window,lt(e.messages,a))).filter((o,a)=>ot(e.messages,a,e.mediaAnchorText)).filter(o=>o!=null);if(!t.length)return e.messages;const n=e.attachmentsDir??_e(e.workDir||process.cwd(),e.runtime.runtimeId,e.binding.bindingId),i=await Te({helper:e.helper,candidates:t,attachmentsDir:n,screenshot:e.screenshot,windowId:e.windowId,window:e.window,traceId:e.traceId,platform:e.runtime.policy.platform,stabilityCheck:async()=>{const o=await _({helper:e.helper,window:e.window,binding:e.binding,traceId:e.traceId});return o.ok?{ok:!0}:{ok:!1,reasonCode:o.reason}}});if(!i.length)return e.messages;const r=new Map(i.map(o=>[o.messageKey,o]));return e.messages.map(o=>{const a=r.get(o.stableMessageKey);return a?{...o,mediaMetadata:ht(o.mediaMetadata,a.attachment,a.reasonCode,a.attemptReasonCodes,a.resolveTrace)}:o})}function ot(e,t,n){const i=oe(n);if(!i)return!0;const r=at(i),o=e.map((a,s)=>oe(dt(a)).includes(i)?s:-1).filter(a=>a>=0);if(!o.length)return t===st(e,r);for(const a of o)if(t>=a&&t<=a+8||t===a-1&&!e.slice(a+1,Math.min(e.length,a+9)).some(ie))return!0;return!1}function at(e){return e.includes("video")||e.includes("vide0")?"video":e.includes("image")||e.includes("photo")||e.includes("ph0t0")||e.includes("picture")?"image":e.includes("file")||e.includes("document")?"file":null}function st(e,t=null){for(let n=e.length-1;n>=0;n-=1)if(ie(e[n]))return ct(e[n],t)?n:-1;return-1}function ie(e){if(!e)return!1;const t=String(e.kind||"").toLowerCase(),n=m(e.mediaMetadata)?e.mediaMetadata:{},i=m(n.attachment)?n.attachment:{};return ae(t,n,i)}function ct(e,t){if(!e||!t)return!0;const n=String(e.kind||"").toLowerCase(),i=m(e.mediaMetadata)?e.mediaMetadata:{},r=m(i.attachment)?i.attachment:{},o=String(r.type||"").toLowerCase(),a=String(r.mimeType||"").toLowerCase(),s=String(r.name||r.localPath||e.anchorText||e.textExcerpt||"").toLowerCase();return t==="video"?n.includes("video")||o==="video"||a.startsWith("video/")||/\.(mp4|mov|m4v|avi|mkv|webm)$/i.test(s):t==="image"?/image|photo|picture/.test(n)||o==="image"||a.startsWith("image/")||/\.(png|jpe?g|gif|webp|heic|tiff?|bmp)$/i.test(s):/file|document/.test(n)||o==="file"||!/image|photo|picture|video/.test(n)&&o!=="image"&&o!=="video"&&!a.startsWith("image/")&&!a.startsWith("video/")}function dt(e){if(!e)return"";const t=e;return[e.normalizedText,e.anchorText,e.textExcerpt,t.text].map(n=>String(n||"")).join(`
-`)}function oe(e){return String(e||"").normalize("NFKC").replace(/[o]/giu,"0").replace(/[^\p{L}\p{N}]/gu,"").toLowerCase()}function lt(e,t){return[e[t-1],e[t],e[t+1]].map(i=>i&&(i.normalizedText||i.anchorText||i.textExcerpt)||"").map(i=>String(i||"").trim()).filter(Boolean).join(`
-`)||null}function ut(e,t,n,i){const r=String(e.kind||"").toLowerCase(),o=m(e.mediaMetadata)?e.mediaMetadata:{},a=m(o.attachment)?o.attachment:{},s=f(a.availability)||f(o.availability),c=f(a.localPath)||f(o.localPath);if(s==="edge-local"&&c||!ae(r,o,a))return null;const d=R(e.bbox)??R(o.bbox)??R(o.downloadActionBbox),l=R(o.downloadActionBbox),u=se(d,t,n),h=wt(d,t,n),w=se(l,t,n);return{messageKey:e.stableMessageKey,kind:f(a.type)||f(a.kind)||f(o.messageType)||r,fileName:f(a.name)||f(a.fileName)||f(o.fileName)||null,mimeType:f(a.mimeType)||f(o.mimeType)||null,size:N(a.size)??N(o.size),mediaStatus:ft(o,a),observedAt:e.observedAt??null,contextText:i??e.normalizedText??e.anchorText??e.textExcerpt??null,...u?{bbox:u}:{},...h?{screenshotBbox:h}:{},...w?{downloadActionBbox:w}:{}}}function ht(e,t,n,i,r){const o=m(e)?{...e}:{};return{...o,availability:m(t)?t.availability:o.availability,mediaStatus:m(t)&&t.availability==="edge-local"?"downloaded":o.mediaStatus,attachment:t,edgeResolveReasonCode:n,...i?.length?{edgeResolveAttempts:i}:{},...r?{edgeResolveTrace:r}:{}}}function ft(e,t){const n=f(e.mediaStatus);if(n==="not_downloaded")return"not_downloaded";if(n==="downloaded"||n==="available")return"available";const i=f(t.availability)||f(e.availability);return i==="pending-download"?"not_downloaded":i==="metadata-only"?"metadata_only":n||null}function ae(e,t,n){const i=`${e} ${f(t.messageType)} ${f(n.type)} ${f(n.kind)}`.toLowerCase();return/image|photo|video|file|document/.test(i)}function R(e){if(!m(e))return null;const t=N(e.x),n=N(e.y),i=N(e.width),r=N(e.height);return t==null||n==null||i==null||r==null?null:{x:t,y:n,width:i,height:r,...typeof e.coordinateSpace=="string"?{coordinateSpace:e.coordinateSpace}:{}}}function se(e,t,n){if(!e)return null;if(e.coordinateSpace==="screen")return e;const i=A(e,t,n);if(!i)return e;const r=n.bounds;if(!r?.width||!r?.height)return{...e,x:i.x-e.width/2,y:i.y-e.height/2,coordinateSpace:"screen"};const o=r.width/t.width,a=r.height/t.height,s=i.x,c=i.y;return{x:s-e.width*o/2,y:c-e.height*a/2,width:e.width*o,height:e.height*a,coordinateSpace:"screen"}}function wt(e,t,n){if(!e)return null;if(e.coordinateSpace!=="screen")return{...e,coordinateSpace:"screenshotPixel"};const i=n.bounds;if(!i?.width||!i?.height)return null;const r=t.width/i.width,o=t.height/i.height;return{x:(e.x-i.x)*r,y:(e.y-i.y)*o,width:e.width*r,height:e.height*o,coordinateSpace:"screenshotPixel"}}function m(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function k(e,t){return Object.prototype.hasOwnProperty.call(e,t)}function f(e){return typeof e=="string"?e.trim():""}function g(e){return f(e)||null}function N(e){const t=Number(e);return Number.isFinite(t)?t:null}async function cn(e,t){await ce(e,t)}async function ce(e,t,n={}){let i=await e.request("permissions.check",{},t);b(i,"permissions.check");const r=i.result??{};if(r.screenRecording===!1)throw new Error("permission_screen_recording_missing");if(r.automation===!1)throw new Error("permission_automation_missing");if(r.wechatRunning===!1)throw new Error("wechat_not_running");if(gt(r))throw new Error(D);if(mt(r))throw new Error(F);if(yt(r))throw new Error("windows_visible_desktop_unavailable");if(r.dpiMappingAvailable===!1||r.displayTopologySupported===!1)throw new Error("dpi_mapping_failed");if(r.wechatMainWindowResponsive===!1)throw new Error("wechat_window_unresponsive");if(de([...r.captureCandidates??[],...r.restoreCandidates??[],...r.hiddenRestoreCandidates??[],...r.duplicateMainWindows??[],...r.unsafeAuxiliaryWindows??[]]))throw new Error(F);if(r.wechatWindowAvailable===!1&&String(r.platform??"").toLowerCase()!=="win32"&&n.allowUnavailableWindow!==!0)throw new Error("wechat_window_unavailable");return r}async function bt(e,t,n={}){const r=(n.foreground??"required")!=="background",o=await ce(e,t,{allowUnavailableWindow:r});if(String(o.platform??"").toLowerCase()==="win32"){const c=await e.request("windows.ensureReady",{activate:r,allowRecovery:!1,allowLaunch:!1},t);b(c,"windows.ensureReady");const d=c.result;if(!d?.windowId)throw new Error("helper_invalid_response: windows.ensureReady missing WeChat window data");return d}const a=await e.request("windows.ensureReady",{restore:r,focus:r},t);b(a,"windows.ensureReady");const s=a.result;if(!s?.windowId)throw new Error("helper_invalid_response: windows.ensureReady missing WeChat window data");return s}function de(e,t){const n=e.filter(x).filter(r=>r.visible!==!1&&r.minimized!==!0),i=t??n.slice().sort((r,o)=>I(o)-I(r))[0];return n.find(r=>xt(r,i))??null}function mt(e){return e.duplicateInstanceBlocked===!0||Number(e.duplicateMainWindowCount??0)>0||Number(e.unsafeAuxiliaryWindowCount??0)>0||(e.duplicateMainWindows??[]).some(x)||(e.unsafeAuxiliaryWindows??[]).some(x)}function gt(e){if(Number(e.duplicateMainWindowCount??0)>0||(e.duplicateMainWindows??[]).some(x))return!1;const t=e.unsafeAuxiliaryWindows??[];return Number(e.unsafeAuxiliaryWindowCount??0)>0||t.some(ue)?![...e.captureCandidates??[],...e.restoreCandidates??[],...e.hiddenRestoreCandidates??[]].some(V)||e.wechatWindowAvailable===!1:!1}function yt(e){return e.windowsVisibleDesktopAvailable===!1||e.rdpVisibleDesktopAvailable===!1||e.desktopSessionVisible===!1||e.screenLocked===!0||e.rdpDisconnected===!0}function K(e){const t=e.filter(x).filter(r=>r.visible!==!1&&r.minimized!==!0),n=t.filter(V);if(n.length>1)throw new Error(F);const i=n.slice().sort((r,o)=>I(o)-I(r))[0];if(de(t,i))throw new Error(F)}function le(e){const t=e.filter(x),n=t.filter(o=>o.visible!==!1&&o.minimized!==!0),i=n.filter(V);return(i.length?i:n.length?n:t).slice().sort((o,a)=>I(a)-I(o))[0]??null}function xt(e,t){return!(!x(e)||t&&pt(e,t)||e.visible===!1||e.minimized===!0||!ue(e)||t&&vt(e,t))}function ue(e){if(!x(e)||e.visible===!1||e.minimized===!0)return!1;const t=Number(e.bounds?.width),n=Number(e.bounds?.height);if(!Number.isFinite(t)||!Number.isFinite(n))return!1;const i=t>=360&&t<=720&&n>=420&&n<=840&&n>t,r=t>=420&&t<=680&&n>=260&&n<=460;return i||r}function vt(e,t){const n=Number(e.rootProcessId),i=Number(t.rootProcessId);if(!Number.isFinite(n)||!Number.isFinite(i)||n!==i)return!1;const r=Number(e.zOrder),o=Number(t.zOrder);return!Number.isFinite(r)||!Number.isFinite(o)?!1:r>o}function V(e){const t=Number(e.bounds?.width),n=Number(e.bounds?.height);return Number.isFinite(t)&&Number.isFinite(n)&&t>=760&&n>=600}function I(e){const t=Number(e.bounds?.width),n=Number(e.bounds?.height);return Number.isFinite(t)&&Number.isFinite(n)?t*n:0}function pt(e,t){return!!(e.windowId&&t.windowId&&e.windowId===t.windowId)}async function dn(e,t){let n=await e.request("windows.list",{},t);b(n,"windows.list");let i=n.result?.windows??[];K(i);let r=le(i);if(!r)throw new Error("wechat_window_not_found");const o=await e.request("windows.focus",{windowId:r.windowId},t);return b(o,"windows.focus"),await he(e,r,t)}async function Ct(e,t,n){if(!t.windowId)throw new Error("wechat_window_not_found");const i=await e.request("windows.focus",{windowId:t.windowId},n);return b(i,"windows.focus"),t}async function kt(e,t){const n=await e.request("windows.list",{},t);b(n,"windows.list");const i=n.result?.windows??[];K(i);const r=le(i);if(!r)throw new Error("wechat_window_not_found");const o=await e.request("windows.focus",{windowId:r.windowId},t);return b(o,"windows.focus"),await he(e,r,t)}async function he(e,t,n){let i;try{i=await e.request("windows.list",{},n)}catch{return t}if(!i.ok)return t;const r=(i.result?.windows??[]).filter(x);return K(r),r.find(o=>o.windowId===t.windowId)??r[0]??t}async function q(e){const{capture:t,ocr:n}=e.observation??await M(e),i=B({capture:t,ocr:n,window:e.window});if(i)return{opened:!1,reason:i};const r=Oe({visibleItems:Et(n,t,e.allowOcrTitleRows!==!1),targets:[{bindingId:e.binding.bindingId,conversationDisplayName:e.binding.conversationDisplayName}]})[0];if(!r)return{opened:!1,reason:"conversation_not_visible"};const o=Xt(r.item.bbox,t,e.window);if(!o)return{opened:!1,reason:"conversation_bbox_missing"};const a=await e.helper.request("mouse.click",{x:o.x,y:o.y,coordinateSpace:"screen",windowId:e.window.windowId},e.traceId);return b(a,"mouse.click"),{opened:!0,reason:r.reason}}async function fe(e){let t={opened:!1,reason:"conversation_not_opened"};for(let i=0;i<De;i+=1){if(t=await Nt(e),t.opened||t.reason!=="conversation_title_not_confirmed")return t;await S(e,"open-retry",`retry:${i}`)}const n=await we(e);return n.opened?{opened:!0,reason:`${n.reason}:final-visible-recovery`}:t}async function Nt(e){const t=await M(e),n=B({capture:t.capture,ocr:t.ocr,window:e.window});if(n)return{opened:!1,reason:n};let i=!1;if($(t.ocr,t.capture,e.binding.conversationDisplayName))return e.settleToBottom===!0&&await W({helper:e.helper,window:e.window,traceId:e.traceId,observation:t}),{opened:!0,reason:"current-conversation-title-confirmed"};if(!i){const u=await q({...e,observation:t});if(u.opened){if(await S(e,"open-click-settle","visible-initial"),(await _(e)).ok)return{opened:!0,reason:u.reason};const w=await we(e);if(w.opened)return w}}const r=Wt(e,t),o=await e.helper.request("wechat.searchConversation",{conversationName:e.binding.conversationDisplayName,waitMs:e.searchDelayMs??L(e,"search-input-settle","search-input"),...r?{searchPoint:r}:{}},e.traceId);b(o,"wechat.searchConversation");const a=await It(e);if(a.opened){await S(e,"open-click-settle","search-result-click");const u=await _(e);return u.ok?(e.settleToBottom===!0&&await W({helper:e.helper,window:e.window,traceId:e.traceId}),{opened:!0,reason:a.reason}):{opened:!1,reason:u.reason}}let s=a.observation;const c=y(e.binding.conversationDisplayName)&&a.reason==="search_result_not_visible";if(!y(e.binding.conversationDisplayName)){await At(e.helper,e.traceId),await S(e,"open-click-settle","search-return");const u=await _(e);if(u.ok)return e.settleToBottom===!0&&await W({helper:e.helper,window:e.window,traceId:e.traceId}),{opened:!0,reason:u.reason};const h=await e.helper.request("wechat.searchConversation",{conversationName:e.binding.conversationDisplayName,waitMs:e.searchDelayMs??L(e,"search-input-settle","search-input-retry-after-return"),...r?{searchPoint:r}:{}},e.traceId);b(h,"wechat.searchConversation"),s=void 0}const d=await q({...e,...s?{observation:s}:{},allowOcrTitleRows:!c});if(!d.opened)return d;await S(e,"open-click-settle","visible-final");const l=await _(e);return l.ok?(e.settleToBottom===!0&&await W({helper:e.helper,window:e.window,traceId:e.traceId}),{opened:!0,reason:d.reason}):{opened:!1,reason:l.reason}}async function we(e){const t=await q(e);if(!t.opened)return t;await S(e,"open-click-settle","visible-retry");const n=await _(e);return n.ok?(e.settleToBottom===!0&&await W({helper:e.helper,window:e.window,traceId:e.traceId}),{opened:!0,reason:`${t.reason}:retry-visible-title-confirmed`}):{opened:!1,reason:n.reason}}function ln(e){const t=e.bounds,n=Number(t?.x),i=Number(t?.y),r=Number(t?.width),o=Number(t?.height);if(![n,i,r,o].every(Number.isFinite)||r<=0||o<=0)return null;const a=Math.max(520,Math.min(r-160,r*.68)),s=Math.max(48,Math.min(88,o*.08));return{x:Math.round(n+a),y:Math.round(i+o-s),coordinateSpace:"screen"}}async function It(e){let t;const n=e.searchDelayMs===0?0:L(e,"search-result-probe","search-result-probe"),i=y(e.binding.conversationDisplayName)?Pe:1;for(let r=0;r<i;r+=1){r>0&&n>0&&await ye(n);const o=await Mt(e);t=o;const{capture:a,ocr:s}=o,c=B({capture:a,ocr:s,window:e.window});if(c)return{opened:!1,reason:c,observation:o};const d=Lt(s,a,e.binding.conversationDisplayName);if(!d){if(Ot(s)||$t(s,e.binding.conversationDisplayName))break;continue}const l=A(d.bbox,a,St(a,e.window));if(!l)return{opened:!1,reason:"search_result_bbox_missing",observation:o};const u=await e.helper.request("mouse.click",{x:l.x,y:l.y,coordinateSpace:"screen",windowId:e.window.windowId},e.traceId);return b(u,"mouse.click"),{opened:!0,reason:d.reason,observation:o}}return{opened:!1,reason:"search_result_not_visible",observation:t}}async function Mt(e){if(e.window.bounds&&y(e.binding.conversationDisplayName)){const t=await e.helper.request("screen.capture",{bounds:e.window.bounds},e.traceId);if(t.ok&&t.result?.dataBase64&&t.result.width&&t.result.height){const n={...t.result,windowId:e.window.windowId,bounds:t.result.bounds??e.window.bounds},i=await ge(e.helper,n,e.traceId);return{capture:n,ocr:i}}t.errorCode&&t.errorCode!=="helper_unknown_command"&&t.errorCode!=="helper_command_unsupported"&&b(t,"screen.capture")}return M(e)}function St(e,t){return e.bounds?{...t,bounds:e.bounds}:t}async function M(e){let{capture:t,ocr:n}=await U(e.helper,e.window.windowId,e.traceId,e.window.bounds);return await _t({helper:e.helper,window:e.window,capture:t,ocr:n,traceId:e.traceId})&&(await Y("preview-dismiss-settle",`${e.traceId||""}:${e.window.windowId}:preview-dismiss`),{capture:t,ocr:n}=await U(e.helper,e.window.windowId,e.traceId,e.window.bounds)),{capture:t,ocr:n}}async function _t(e){const t=Tt(e.ocr,e.capture,e.window);if(!t)return!1;for(const n of[async()=>e.helper.request("keyboard.shortcut",{key:"escape",modifiers:[]},e.traceId),async()=>e.helper.request("mouse.click",{x:t.x,y:t.y,coordinateSpace:"screen",windowId:e.window.windowId},e.traceId)])if((await n()).ok)return!0;return!1}function Tt(e,t,n){const i=e.blocks??[],r=i.find(c=>{const d=String(c.text||""),l=c.bbox;if(!l)return!1;const u=Number(l.x),h=Number(l.y);return Number.isFinite(u)&&Number.isFinite(h)&&h>t.height*.06&&h<t.height*.22&&u>t.width*.3&&/查看原视频|查看原图|原视频|原图|视频|图片|图像/.test(d)});if(!r)return null;const o=r.bbox,a=Number(o?.y);if(!Number.isFinite(a))return null;const s=i.filter(c=>{const d=String(c.text||"").trim(),l=c.bbox;if(!l||d!=="\xD7")return!1;const u=Number(l.x),h=Number(l.y);return Number.isFinite(u)&&Number.isFinite(h)&&u>t.width*.55&&u<t.width*.9&&Math.abs(h-a)<t.height*.08}).sort((c,d)=>Number(d.bbox?.x??0)-Number(c.bbox?.x??0))[0];return A(s?.bbox,t,n)}function Wt(e,t){const{capture:n,ocr:i}=t,r=(i.blocks??[]).find(o=>{const a=String(o.text||"").trim().toLowerCase(),s=o.bbox;if(!s||!/^(搜索|search)$/.test(a))return!1;const c=Number(s.x),d=Number(s.y);return Number.isFinite(c)&&Number.isFinite(d)&&c<n.width*.22&&d<n.height*.12});return A(r?.bbox,n,e.window)}async function be(e,t,n,i){const r=await e.request("windows.capture",{windowId:t,scope:"full-window",...i?{bounds:i}:{}},n);b(r,"windows.capture");const o=r.result;if(!o?.dataBase64||!o.mimeType||!o.width||!o.height)throw new Error("helper_invalid_response: windows.capture missing screenshot data");return o}async function me(e){return e.capture.dataBase64?e.capture:be(e.helper,e.window.windowId,e.traceId,e.window.bounds)}async function U(e,t,n,i){const r=await e.request("windows.captureAndOcr",{windowId:t,scope:"full-window",...i?{bounds:i}:{}},n);if(r.ok&&r.result?.capture&&r.result?.ocr)return{capture:r.result.capture,ocr:r.result.ocr};!r.ok&&r.errorCode&&r.errorCode!=="helper_unknown_command"&&r.errorCode!=="helper_command_unsupported"&&b(r,"windows.captureAndOcr");const o=await be(e,t,n,i),a=await ge(e,o,n);return{capture:o,ocr:a}}async function ge(e,t,n){const i=await e.request("ocr.recognize",{mimeType:t.mimeType,dataBase64:t.dataBase64,width:t.width,height:t.height},n);return b(i,"ocr.recognize"),i.result??{}}function b(e,t){if(!e.ok)throw new Error(`${e.errorCode||"helper_command_failed"}: ${e.errorSummary||t}`)}function x(e){const t=`${e.appName||""} ${e.title||""} ${e.className||""}`.toLowerCase();return t.includes("wechat")||t.includes("weixin")||t.includes("\u5FAE\u4FE1")||t.includes("qwindowicon")}function ye(e){return new Promise(t=>setTimeout(t,e))}function L(e,t,n){return e.searchDelayMs===0?0:Le(t,Bt(e,n))}async function S(e,t,n){const i=L(e,t,n);i>0&&await ye(i)}function Bt(e,t){return`${e.traceId||""}:${e.binding.conversationDisplayName}:${t}`}async function At(e,t){const n=await e.request("keyboard.shortcut",{key:"return",modifiers:[]},t);b(n,"keyboard.shortcut")}async function W(e){if(!e.window.bounds)return;const t=e.observation,n=Zt(t?.ocr,t?.capture,e.window);if(n){const i=await e.helper.request("mouse.click",{x:n.x,y:n.y,coordinateSpace:"screen",windowId:e.window.windowId},e.traceId);b(i,"mouse.click"),await Y("jump-latest-settle",`${e.traceId||""}:${e.window.windowId}:jump-latest`)}}async function _(e){const{capture:t,ocr:n}=await U(e.helper,e.window.windowId,e.traceId,e.window.bounds),i=B({capture:t,ocr:n,window:e.window});return i?{ok:!1,reason:i}:$(n,t,e.binding.conversationDisplayName)?{ok:!0,reason:"target-conversation-title-confirmed"}:{ok:!1,reason:"conversation_title_not_confirmed"}}function B(e){const t=(e.ocr.blocks??[]).map(i=>Pt(i.text)).filter(Boolean),n=t.join("");return/(扫码登录|仅传输文件|重新登录|为了安全|安全验证|登录微信|微信登录|该账号已登录|帐号已登录|账号已登录|当前账号已登录|当前帐号已登录|已登录|进入微信|進入微信)/u.test(n)||Dt(e,t)?D:null}function Et(e,t,n=!0){const i=n?Ft(e.blocks??[],t):[];return i.length?i:e.visibleConversationFingerprints??[]}function Ft(e,t){const n=e.map(r=>xe(r)).filter(r=>!!r).filter(r=>r.text.length>=2).filter(r=>r.x>t.width*.08&&r.x<t.width*.38).filter(r=>r.y>t.height*.06&&r.y<t.height*.96).filter(r=>!ve(r.text)),i=new Set;return n.filter(r=>!Rt(r,n,t)).sort((r,o)=>r.y-o.y||r.x-o.x).map(r=>{const o=r.text.trim();return{title:o,bbox:{x:Math.max(0,r.x-24),y:Math.max(0,r.y-Math.max(24,r.height)),width:Math.max(120,t.width*.3),height:Math.max(48,r.height+40),coordinateSpace:"screenshotPixel"},fingerprint:o.toLowerCase()}}).filter(r=>{const o=E(r.title);return!o||i.has(o)?!1:(i.add(o),!0)})}function xe(e){const t=e.bbox,n=String(e.text||"").normalize("NFKC").trim(),i=Number(t?.x),r=Number(t?.y),o=Number(t?.width),a=Number(t?.height);return!n||![i,r,o,a].every(Number.isFinite)?null:{text:n,x:i,y:r,width:o,height:a}}function Rt(e,t,n){const i=Math.max(36,Math.min(64,n.height*.058));return t.some(r=>r!==e&&r.y<e.y&&e.y-r.y<=i&&Math.abs(r.x-e.x)<=16&&r.height>=e.height*.85)}function ve(e){const t=p(e);return/^(搜索|微信|通讯录|收藏|设置|文件传输助手|search)$/iu.test(t)||O(t)||zt(t)||/^包含[:：]?/u.test(t)||/搜索网络结果/u.test(t)}function Lt(e,t,n){const i=(e.blocks??[]).map(s=>xe(s)).filter(s=>!!s),r=i.filter(s=>O(p(s.text))).sort((s,c)=>s.y-c.y||s.x-c.x),o=["\u7FA4\u804A","GroupChats","\u8054\u7CFB\u4EBA","Contacts"];for(const s of o){const c=r.findIndex(h=>p(h.text)===s);if(c<0)continue;const d=r[c],l=r[c+1]?.y??Number.POSITIVE_INFINITY,u=i.filter(h=>h.y>d.y&&h.y<l).filter(h=>h.x<t.width*.7).filter(h=>h.text.length>=2).filter(h=>!O(p(h.text))).filter(h=>!Ce(h,i)).filter(h=>G(h.text,n)).sort((h,w)=>h.y-w.y||h.x-w.x)[0];if(u)return{bbox:pe(u,t),reason:"search-result-title"}}const a=i.filter(s=>s.y>t.height*.12&&s.y<t.height*.82).filter(s=>s.x>t.width*.08&&s.x<t.width*.45).filter(s=>s.text.length>=2).filter(s=>!ve(s.text)).filter(s=>!Ce(s,i)).filter(s=>G(s.text,n)).sort((s,c)=>s.y-c.y||s.x-c.x)[0];return y(n)?null:a?{bbox:pe(a,t),reason:"search-result-title"}:null}function pe(e,t){return{x:Math.max(0,e.x-24),y:Math.max(0,e.y-12),width:Math.max(e.width+t.width*.18,160),height:Math.max(e.height+28,44),coordinateSpace:"screenshotPixel"}}function O(e){return/^(群聊|联系人|聊天记录|公众号|小程序|GroupChats|Contacts|ChatHistory|OfficialAccounts|MiniPrograms)$/u.test(e)}function Ot(e){return(e.blocks??[]).some(t=>O(p(t.text)))}function $t(e,t){return(e.visibleConversationFingerprints??[]).some(n=>G(n.title,t))}function p(e){return String(e||"").normalize("NFKC").replace(/[^\p{L}\p{N}_-]/gu,"").trim()}function Ce(e,t){return/^包含[:：]?/u.test(e.text.trim())?!0:t.some(n=>n!==e&&Math.abs(n.y-e.y)<=Math.max(18,e.height)&&n.x<e.x&&/^包含[:：]?/u.test(n.text.trim()))}function zt(e){const t=String(e||"").trim();return!!(/^(星期[一二三四五六日天]|周[一二三四五六日天])\s*\d{1,2}:\d{2}$/u.test(t)||/^\d{1,2}:\d{2}(?::\d{2})?$/u.test(t)||/^\d{4}[-/.年]\d{1,2}(?:[-/.月]\d{1,2}日?)?$/u.test(t)||/^\d{1,2}[-/.月]\d{1,2}日?$/u.test(t))}function Dt(e,t){if(!x(e.window)||(e.ocr.visibleConversationFingerprints??[]).length>0)return!1;const n=Number(e.window.bounds?.width||e.capture.width),i=Number(e.window.bounds?.height||e.capture.height);if(![n,i].every(Number.isFinite)||!(n>=360&&n<=720&&i>=420&&i<=840&&i>n))return!1;const o=t.filter(a=>a&&!/^[x*×]+$/iu.test(a));return o.length<=4&&!o.some(a=>/搜索|search/u.test(a))}function Pt(e){return String(e||"").normalize("NFKC").replace(/\s+/g,"").trim()}function $(e,t,n){const i=y(n)?E(n):z(n);return i?(e.blocks??[]).some(r=>{const o=y(n)?E(r.text):z(r.text);if(!o||!Ie(o,i))return!1;const a=r.bbox;if(!a)return!1;const s=Number(a.x),c=Number(a.y);if(!Number.isFinite(s)||!Number.isFinite(c))return!1;const d=s>t.width*.32&&s<t.width*.78&&c<t.height*.16,l=s<t.width*.18&&c<t.height*.12;return d||l}):!1}function j(e){if($(e.ocr,e.capture,e.binding.conversationDisplayName))return!1;const t=(e.ocr.blocks??[]).map(s=>String(s.text||"").normalize("NFKC").replace(/\s+/g," ").trim()).filter(Boolean),n=t.join(`
-`),r=[{pattern:/UTF-?8/iu,source:n},{pattern:/Unix\s*\(LF\)/iu,source:n},{pattern:/纯文本/u,source:n},{pattern:/\d+\s*个字符/u,source:n},{pattern:/\bH1\b/u,source:n},{pattern:/^查看$/u,source:t}].reduce((s,c)=>{const d=Array.isArray(c.source)?c.source.some(l=>c.pattern.test(l)):c.pattern.test(c.source);return s+(d?1:0)},0);if(r>=2)return!0;const o=(e.ocr.blocks??[]).filter(s=>Number(s.bbox?.y)<e.capture.height*.14).map(s=>String(s.text||"")).join(`
-`);return/\.(txt|md|rtf|docx?|pdf)\b/i.test(o)&&r>=1||/\.(png|jpe?g|gif|webp|bmp|heic|mp4|mov|m4v|avi|mkv|webm)\b/i.test(o)&&Kt(e.capture,e.ocr)?!0:((e.ocr.visibleConversationFingerprints??[]).some(s=>{const c=y(e.binding.conversationDisplayName)?E(s.title):z(s.title),d=y(e.binding.conversationDisplayName)?E(e.binding.conversationDisplayName):z(e.binding.conversationDisplayName);return!!(c&&d&&Ie(c,d))}),!1)}function Kt(e,t){const n=(t.blocks??[]).map(o=>String(o.text||"").normalize("NFKC").trim()).filter(Boolean),i=n.join(`
-`);if(/\b\d+\s*x\s*\d+\b/i.test(i)&&/\b\d+(\.\d+)?\s*(B|KB|MB|GB)\b/i.test(i)||/\b100%\b/.test(i)&&n.length<=20)return!0;const r=n.filter(o=>!/^(□|×|\+|…|\.\.\.|100%|\d+|发送)$/u.test(o));return e.width>600&&e.height>500&&r.length<=6}function ke(e){const t=e.anchors.map(o=>({...o,normalized:v(o.expectedEchoAnchor)})).filter(o=>o.normalized);if(!t.length)return[];const n=[],i=new Set,r=Vt(e.ocr,e.screenshot).sort((o,a)=>v(a.text).length-v(o.text).length);for(const o of r){const a=v(o.text);if(!a)continue;const s=t.find(d=>qt(d.normalized,a));if(!s)continue;const c=`local-outbound-echo:${e.binding.bindingId}:${s.idempotencyKey||s.replyId||s.normalized}`;i.has(c)||(i.add(c),n.push({stableMessageKey:c,senderRole:"self",kind:"text",normalizedText:a,anchorText:a,textExcerpt:o.text.trim(),bbox:o.bbox??null,observedAt:new Date().toISOString(),deliveryStatus:"suppressed"}))}return n}function Vt(e,t){const n=(e.blocks??[]).filter(r=>Yt(r,t)&&v(r.text)).sort((r,o)=>C(r.bbox,"y")-C(o.bbox,"y")),i=n.map(r=>({text:String(r.text||"").trim(),bbox:r.bbox}));for(let r=0;r<n.length;r+=1){const o=[n[r]];for(let a=r+1;a<n.length&&o.length<5;a+=1){const s=n[a];if(!Ut(o[o.length-1],s,t))break;o.push(s),i.push({text:jt(o.map(c=>String(c.text||"").trim())),bbox:Ht(o.map(c=>c.bbox))})}}return i}function qt(e,t){if(!e||!t)return!1;if(X(e,t)>=.88)return!0;const n=e.replace(/\s+/g,""),i=t.replace(/\s+/g,"");return i.length>=8&&n.includes(i)}function Ut(e,t,n){const i=C(e.bbox,"x"),r=C(e.bbox,"y"),o=C(e.bbox,"height"),a=C(t.bbox,"x"),s=C(t.bbox,"y");if(![i,r,o,a,s].every(Number.isFinite)||i<n.width*.5||a<n.width*.5)return!1;const c=s-(r+o);return c>=-8&&c<=Math.max(64,n.height*.04)&&Math.abs(a-i)<=120}function jt(e){return e.reduce((t,n)=>t?n?`${t}${Gt(t,n)?" ":""}${n}`:t:n,"")}function Gt(e,t){return/[A-Za-z0-9]$/u.test(e)&&/^[A-Za-z0-9]/u.test(t)}function Ht(e){const t=e.filter(c=>!!c);if(!t.length)return;const n=t.map(c=>Number(c.x)).filter(Number.isFinite),i=t.map(c=>Number(c.y)).filter(Number.isFinite),r=t.map(c=>Number(c.x)+Number(c.width)).filter(Number.isFinite),o=t.map(c=>Number(c.y)+Number(c.height)).filter(Number.isFinite);if(!n.length||!i.length||!r.length||!o.length)return t[0];const a=Math.min(...n),s=Math.min(...i);return{x:a,y:s,width:Math.max(...r)-a,height:Math.max(...o)-s,coordinateSpace:t.find(c=>c.coordinateSpace)?.coordinateSpace}}function C(e,t){const n=Number(e?.[t]);return Number.isFinite(n)?n:Number.NaN}function Ne(e,t){if(!t.length)return e;const n=[...e];for(const i of t){const r=v(i.anchorText||i.normalizedText||i.textExcerpt);n.some(a=>{if(a.senderRole!=="self")return!1;const s=v(a.anchorText||a.normalizedText||a.textExcerpt);return s&&r&&X(s,r)>=.9})||n.push(i)}return n}function Yt(e,t){const n=e.bbox;if(!n)return!1;const i=Number(n.x),r=Number(n.y);return!Number.isFinite(i)||!Number.isFinite(r)?!1:i>t.width*.34&&i<t.width*.96&&r>t.height*.12&&r<t.height*.86}function Xt(e,t,n){if(!e||typeof e!="object")return null;const i=e,r=Number(i.x),o=Number(i.y),a=Number(i.width),s=Number(i.height);if(![r,o,a,s].every(Number.isFinite))return null;const c=typeof i.coordinateSpace=="string"?i.coordinateSpace:void 0,d=t.width&&n.bounds?.width?t.width/n.bounds.width:1,l=t.height&&n.bounds?.height?t.height/n.bounds.height:d,u={x:r+Math.min(a*.35,110*d),y:o+Math.min(s-8*l,Math.max(18*l,s/2))};if(c==="screen"||!n.bounds)return u;const h=Math.max(0,(t.width-n.bounds.width*d)/2),w=Math.max(0,(t.height-n.bounds.height*l)/2);return{x:n.bounds.x+(u.x-h)/d,y:n.bounds.y+(u.y-w)/l}}function A(e,t,n){if(!e||typeof e!="object")return null;const i=e,r=Number(i.x),o=Number(i.y),a=Number(i.width),s=Number(i.height);if(![r,o,a,s].every(Number.isFinite))return null;const c=typeof i.coordinateSpace=="string"?i.coordinateSpace:void 0,d={x:r+a/2,y:o+s/2};if(c==="screen"||!n.bounds)return d;const l=t.width&&n.bounds.width?t.width/n.bounds.width:1,u=t.height&&n.bounds.height?t.height/n.bounds.height:l,h=Math.max(0,(t.width-n.bounds.width*l)/2),w=Math.max(0,(t.height-n.bounds.height*u)/2);return{x:n.bounds.x+(d.x-h)/l,y:n.bounds.y+(d.y-w)/u}}function Zt(e,t,n){if(!e?.blocks?.length||!t)return null;const i=e.blocks.find(r=>{const o=String(r.text||"").trim(),a=r.bbox;if(!a||!o)return!1;const s=Number(a.x),c=Number(a.y);return!Number.isFinite(s)||!Number.isFinite(c)||!/跳转到最新消息|回到最新消息|jump\s+to\s+latest/i.test(o)?!1:s>t.width*.55&&c>t.height*.45&&c<t.height*.92});return A(i?.bbox,t,n)}function Ie(e,t){return y(t)?Se(e,t):e===t||e.includes(t)||t.includes(e)}function G(e,t){if(y(t))return Se(e,t);const n=Me(p(e)),i=Me(p(t));return!n||!i?!1:n===i?!0:n.replace(/\d+$/u,"")===i}function Me(e){return e.toLowerCase().replace(/[l1]/g,"i")}function z(e){return String(e||"").normalize("NFKC").replace(/[（(]\d+[）)]/g,"").replace(/\s+/g,"").replace(/[l1]/gi,"i").toLowerCase().trim()}function E(e){return String(e||"").normalize("NFKC").replace(/[（(]\d+[）)]/g,"").replace(/\s+/g,"").trim()}function y(e){const t=String(e||"").trim();return/^[A-Z0-9_-]{1,6}$/.test(t)&&/[A-Z]/.test(t)}function Se(e,t){const n=String(e||"").normalize("NFKC").replace(/[（(]\d+[）)]/g,"").replace(/\s+/g,"").trim(),i=String(t||"").normalize("NFKC").replace(/[（(]\d+[）)]/g,"").replace(/\s+/g,"").trim();return!!(n&&i&&(n===i||n.replace(/\d+$/u,"")===i))}export{T as WeChatChannelUserActivityAbort,U as captureAndRecognizeWeChatWindow,be as captureWeChatWindow,cn as ensureHelperPreflight,bt as ensureWeChatWindowReady,ln as fallbackWeChatMessageInputPointForWindow,kt as focusExistingWeChatWindow,Ct as focusKnownWeChatWindow,dn as focusWeChatWindow,sn as observeWeChatChannelBindingViaHelper,fe as openConversationBySearch,q as openConversationInVisibleList,ge as recognizeWeChatScreenshot};
+import{defaultWeChatChannelAttachmentDir as _e,resolveVisibleWeChatChannelMedia as Me}from"./media-resolver.js";import{updateWeChatChannelBindingLedger as Se}from"./ledger.js";import{defaultWeChatChannelVectorStorePath as Ne,loadWeChatChannelVectorStore as Te,saveWeChatChannelVectorStore as Be,upsertWeChatChannelVectorReferences as Ee}from"./vector-store.js";import{normalizeWeChatChannelAttachmentAvailability as H,normalizeWeChatChannelMessageKind as We}from"./core/schema.js";import{waitForWeChatChannelPacing as U,weChatChannelPacingDelayMs as Re}from"./pacing.js";import{matchWeChatConversationFingerprints as Fe}from"./fingerprint.js";import{normalizeWeChatAnchorText as x,weChatTextSimilarity as Y}from"./anchor.js";import{decideWeChatChannelActivityGate as Ae,normalizeWeChatChannelActivitySnapshot as Oe}from"./human-coordination.js";const Le=3,Pe=5,De="wechat_login_required",Ke=5500;class S extends Error{reasonCode;stage;action;constructor(t){super(`user_active:${t.reasonCode}:${t.stage}:${t.action}`),this.name="WeChatChannelUserActivityAbort",this.reasonCode=t.reasonCode,this.stage=t.stage,this.action=t.action}}async function sn(e){return await je(e.helper,e.activityGuard,e.traceId).withLease("observe","observe-binding",async n=>$e({...e,helper:n}))}async function $e(e){const t=e.foregroundMode??"required";let n=await ze(e,{foregroundMode:t});if(t!=="background"&&(n=await ue(e.helper,n,e.traceId)),t==="background"){const{capture:a,ocr:s}=await I({helper:e.helper,window:n,traceId:e.traceId}),c=T({capture:a,ocr:s,window:n});if(c)throw new Error(c);if(!A(s,a,e.binding.conversationDisplayName))throw new Error("conversation_not_visible_background");if(V({capture:a,ocr:s,binding:e.binding}))throw new Error("wechat_window_obstructed_background");return e.onObservationEvidence?.({window:n,capture:a,ocr:s}),Z(e)?Q({...e,window:n,capture:a,ocr:s}):L({...e,window:n,capture:a,ocr:s})}const r=await D({helper:e.helper,window:n,binding:e.binding,traceId:e.traceId});if(!r.opened){const a=await X({...e,fallback:n,requireTargetConversation:!1,force:!0});if(a.windowId!==n.windowId){n=await ue(e.helper,a,e.traceId);const s=await D({helper:e.helper,window:n,binding:e.binding,traceId:e.traceId});if(!s.opened)throw new Error(s.reason||r.reason||"conversation_not_opened")}else throw new Error(r.reason||"conversation_not_opened")}let{capture:i,ocr:o}=await I({helper:e.helper,window:n,traceId:e.traceId});if(V({capture:i,ocr:o,binding:e.binding})){n=await It(e.helper,e.traceId);const a=await D({helper:e.helper,window:n,binding:e.binding,traceId:e.traceId});if(!a.opened)throw new Error(a.reason||"wechat_window_obstructed");if({capture:i,ocr:o}=await I({helper:e.helper,window:n,traceId:e.traceId}),V({capture:i,ocr:o,binding:e.binding}))throw new Error("wechat_window_obstructed")}return e.onObservationEvidence?.({window:n,capture:i,ocr:o}),Z(e)?Q({...e,window:n,capture:i,ocr:o}):L({...e,window:n,capture:i,ocr:o})}async function ze(e,t={}){const n=t.foregroundMode??e.foregroundMode??"required",r=await Ct(e.helper,e.traceId,{foreground:n});return n==="background"?r:X({...e,fallback:r,requireTargetConversation:!1,force:t.forceVision})}async function X(e){if(!e.api.classifyWindow)throw new Error("wechat_window_classifier_unavailable");const t=await e.helper.request("windows.list",{},e.traceId);b(t,"windows.list");const n=(t.result?.windows??[]).filter(z).filter(a=>a.visible!==!1&&a.minimized!==!0&&!!a.windowId),r=qe(n.length?n:[e.fallback],e.fallback);if(!r.length)throw new Error("wechat_window_not_found");const i=[];for(const a of r)try{const s=await K(e.helper,a.windowId,e.traceId,a.bounds),c=await e.api.classifyWindow(e.runtime,e.binding,{screenshot:{mimeType:s.mimeType,dataBase64:s.dataBase64,width:s.width,height:s.height,windowId:a.windowId},traceId:e.traceId});i.push({window:a,classification:c,score:Ve(c,e.requireTargetConversation===!0)})}catch{i.push({window:a,classification:null,score:-1})}const o=i.filter(a=>a.score>0).sort((a,s)=>s.score-a.score)[0];if(!o)throw new Error("wechat_chat_main_window_not_found");return o.window}function qe(e,t){const n=[],r=i=>{i?.windowId&&(n.some(o=>o.windowId===i.windowId)||n.push(i))};r(e.find(i=>i.windowId===t.windowId));for(const i of e)r(i);return n}function Ve(e,t){if(!e||e.windowKind!=="chat_main")return 0;const n=Number(e.confidence??0);return t&&e.isTargetConversation!==!0?0:100+(e.isTargetConversation?50:0)+Math.round(Math.max(0,Math.min(1,n))*100)}function je(e,t,n){if(!t)return{helper:e,withLease:async(s,c,l)=>await l(e)};let r=null;const i=s=>{t.onEvent?.({...s,at:new Date().toISOString()})},o=async(s,c,l={})=>{if(r){const u=await e.request("automation.lease.status",{},n),d=u.result??{},f=u.ok&&d.interrupted?J(d.interruptReason):u.ok?void 0:u.errorCode||"user_activity_unknown";if(i({phase:"lease-status",stage:s,action:c,ok:u.ok===!0&&!d.interrupted,...f?{reasonCode:f}:{}}),!u.ok)throw new S({reasonCode:u.errorCode||"user_activity_unknown",stage:s,action:c});if(d.active===!1||d.leaseId!==r||!d.interrupted)return;throw new S({reasonCode:J(d.interruptReason),stage:s,action:c})}const w=Date.now()+He(t.preflightIdleSettleTimeoutMs);for(;;){const u=await e.request("activity.snapshot",{},n);if(!u.ok)throw i({phase:"snapshot",stage:s,action:c,ok:!1,reasonCode:u.errorCode||"user_activity_unknown"}),new S({reasonCode:u.errorCode||"user_activity_unknown",stage:s,action:c});const d=Ae({snapshot:Oe(u.result),stage:s,policy:t.policy});if(i({phase:"snapshot",stage:s,action:c,ok:d.ok,...d.ok?{}:{reasonCode:d.reasonCode,waitMs:d.waitMs}}),d.ok)return;const f=new S({reasonCode:d.reasonCode,stage:s,action:c});if(!l.settle)throw f;const G=w-Date.now();if(G<=0)throw f;await q(Math.max(50,Math.min(d.waitMs,G)))}},a={request:async(s,c,l)=>{const w=Ge(s);w&&await o(w.stage,`${s}:before`);const u=await e.request(s,c,l);return w&&u.ok&&await o(w.stage,`${s}:after`),u}};return{helper:a,async withLease(s,c,l){if(await yt(e,n),await o(s,`${c}:preflight`,{settle:!0}),t.useAutomationLease===!1)return await l(a);const w=await e.request("automation.lease.acquire",{owner:"wechat-channel",purpose:`observe:${c}`,ttlMs:12e4},n);if(r=typeof w.result?.leaseId=="string"?w.result.leaseId:null,i({phase:"lease-acquire",stage:s,action:c,ok:w.ok===!0,...w.ok?{}:{reasonCode:w.errorCode||"user_activity_unknown"}}),!w.ok)throw r=null,new S({reasonCode:w.errorCode||"user_activity_unknown",stage:s,action:c});try{const u=await l(a);return await o(s,`${c}:complete`),u}finally{const u=r;if(r=null,u){const d=await e.request("automation.lease.release",{leaseId:u},n).catch(f=>({ok:!1,errorCode:"automation_lease_release_failed",errorSummary:f instanceof Error?f.message:String(f)}));i({phase:"lease-release",stage:s,action:c,ok:d.ok===!0,...d.ok?{}:{reasonCode:d.errorCode||"automation_lease_release_failed"}})}}}}}function Ge(e){return e==="windows.ensureReady"||e==="windows.focus"||e==="wechat.searchConversation"?{stage:"open_conversation"}:e==="keyboard.shortcut"||e==="mouse.click"||e==="mouse.rightClick"||e==="mouse.scroll"||e==="clipboard.snapshot"||e==="clipboard.readAttachment"||e==="menu.pickItem"?{stage:"dangerous_action"}:null}function J(e){return e==="recent_mouse_activity"||e==="recent_mouse_click"||e==="recent_scroll_activity"||e==="recent_keyboard_activity"||e==="frontmost_app_changed"?e:"user_activity_unknown"}function He(e){return typeof e=="number"&&Number.isFinite(e)&&e>=0?e:Ke}function Z(e){return e.observePipeline==="edge-structure"?!0:e.observePipeline==="server-observe"?!1:!!e.api.structureWindow}async function L(e){const t=await fe(e),n=await e.api.observe(e.runtime,e.binding,{screenshots:[{captureIndex:0,mimeType:t.mimeType,dataBase64:t.dataBase64,width:t.width,height:t.height}],edgeOcrBlocks:e.ocr.blocks??[],visibleConversationFingerprints:e.ocr.visibleConversationFingerprints??[],localLedgerTailAnchors:e.localLedgerTailAnchors??[]}),r=await re({helper:e.helper,runtime:e.runtime,binding:e.binding,messages:n.observedMessages??[],workDir:e.workDir,attachmentsDir:e.attachmentsDir,window:e.window,screenshot:t,windowId:e.window.windowId,traceId:e.traceId,mediaAnchorText:e.mediaAnchorText});return pe(r,ve({ocr:e.ocr,screenshot:t,binding:e.binding,anchors:e.localOutboundEchoAnchors??[]}))}async function Q(e){if(!e.api.structureWindow)throw new Error("wechat_structure_window_unavailable");const t=await fe(e);let n;try{n=await e.api.structureWindow(e.runtime,e.binding,{screenshots:[{captureIndex:0,mimeType:t.mimeType,dataBase64:t.dataBase64,width:t.width,height:t.height}],edgeOcrBlocks:e.ocr.blocks??[],visibleConversationFingerprints:e.ocr.visibleConversationFingerprints??[],localLedgerTailAnchors:e.localLedgerTailAnchors??[]})}catch(c){if(Ue(c))return L(e);throw c}const r=rt(n.structuredMessages??n.observedMessages??[]),i=await Ye({...e,messages:r,screenshot:t}),o=await re({helper:e.helper,runtime:e.runtime,binding:e.binding,messages:i.messages,workDir:e.workDir,attachmentsDir:e.attachmentsDir,window:e.window,screenshot:t,windowId:e.window.windowId,traceId:e.traceId,mediaAnchorText:e.mediaAnchorText}),a=pe(o,ve({ocr:e.ocr,screenshot:t,binding:e.binding,anchors:e.localOutboundEchoAnchors??[]}));return e.localLedger?Se({ledger:e.localLedger,bindingId:e.binding.bindingId,observedMessages:a,baselineOnly:e.baselineOnly,vectorReferences:i.vectorReferences}).newMessages:a}function Ue(e){return e instanceof Error&&/\bedge_runtime_disabled\b/.test(e.message)}async function Ye(e){const t=Xe(e.messages);if(!t.length)return{messages:e.messages,vectorReferences:[]};const n=e.api.embedVisual?await Ze({...e,seedBlocks:t}):t.filter(a=>h(a.vectorBase64)||h(a.signature));if(!n.length)return{messages:e.messages,vectorReferences:[]};const r=e.vectorStorePath??Ne(e.workDir||process.cwd(),e.runtime.runtimeId),i=Te(r,e.runtime.runtimeId),o=Ee({store:i,bindingId:e.binding.bindingId,blocks:n});return o.length?(Be(r,i),{messages:tt(e.messages,o),vectorReferences:o}):{messages:e.messages,vectorReferences:[]}}function Xe(e){const t=[];for(const n of e)for(const[r,i]of(n.visualBlocks??[]).entries()){const o=h(i.blockId)||`${n.stableMessageKey}:visual-${r}`,a=h(i.blockKind)||n.kind||"visual";t.push({...i,stableMessageKey:n.stableMessageKey,blockId:o,blockKind:a,...i.bbox!==void 0?{bbox:i.bbox}:n.bbox!==void 0?{bbox:n.bbox}:{}})}return t}async function Je(e){if(!e.api.embedVisual)return[];const t=await e.api.embedVisual(e.runtime,e.binding,{screenshots:[{captureIndex:0,mimeType:e.screenshot.mimeType,dataBase64:e.screenshot.dataBase64,width:e.screenshot.width,height:e.screenshot.height}],visualBlocks:e.seedBlocks,traceId:e.traceId});return et(t.visualBlocks??t.embeddedBlocks??[],e.seedBlocks)}async function Ze(e){try{return await Je(e)}catch(t){if(Qe(t))throw t;return[]}}function Qe(e){return!e||typeof e!="object"?!1:e.reasonCode==="insufficient_credits"?!0:e instanceof Error&&/\binsufficient_credits\b/.test(e.message)}function et(e,t){return e.map((n,r)=>{const i=t[r];return{...n,stableMessageKey:h(n.stableMessageKey)||h(i?.stableMessageKey),blockId:h(n.blockId)||h(i?.blockId),blockKind:h(n.blockKind)||h(i?.blockKind)||"visual",...n.bbox!==void 0?{bbox:n.bbox}:i?.bbox!==void 0?{bbox:i.bbox}:{}}}).filter(n=>h(n.stableMessageKey)&&h(n.blockId))}function tt(e,t){const n=new Map;for(const r of t){const i=n.get(r.stableMessageKey)??[];i.push(r),n.set(r.stableMessageKey,i)}return e.map(r=>{const i=n.get(r.stableMessageKey);return i?.length?{...r,visualBlocks:nt(r,i)}:r})}function nt(e,t){const r=(e.visualBlocks??[]).map((o,a)=>{const s=h(o.blockId)||`${e.stableMessageKey}:visual-${a}`,c=t.find(l=>l.blockId===s);return c?ee(c,o):te(o)}),i=new Set(r.map(o=>o.blockId));for(const o of t)i.has(o.blockId)||r.push(ee(o));return r}function ee(e,t){return{...t?te(t):{},stableMessageKey:e.stableMessageKey,blockId:e.blockId,blockKind:e.blockKind,vectorStoreKey:e.vectorStoreKey,model:e.model,...e.modelVersion!==void 0?{modelVersion:e.modelVersion}:{},dims:e.dims,...e.signature?{signature:e.signature}:{},...e.bbox!==void 0?{bbox:e.bbox}:{}}}function te(e){const{vectorBase64:t,...n}=e;return n}function rt(e){return e.map((t,n)=>it(t,n)).filter(t=>t!=null)}function it(e,t){if(!m(e))return null;const n=We(e.kind),r=st(e.senderRole),i=g(e.normalizedText),o=g(e.anchorText)??i??g(e.textExcerpt),a=h(e.stableMessageKey)||ot({message:e,index:t,senderRole:r,kind:n,anchorText:o});return{stableMessageKey:a,senderRole:r,...g(e.senderName)!==null?{senderName:g(e.senderName)}:{},kind:n,...i!==null?{normalizedText:i}:{},...o!==null?{anchorText:o}:{},...C(e,"anchorMetadata")?{anchorMetadata:e.anchorMetadata}:{},...C(e,"neighborContext")?{neighborContext:e.neighborContext}:{},...g(e.textExcerpt)!==null?{textExcerpt:g(e.textExcerpt)}:{},...C(e,"bbox")?{bbox:e.bbox}:{},...C(e,"mediaMetadata")?{mediaMetadata:at(e.mediaMetadata)}:{},...typeof e.isBaseline=="boolean"?{isBaseline:e.isBaseline}:{},...g(e.deliveryStatus)!==null?{deliveryStatus:g(e.deliveryStatus)??void 0}:{},...g(e.observedAt)!==null?{observedAt:g(e.observedAt)??void 0}:{},...Array.isArray(e.visualBlocks)?{visualBlocks:e.visualBlocks}:{},...o?{}:{anchorText:a}}}function ot(e){const t=m(e.message.bbox)?JSON.stringify(e.message.bbox):"";return`structured-window:${[e.index,e.senderRole,e.kind,e.anchorText||h(e.message.textExcerpt)||"",t].join(":").slice(0,180)}`}function at(e){if(!m(e))return e;const t={...e};return C(t,"availability")&&(t.availability=H(t.availability)),m(t.attachment)&&(t.attachment=ne(t.attachment)),Array.isArray(t.attachments)&&(t.attachments=t.attachments.map(n=>m(n)?ne(n):n)),t}function ne(e){const t={...e};return C(t,"availability")&&(t.availability=H(t.availability)),t}function st(e){return e==="self"||e==="contact"||e==="system"||e==="unknown"?e:"unknown"}async function re(e){if(e.binding.downloadMedia===!1)return e.messages;const t=e.messages.map((o,a)=>ft(o,e.screenshot,e.window,ht(e.messages,a))).filter((o,a)=>ct(e.messages,a,e.mediaAnchorText)).filter(o=>o!=null);if(!t.length)return e.messages;const n=e.attachmentsDir??_e(e.workDir||process.cwd(),e.runtime.runtimeId,e.binding.bindingId),r=await Me({helper:e.helper,candidates:t,attachmentsDir:n,screenshot:e.screenshot,windowId:e.windowId,window:e.window,traceId:e.traceId,platform:e.runtime.policy.platform,stabilityCheck:async()=>{const o=await M({helper:e.helper,window:e.window,binding:e.binding,traceId:e.traceId});return o.ok?{ok:!0}:{ok:!1,reasonCode:o.reason}}});if(!r.length)return e.messages;const i=new Map(r.map(o=>[o.messageKey,o]));return e.messages.map(o=>{const a=i.get(o.stableMessageKey);return a?{...o,mediaMetadata:bt(o.mediaMetadata,a.attachment,a.reasonCode,a.attemptReasonCodes,a.resolveTrace)}:o})}function ct(e,t,n){const r=oe(n);if(!r)return!0;const i=dt(r),o=e.map((a,s)=>oe(wt(a)).includes(r)?s:-1).filter(a=>a>=0);if(!o.length)return t===lt(e,i);for(const a of o)if(t>=a&&t<=a+8||t===a-1&&!e.slice(a+1,Math.min(e.length,a+9)).some(ie))return!0;return!1}function dt(e){return e.includes("video")||e.includes("vide0")?"video":e.includes("image")||e.includes("photo")||e.includes("ph0t0")||e.includes("picture")?"image":e.includes("file")||e.includes("document")?"file":null}function lt(e,t=null){for(let n=e.length-1;n>=0;n-=1)if(ie(e[n]))return ut(e[n],t)?n:-1;return-1}function ie(e){if(!e)return!1;const t=String(e.kind||"").toLowerCase(),n=m(e.mediaMetadata)?e.mediaMetadata:{},r=m(n.attachment)?n.attachment:{};return ae(t,n,r)}function ut(e,t){if(!e||!t)return!0;const n=String(e.kind||"").toLowerCase(),r=m(e.mediaMetadata)?e.mediaMetadata:{},i=m(r.attachment)?r.attachment:{},o=String(i.type||"").toLowerCase(),a=String(i.mimeType||"").toLowerCase(),s=String(i.name||i.localPath||e.anchorText||e.textExcerpt||"").toLowerCase();return t==="video"?n.includes("video")||o==="video"||a.startsWith("video/")||/\.(mp4|mov|m4v|avi|mkv|webm)$/i.test(s):t==="image"?/image|photo|picture/.test(n)||o==="image"||a.startsWith("image/")||/\.(png|jpe?g|gif|webp|heic|tiff?|bmp)$/i.test(s):/file|document/.test(n)||o==="file"||!/image|photo|picture|video/.test(n)&&o!=="image"&&o!=="video"&&!a.startsWith("image/")&&!a.startsWith("video/")}function wt(e){if(!e)return"";const t=e;return[e.normalizedText,e.anchorText,e.textExcerpt,t.text].map(n=>String(n||"")).join(`
+`)}function oe(e){return String(e||"").normalize("NFKC").replace(/[o]/giu,"0").replace(/[^\p{L}\p{N}]/gu,"").toLowerCase()}function ht(e,t){return[e[t-1],e[t],e[t+1]].map(r=>r&&(r.normalizedText||r.anchorText||r.textExcerpt)||"").map(r=>String(r||"").trim()).filter(Boolean).join(`
+`)||null}function ft(e,t,n,r){const i=String(e.kind||"").toLowerCase(),o=m(e.mediaMetadata)?e.mediaMetadata:{},a=m(o.attachment)?o.attachment:{},s=h(a.availability)||h(o.availability),c=h(a.localPath)||h(o.localPath);if(s==="edge-local"&&c||!ae(i,o,a))return null;const l=W(e.bbox)??W(o.bbox)??W(o.downloadActionBbox),w=W(o.downloadActionBbox),u=se(l,t,n),d=gt(l,t,n),f=se(w,t,n);return{messageKey:e.stableMessageKey,kind:h(a.type)||h(a.kind)||h(o.messageType)||i,fileName:h(a.name)||h(a.fileName)||h(o.fileName)||null,mimeType:h(a.mimeType)||h(o.mimeType)||null,size:k(a.size)??k(o.size),mediaStatus:mt(o,a),observedAt:e.observedAt??null,contextText:r??e.normalizedText??e.anchorText??e.textExcerpt??null,...u?{bbox:u}:{},...d?{screenshotBbox:d}:{},...f?{downloadActionBbox:f}:{}}}function bt(e,t,n,r,i){const o=m(e)?{...e}:{};return{...o,availability:m(t)?t.availability:o.availability,mediaStatus:m(t)&&t.availability==="edge-local"?"downloaded":o.mediaStatus,attachment:t,edgeResolveReasonCode:n,...r?.length?{edgeResolveAttempts:r}:{},...i?{edgeResolveTrace:i}:{}}}function mt(e,t){const n=h(e.mediaStatus);if(n==="not_downloaded")return"not_downloaded";if(n==="downloaded"||n==="available")return"available";const r=h(t.availability)||h(e.availability);return r==="pending-download"?"not_downloaded":r==="metadata-only"?"metadata_only":n||null}function ae(e,t,n){const r=`${e} ${h(t.messageType)} ${h(n.type)} ${h(n.kind)}`.toLowerCase();return/image|photo|video|file|document/.test(r)}function W(e){if(!m(e))return null;const t=k(e.x),n=k(e.y),r=k(e.width),i=k(e.height);return t==null||n==null||r==null||i==null?null:{x:t,y:n,width:r,height:i,...typeof e.coordinateSpace=="string"?{coordinateSpace:e.coordinateSpace}:{}}}function se(e,t,n){if(!e)return null;if(e.coordinateSpace==="screen")return e;const r=B(e,t,n);if(!r)return e;const i=n.bounds;if(!i?.width||!i?.height)return{...e,x:r.x-e.width/2,y:r.y-e.height/2,coordinateSpace:"screen"};const o=i.width/t.width,a=i.height/t.height,s=r.x,c=r.y;return{x:s-e.width*o/2,y:c-e.height*a/2,width:e.width*o,height:e.height*a,coordinateSpace:"screen"}}function gt(e,t,n){if(!e)return null;if(e.coordinateSpace!=="screen")return{...e,coordinateSpace:"screenshotPixel"};const r=n.bounds;if(!r?.width||!r?.height)return null;const i=t.width/r.width,o=t.height/r.height;return{x:(e.x-r.x)*i,y:(e.y-r.y)*o,width:e.width*i,height:e.height*o,coordinateSpace:"screenshotPixel"}}function m(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function C(e,t){return Object.prototype.hasOwnProperty.call(e,t)}function h(e){return typeof e=="string"?e.trim():""}function g(e){return h(e)||null}function k(e){const t=Number(e);return Number.isFinite(t)?t:null}async function cn(e,t){await de(e,t)}async function yt(e,t){await ce(e,t)}async function ce(e,t){const n=await e.request("permissions.check",{},t);b(n,"permissions.check");const r=n.result??{},i=await xt(e,r,t);if(i==="screen-recording")throw new Error("permission_screen_recording_missing");if(i==="accessibility")throw new Error("permission_accessibility_missing");if(i==="input-monitoring")throw new Error("permission_input_monitoring_missing");if(r.automation===!1)throw new Error("permission_automation_missing");return r}async function de(e,t,n={}){const r=await ce(e,t);if(r.wechatRunning===!1)throw new Error("wechat_not_running");if(kt(r))throw new Error("windows_visible_desktop_unavailable");if(r.dpiMappingAvailable===!1||r.displayTopologySupported===!1)throw new Error("dpi_mapping_failed");if(r.wechatMainWindowResponsive===!1)throw new Error("wechat_window_unresponsive");if(r.wechatWindowAvailable===!1&&String(r.platform??"").toLowerCase()!=="win32"&&n.allowUnavailableWindow!==!0)throw new Error("wechat_window_unavailable");return r}async function xt(e,t,n){const r=vt(t);if(!r||process.platform!=="darwin")return r;const i=pt(r);try{await e.request(i,{},n)}catch{}return r}function vt(e){return e.screenRecording===!1?"screen-recording":e.accessibility===!1?"accessibility":e.inputMonitoring===!1?"input-monitoring":null}function pt(e){return e==="screen-recording"?"permissions.requestScreenRecording":e==="accessibility"?"permissions.requestAccessibility":"permissions.requestInputMonitoring"}async function Ct(e,t,n={}){const i=(n.foreground??"required")!=="background",o=await de(e,t,{allowUnavailableWindow:i});if(String(o.platform??"").toLowerCase()==="win32"){const c=await e.request("windows.ensureReady",{activate:i,allowRecovery:!1,allowLaunch:!1},t);b(c,"windows.ensureReady");const l=c.result;if(!l?.windowId)throw new Error("helper_invalid_response: windows.ensureReady missing WeChat window data");return l}const a=await e.request("windows.ensureReady",{restore:i,focus:i},t);b(a,"windows.ensureReady");const s=a.result;if(!s?.windowId)throw new Error("helper_invalid_response: windows.ensureReady missing WeChat window data");return s}function kt(e){return e.windowsVisibleDesktopAvailable===!1||e.rdpVisibleDesktopAvailable===!1||e.desktopSessionVisible===!1||e.screenLocked===!0||e.rdpDisconnected===!0}function le(e){const t=e.filter(z),n=t.filter(i=>i.visible!==!1&&i.minimized!==!0);return(n.length?n:t)[0]??null}async function dn(e,t){let n=await e.request("windows.list",{},t);b(n,"windows.list");let r=n.result?.windows??[],i=le(r);if(!i)throw new Error("wechat_window_not_found");const o=await e.request("windows.focus",{windowId:i.windowId},t);return b(o,"windows.focus"),await we(e,i,t)}async function ue(e,t,n){if(!t.windowId)throw new Error("wechat_window_not_found");const r=await e.request("windows.focus",{windowId:t.windowId},n);return b(r,"windows.focus"),t}async function It(e,t){const n=await e.request("windows.list",{},t);b(n,"windows.list");const r=n.result?.windows??[],i=le(r);if(!i)throw new Error("wechat_window_not_found");const o=await e.request("windows.focus",{windowId:i.windowId},t);return b(o,"windows.focus"),await we(e,i,t)}async function we(e,t,n){let r;try{r=await e.request("windows.list",{},n)}catch{return t}if(!r.ok)return t;const i=(r.result?.windows??[]).filter(z);return i.find(o=>o.windowId===t.windowId)??i[0]??t}async function P(e){const{capture:t,ocr:n}=e.observation??await I(e),r=T({capture:t,ocr:n,window:e.window});if(r)return{opened:!1,reason:r};const i=Fe({visibleItems:Ft(n,t,e.allowOcrTitleRows!==!1),targets:[{bindingId:e.binding.bindingId,conversationDisplayName:e.binding.conversationDisplayName}]})[0];if(!i)return{opened:!1,reason:"conversation_not_visible"};const o=Xt(i.item.bbox,t,e.window);if(!o)return{opened:!1,reason:"conversation_bbox_missing"};const a=await e.helper.request("mouse.click",{x:o.x,y:o.y,coordinateSpace:"screen",windowId:e.window.windowId},e.traceId);return b(a,"mouse.click"),{opened:!0,reason:i.reason}}async function D(e){let t={opened:!1,reason:"conversation_not_opened"};for(let r=0;r<Le;r+=1){if(t=await _t(e),t.opened||t.reason!=="conversation_title_not_confirmed")return t;await _(e,"open-retry",`retry:${r}`)}const n=await he(e);return n.opened?{opened:!0,reason:`${n.reason}:final-visible-recovery`}:t}async function _t(e){const t=await I(e),n=T({capture:t.capture,ocr:t.ocr,window:e.window});if(n)return{opened:!1,reason:n};let r=!1;if(A(t.ocr,t.capture,e.binding.conversationDisplayName))return e.settleToBottom===!0&&await N({helper:e.helper,window:e.window,traceId:e.traceId,observation:t}),{opened:!0,reason:"current-conversation-title-confirmed"};if(!r){const u=await P({...e,observation:t});if(u.opened){if(await _(e,"open-click-settle","visible-initial"),(await M(e)).ok)return{opened:!0,reason:u.reason};const f=await he(e);if(f.opened)return f}}const i=Et(e,t),o=await e.helper.request("wechat.searchConversation",{conversationName:e.binding.conversationDisplayName,windowId:e.window.windowId,waitMs:e.searchDelayMs??R(e,"search-input-settle","search-input"),...i?{searchPoint:i}:{}},e.traceId);b(o,"wechat.searchConversation");const a=await Mt(e);if(a.opened){await _(e,"open-click-settle","search-result-click");const u=await M(e);return u.ok?(e.settleToBottom===!0&&await N({helper:e.helper,window:e.window,traceId:e.traceId}),{opened:!0,reason:a.reason}):{opened:!1,reason:u.reason}}let s=a.observation;const c=y(e.binding.conversationDisplayName)&&a.reason==="search_result_not_visible";if(!y(e.binding.conversationDisplayName)){await Rt(e.helper,e.traceId),await _(e,"open-click-settle","search-return");const u=await M(e);if(u.ok)return e.settleToBottom===!0&&await N({helper:e.helper,window:e.window,traceId:e.traceId}),{opened:!0,reason:u.reason};const d=await e.helper.request("wechat.searchConversation",{conversationName:e.binding.conversationDisplayName,windowId:e.window.windowId,waitMs:e.searchDelayMs??R(e,"search-input-settle","search-input-retry-after-return"),...i?{searchPoint:i}:{}},e.traceId);b(d,"wechat.searchConversation"),s=void 0}const l=await P({...e,...s?{observation:s}:{},allowOcrTitleRows:!c});if(!l.opened)return l;await _(e,"open-click-settle","visible-final");const w=await M(e);return w.ok?(e.settleToBottom===!0&&await N({helper:e.helper,window:e.window,traceId:e.traceId}),{opened:!0,reason:l.reason}):{opened:!1,reason:w.reason}}async function he(e){const t=await P(e);if(!t.opened)return t;await _(e,"open-click-settle","visible-retry");const n=await M(e);return n.ok?(e.settleToBottom===!0&&await N({helper:e.helper,window:e.window,traceId:e.traceId}),{opened:!0,reason:`${t.reason}:retry-visible-title-confirmed`}):{opened:!1,reason:n.reason}}function ln(e){const t=e.bounds,n=Number(t?.x),r=Number(t?.y),i=Number(t?.width),o=Number(t?.height);if(![n,r,i,o].every(Number.isFinite)||i<=0||o<=0)return null;const a=Math.max(520,Math.min(i-160,i*.68)),s=Math.max(48,Math.min(88,o*.08));return{x:Math.round(n+a),y:Math.round(r+o-s),coordinateSpace:"screen"}}async function Mt(e){let t;const n=e.searchDelayMs===0?0:R(e,"search-result-probe","search-result-probe"),r=y(e.binding.conversationDisplayName)?Pe:1;for(let i=0;i<r;i+=1){i>0&&n>0&&await q(n);const o=await St(e);t=o;const{capture:a,ocr:s}=o,c=T({capture:a,ocr:s,window:e.window});if(c)return{opened:!1,reason:c,observation:o};const l=Lt(s,a,e.binding.conversationDisplayName);if(!l){if(Pt(s)||Dt(s,e.binding.conversationDisplayName))break;continue}const w=B(l.bbox,a,Nt(a,e.window));if(!w)return{opened:!1,reason:"search_result_bbox_missing",observation:o};const u=await e.helper.request("mouse.click",{x:w.x,y:w.y,coordinateSpace:"screen",windowId:e.window.windowId},e.traceId);return b(u,"mouse.click"),{opened:!0,reason:l.reason,observation:o}}return{opened:!1,reason:"search_result_not_visible",observation:t}}async function St(e){if(e.window.bounds&&y(e.binding.conversationDisplayName)){const t=await e.helper.request("screen.capture",{bounds:e.window.bounds},e.traceId);if(t.ok&&t.result?.dataBase64&&t.result.width&&t.result.height){const n={...t.result,windowId:e.window.windowId,bounds:t.result.bounds??e.window.bounds},r=await be(e.helper,n,e.traceId);return{capture:n,ocr:r}}t.errorCode&&t.errorCode!=="helper_unknown_command"&&t.errorCode!=="helper_command_unsupported"&&b(t,"screen.capture")}return I(e)}function Nt(e,t){return e.bounds?{...t,bounds:e.bounds}:t}async function I(e){let{capture:t,ocr:n}=await $(e.helper,e.window.windowId,e.traceId,e.window.bounds);return await Tt({helper:e.helper,window:e.window,capture:t,ocr:n,traceId:e.traceId})&&(await U("preview-dismiss-settle",`${e.traceId||""}:${e.window.windowId}:preview-dismiss`),{capture:t,ocr:n}=await $(e.helper,e.window.windowId,e.traceId,e.window.bounds)),{capture:t,ocr:n}}async function Tt(e){const t=Bt(e.ocr,e.capture,e.window);if(!t)return!1;for(const n of[async()=>e.helper.request("keyboard.shortcut",{key:"escape",modifiers:[]},e.traceId),async()=>e.helper.request("mouse.click",{x:t.x,y:t.y,coordinateSpace:"screen",windowId:e.window.windowId},e.traceId)])if((await n()).ok)return!0;return!1}function Bt(e,t,n){const r=e.blocks??[],i=r.find(c=>{const l=String(c.text||""),w=c.bbox;if(!w)return!1;const u=Number(w.x),d=Number(w.y);return Number.isFinite(u)&&Number.isFinite(d)&&d>t.height*.06&&d<t.height*.22&&u>t.width*.3&&/查看原视频|查看原图|原视频|原图|视频|图片|图像/.test(l)});if(!i)return null;const o=i.bbox,a=Number(o?.y);if(!Number.isFinite(a))return null;const s=r.filter(c=>{const l=String(c.text||"").trim(),w=c.bbox;if(!w||l!=="\xD7")return!1;const u=Number(w.x),d=Number(w.y);return Number.isFinite(u)&&Number.isFinite(d)&&u>t.width*.55&&u<t.width*.9&&Math.abs(d-a)<t.height*.08}).sort((c,l)=>Number(l.bbox?.x??0)-Number(c.bbox?.x??0))[0];return B(s?.bbox,t,n)}function Et(e,t){const{capture:n,ocr:r}=t,i=(r.blocks??[]).find(o=>{const a=String(o.text||"").trim().toLowerCase(),s=o.bbox;if(!s||!/^(搜索|search)$/.test(a))return!1;const c=Number(s.x),l=Number(s.y);return Number.isFinite(c)&&Number.isFinite(l)&&c<n.width*.22&&l<n.height*.12});return B(i?.bbox,n,e.window)}async function K(e,t,n,r){const i=await e.request("windows.capture",{windowId:t,scope:"full-window",...r?{bounds:r}:{}},n);b(i,"windows.capture");const o=i.result;if(!o?.dataBase64||!o.mimeType||!o.width||!o.height)throw new Error("helper_invalid_response: windows.capture missing screenshot data");return o}async function fe(e){return e.capture.dataBase64?e.capture:K(e.helper,e.window.windowId,e.traceId,e.window.bounds)}async function $(e,t,n,r){const i=await e.request("windows.captureAndOcr",{windowId:t,scope:"full-window",...r?{bounds:r}:{}},n);if(i.ok&&i.result?.capture&&i.result?.ocr)return{capture:i.result.capture,ocr:i.result.ocr};!i.ok&&i.errorCode&&i.errorCode!=="helper_unknown_command"&&i.errorCode!=="helper_command_unsupported"&&b(i,"windows.captureAndOcr");const o=await K(e,t,n,r),a=await be(e,o,n);return{capture:o,ocr:a}}async function be(e,t,n){const r=await e.request("ocr.recognize",{mimeType:t.mimeType,dataBase64:t.dataBase64,width:t.width,height:t.height},n);return b(r,"ocr.recognize"),r.result??{}}function b(e,t){if(!e.ok)throw new Error(`${e.errorCode||"helper_command_failed"}: ${e.errorSummary||t}`)}function z(e){const t=String(e.appName||"").toLowerCase();return t==="wechat"||t==="weixin"}function q(e){return new Promise(t=>setTimeout(t,e))}function R(e,t,n){return e.searchDelayMs===0?0:Re(t,Wt(e,n))}async function _(e,t,n){const r=R(e,t,n);r>0&&await q(r)}function Wt(e,t){return`${e.traceId||""}:${e.binding.conversationDisplayName}:${t}`}async function Rt(e,t){const n=await e.request("keyboard.shortcut",{key:"return",modifiers:[]},t);b(n,"keyboard.shortcut")}async function N(e){if(!e.window.bounds)return;const t=e.observation,n=Jt(t?.ocr,t?.capture,e.window);if(n){const r=await e.helper.request("mouse.click",{x:n.x,y:n.y,coordinateSpace:"screen",windowId:e.window.windowId},e.traceId);b(r,"mouse.click"),await U("jump-latest-settle",`${e.traceId||""}:${e.window.windowId}:jump-latest`)}}async function M(e){const{capture:t,ocr:n}=await $(e.helper,e.window.windowId,e.traceId,e.window.bounds),r=T({capture:t,ocr:n,window:e.window});return r?{ok:!1,reason:r}:A(n,t,e.binding.conversationDisplayName)?{ok:!0,reason:"target-conversation-title-confirmed"}:{ok:!1,reason:"conversation_title_not_confirmed"}}function T(e){const n=(e.ocr.blocks??[]).map(r=>$t(r.text)).filter(Boolean).join("");return/(扫码登录|仅传输文件|重新登录|为了安全|安全验证|登录微信|微信登录|该账号已登录|帐号已登录|账号已登录|当前账号已登录|当前帐号已登录|已登录|进入微信|進入微信)/u.test(n)?De:null}function Ft(e,t,n=!0){const r=n?At(e.blocks??[],t):[];return r.length?r:e.visibleConversationFingerprints??[]}function At(e,t){const n=e.map(i=>me(i)).filter(i=>!!i).filter(i=>i.text.length>=2).filter(i=>i.x>t.width*.08&&i.x<t.width*.38).filter(i=>i.y>t.height*.06&&i.y<t.height*.96).filter(i=>!ge(i.text)),r=new Set;return n.filter(i=>!Ot(i,n,t)).sort((i,o)=>i.y-o.y||i.x-o.x).map(i=>{const o=i.text.trim();return{title:o,bbox:{x:Math.max(0,i.x-24),y:Math.max(0,i.y-Math.max(24,i.height)),width:Math.max(120,t.width*.3),height:Math.max(48,i.height+40),coordinateSpace:"screenshotPixel"},fingerprint:o.toLowerCase()}}).filter(i=>{const o=E(i.title);return!o||r.has(o)?!1:(r.add(o),!0)})}function me(e){const t=e.bbox,n=String(e.text||"").normalize("NFKC").trim(),r=Number(t?.x),i=Number(t?.y),o=Number(t?.width),a=Number(t?.height);return!n||![r,i,o,a].every(Number.isFinite)?null:{text:n,x:r,y:i,width:o,height:a}}function Ot(e,t,n){const r=Math.max(36,Math.min(64,n.height*.058));return t.some(i=>i!==e&&i.y<e.y&&e.y-i.y<=r&&Math.abs(i.x-e.x)<=16&&i.height>=e.height*.85)}function ge(e){const t=v(e);return/^(搜索|微信|通讯录|收藏|设置|文件传输助手|search)$/iu.test(t)||F(t)||Kt(t)||/^包含[:：]?/u.test(t)||/搜索网络结果/u.test(t)}function Lt(e,t,n){const r=(e.blocks??[]).map(s=>me(s)).filter(s=>!!s),i=r.filter(s=>F(v(s.text))).sort((s,c)=>s.y-c.y||s.x-c.x),o=["\u7FA4\u804A","GroupChats","\u8054\u7CFB\u4EBA","Contacts"];for(const s of o){const c=i.findIndex(d=>v(d.text)===s);if(c<0)continue;const l=i[c],w=i[c+1]?.y??Number.POSITIVE_INFINITY,u=r.filter(d=>d.y>l.y&&d.y<w).filter(d=>d.x<t.width*.7).filter(d=>d.text.length>=2).filter(d=>!F(v(d.text))).filter(d=>!xe(d,r)).filter(d=>j(d.text,n)).sort((d,f)=>d.y-f.y||d.x-f.x)[0];if(u)return{bbox:ye(u,t),reason:"search-result-title"}}const a=r.filter(s=>s.y>t.height*.12&&s.y<t.height*.82).filter(s=>s.x>t.width*.08&&s.x<t.width*.45).filter(s=>s.text.length>=2).filter(s=>!ge(s.text)).filter(s=>!xe(s,r)).filter(s=>j(s.text,n)).sort((s,c)=>s.y-c.y||s.x-c.x)[0];return y(n)?null:a?{bbox:ye(a,t),reason:"search-result-title"}:null}function ye(e,t){return{x:Math.max(0,e.x-24),y:Math.max(0,e.y-12),width:Math.max(e.width+t.width*.18,160),height:Math.max(e.height+28,44),coordinateSpace:"screenshotPixel"}}function F(e){return/^(群聊|联系人|聊天记录|公众号|小程序|GroupChats|Contacts|ChatHistory|OfficialAccounts|MiniPrograms)$/u.test(e)}function Pt(e){return(e.blocks??[]).some(t=>F(v(t.text)))}function Dt(e,t){return(e.visibleConversationFingerprints??[]).some(n=>j(n.title,t))}function v(e){return String(e||"").normalize("NFKC").replace(/[^\p{L}\p{N}_-]/gu,"").trim()}function xe(e,t){return/^包含[:：]?/u.test(e.text.trim())?!0:t.some(n=>n!==e&&Math.abs(n.y-e.y)<=Math.max(18,e.height)&&n.x<e.x&&/^包含[:：]?/u.test(n.text.trim()))}function Kt(e){const t=String(e||"").trim();return!!(/^(星期[一二三四五六日天]|周[一二三四五六日天])\s*\d{1,2}:\d{2}$/u.test(t)||/^\d{1,2}:\d{2}(?::\d{2})?$/u.test(t)||/^\d{4}[-/.年]\d{1,2}(?:[-/.月]\d{1,2}日?)?$/u.test(t)||/^\d{1,2}[-/.月]\d{1,2}日?$/u.test(t))}function $t(e){return String(e||"").normalize("NFKC").replace(/\s+/g,"").trim()}function A(e,t,n){const r=y(n)?E(n):O(n);return r?(e.blocks??[]).some(i=>{const o=y(n)?E(i.text):O(i.text);if(!o||!Ce(o,r))return!1;const a=i.bbox;if(!a)return!1;const s=Number(a.x),c=Number(a.y);if(!Number.isFinite(s)||!Number.isFinite(c))return!1;const l=s>t.width*.32&&s<t.width*.78&&c<t.height*.16,w=s<t.width*.18&&c<t.height*.12;return l||w}):!1}function V(e){if(A(e.ocr,e.capture,e.binding.conversationDisplayName))return!1;const t=(e.ocr.blocks??[]).map(s=>String(s.text||"").normalize("NFKC").replace(/\s+/g," ").trim()).filter(Boolean),n=t.join(`
+`),i=[{pattern:/UTF-?8/iu,source:n},{pattern:/Unix\s*\(LF\)/iu,source:n},{pattern:/纯文本/u,source:n},{pattern:/\d+\s*个字符/u,source:n},{pattern:/\bH1\b/u,source:n},{pattern:/^查看$/u,source:t}].reduce((s,c)=>{const l=Array.isArray(c.source)?c.source.some(w=>c.pattern.test(w)):c.pattern.test(c.source);return s+(l?1:0)},0);if(i>=2)return!0;const o=(e.ocr.blocks??[]).filter(s=>Number(s.bbox?.y)<e.capture.height*.14).map(s=>String(s.text||"")).join(`
+`);return/\.(txt|md|rtf|docx?|pdf)\b/i.test(o)&&i>=1||/\.(png|jpe?g|gif|webp|bmp|heic|mp4|mov|m4v|avi|mkv|webm)\b/i.test(o)&&zt(e.capture,e.ocr)?!0:((e.ocr.visibleConversationFingerprints??[]).some(s=>{const c=y(e.binding.conversationDisplayName)?E(s.title):O(s.title),l=y(e.binding.conversationDisplayName)?E(e.binding.conversationDisplayName):O(e.binding.conversationDisplayName);return!!(c&&l&&Ce(c,l))}),!1)}function zt(e,t){const n=(t.blocks??[]).map(o=>String(o.text||"").normalize("NFKC").trim()).filter(Boolean),r=n.join(`
+`);if(/\b\d+\s*x\s*\d+\b/i.test(r)&&/\b\d+(\.\d+)?\s*(B|KB|MB|GB)\b/i.test(r)||/\b100%\b/.test(r)&&n.length<=20)return!0;const i=n.filter(o=>!/^(□|×|\+|…|\.\.\.|100%|\d+|发送)$/u.test(o));return e.width>600&&e.height>500&&i.length<=6}function ve(e){const t=e.anchors.map(o=>({...o,normalized:x(o.expectedEchoAnchor)})).filter(o=>o.normalized);if(!t.length)return[];const n=[],r=new Set,i=qt(e.ocr,e.screenshot).sort((o,a)=>x(a.text).length-x(o.text).length);for(const o of i){const a=x(o.text);if(!a)continue;const s=t.find(l=>Vt(l.normalized,a));if(!s)continue;const c=`local-outbound-echo:${e.binding.bindingId}:${s.idempotencyKey||s.replyId||s.normalized}`;r.has(c)||(r.add(c),n.push({stableMessageKey:c,senderRole:"self",kind:"text",normalizedText:a,anchorText:a,textExcerpt:o.text.trim(),bbox:o.bbox??null,observedAt:new Date().toISOString(),deliveryStatus:"suppressed"}))}return n}function qt(e,t){const n=(e.blocks??[]).filter(i=>Yt(i,t)&&x(i.text)).sort((i,o)=>p(i.bbox,"y")-p(o.bbox,"y")),r=n.map(i=>({text:String(i.text||"").trim(),bbox:i.bbox}));for(let i=0;i<n.length;i+=1){const o=[n[i]];for(let a=i+1;a<n.length&&o.length<5;a+=1){const s=n[a];if(!jt(o[o.length-1],s,t))break;o.push(s),r.push({text:Gt(o.map(c=>String(c.text||"").trim())),bbox:Ut(o.map(c=>c.bbox))})}}return r}function Vt(e,t){if(!e||!t)return!1;if(Y(e,t)>=.88)return!0;const n=e.replace(/\s+/g,""),r=t.replace(/\s+/g,"");return r.length>=8&&n.includes(r)}function jt(e,t,n){const r=p(e.bbox,"x"),i=p(e.bbox,"y"),o=p(e.bbox,"height"),a=p(t.bbox,"x"),s=p(t.bbox,"y");if(![r,i,o,a,s].every(Number.isFinite)||r<n.width*.5||a<n.width*.5)return!1;const c=s-(i+o);return c>=-8&&c<=Math.max(64,n.height*.04)&&Math.abs(a-r)<=120}function Gt(e){return e.reduce((t,n)=>t?n?`${t}${Ht(t,n)?" ":""}${n}`:t:n,"")}function Ht(e,t){return/[A-Za-z0-9]$/u.test(e)&&/^[A-Za-z0-9]/u.test(t)}function Ut(e){const t=e.filter(c=>!!c);if(!t.length)return;const n=t.map(c=>Number(c.x)).filter(Number.isFinite),r=t.map(c=>Number(c.y)).filter(Number.isFinite),i=t.map(c=>Number(c.x)+Number(c.width)).filter(Number.isFinite),o=t.map(c=>Number(c.y)+Number(c.height)).filter(Number.isFinite);if(!n.length||!r.length||!i.length||!o.length)return t[0];const a=Math.min(...n),s=Math.min(...r);return{x:a,y:s,width:Math.max(...i)-a,height:Math.max(...o)-s,coordinateSpace:t.find(c=>c.coordinateSpace)?.coordinateSpace}}function p(e,t){const n=Number(e?.[t]);return Number.isFinite(n)?n:Number.NaN}function pe(e,t){if(!t.length)return e;const n=[...e];for(const r of t){const i=x(r.anchorText||r.normalizedText||r.textExcerpt);n.some(a=>{if(a.senderRole!=="self")return!1;const s=x(a.anchorText||a.normalizedText||a.textExcerpt);return s&&i&&Y(s,i)>=.9})||n.push(r)}return n}function Yt(e,t){const n=e.bbox;if(!n)return!1;const r=Number(n.x),i=Number(n.y);return!Number.isFinite(r)||!Number.isFinite(i)?!1:r>t.width*.34&&r<t.width*.96&&i>t.height*.12&&i<t.height*.86}function Xt(e,t,n){if(!e||typeof e!="object")return null;const r=e,i=Number(r.x),o=Number(r.y),a=Number(r.width),s=Number(r.height);if(![i,o,a,s].every(Number.isFinite))return null;const c=typeof r.coordinateSpace=="string"?r.coordinateSpace:void 0,l=t.width&&n.bounds?.width?t.width/n.bounds.width:1,w=t.height&&n.bounds?.height?t.height/n.bounds.height:l,u={x:i+Math.min(a*.35,110*l),y:o+Math.min(s-8*w,Math.max(18*w,s/2))};if(c==="screen"||!n.bounds)return u;const d=Math.max(0,(t.width-n.bounds.width*l)/2),f=Math.max(0,(t.height-n.bounds.height*w)/2);return{x:n.bounds.x+(u.x-d)/l,y:n.bounds.y+(u.y-f)/w}}function B(e,t,n){if(!e||typeof e!="object")return null;const r=e,i=Number(r.x),o=Number(r.y),a=Number(r.width),s=Number(r.height);if(![i,o,a,s].every(Number.isFinite))return null;const c=typeof r.coordinateSpace=="string"?r.coordinateSpace:void 0,l={x:i+a/2,y:o+s/2};if(c==="screen"||!n.bounds)return l;const w=t.width&&n.bounds.width?t.width/n.bounds.width:1,u=t.height&&n.bounds.height?t.height/n.bounds.height:w,d=Math.max(0,(t.width-n.bounds.width*w)/2),f=Math.max(0,(t.height-n.bounds.height*u)/2);return{x:n.bounds.x+(l.x-d)/w,y:n.bounds.y+(l.y-f)/u}}function Jt(e,t,n){if(!e?.blocks?.length||!t)return null;const r=e.blocks.find(i=>{const o=String(i.text||"").trim(),a=i.bbox;if(!a||!o)return!1;const s=Number(a.x),c=Number(a.y);return!Number.isFinite(s)||!Number.isFinite(c)||!/跳转到最新消息|回到最新消息|jump\s+to\s+latest/i.test(o)?!1:s>t.width*.55&&c>t.height*.45&&c<t.height*.92});return B(r?.bbox,t,n)}function Ce(e,t){return y(t)?Ie(e,t):e===t||e.includes(t)||t.includes(e)}function j(e,t){if(y(t))return Ie(e,t);const n=ke(v(e)),r=ke(v(t));return!n||!r?!1:n===r?!0:n.replace(/\d+$/u,"")===r}function ke(e){return e.toLowerCase().replace(/[l1]/g,"i")}function O(e){return String(e||"").normalize("NFKC").replace(/[（(]\d+[）)]/g,"").replace(/\s+/g,"").replace(/[l1]/gi,"i").toLowerCase().trim()}function E(e){return String(e||"").normalize("NFKC").replace(/[（(]\d+[）)]/g,"").replace(/\s+/g,"").trim()}function y(e){const t=String(e||"").trim();return/^[A-Z0-9_-]{1,6}$/.test(t)&&/[A-Z]/.test(t)}function Ie(e,t){const n=String(e||"").normalize("NFKC").replace(/[（(]\d+[）)]/g,"").replace(/\s+/g,"").trim(),r=String(t||"").normalize("NFKC").replace(/[（(]\d+[）)]/g,"").replace(/\s+/g,"").trim();return!!(n&&r&&(n===r||n.replace(/\d+$/u,"")===r))}export{S as WeChatChannelUserActivityAbort,$ as captureAndRecognizeWeChatWindow,K as captureWeChatWindow,yt as ensureHelperPermissionPreflight,cn as ensureHelperPreflight,Ct as ensureWeChatWindowReady,ln as fallbackWeChatMessageInputPointForWindow,It as focusExistingWeChatWindow,ue as focusKnownWeChatWindow,dn as focusWeChatWindow,sn as observeWeChatChannelBindingViaHelper,D as openConversationBySearch,P as openConversationInVisibleList,be as recognizeWeChatScreenshot,ze as selectWeChatWindowForBinding};

package/dist/src/channels/wechat-channel/outbound-sender.d.ts

@@ -25,6 +25,7 @@ export declare class WeChatChannelOutboundSender {
         openConversation: (conversationName: string) => Promise<{
             opened: boolean;
             reason: string;
+            windowId?: string | null;
             inputPoint?: WeChatChannelScreenPoint | null;
         }>;
         traceId?: string;

package/dist/src/channels/wechat-channel/outbound-sender.js

@@ -1 +1 @@
-import g from"node:fs";import A from"node:path";import{waitForWeChatChannelPacing as l}from"./pacing.js";import{guardWeChatOutboundRevision as v,markWeChatOutboundFailed as C,markWeChatOutboundManualReview as k,markWeChatOutboundCommitStage as r,markWeChatOutboundSending as S,markWeChatOutboundSentUnconfirmed as x,markWeChatOutboundUserActiveTimeout as h,markWeChatOutboundWaitingUserIdle as w,shouldFailWeChatOutboundForUserActiveTimeout as d}from"./outbound-ledger.js";import{decideWeChatChannelActivityGate as _,nextWeChatChannelActivityRetryAt as y,normalizeWeChatChannelActivitySnapshot as R}from"./human-coordination.js";const W=600*1e3,b=520;async function j(e){const t={sentRecords:[],staleRecords:[],failedRecords:[],waitingRecords:[],manualReviewRecords:[]},s=e.now??new Date,i=e.maxUserActivityWaitMs??W,n=e.ledger.records.filter(a=>a.bindingId===e.bindingId&&a.sendStatus==="queued");for(const a of n){if(d({record:a,now:s,maxWaitMs:i})){h(a,s),t.failedRecords.push(a);continue}if(!v({record:a,currentLastInboundRevision:e.currentLastInboundRevision,now:s}).ok){t.staleRecords.push(a);continue}try{const o=await e.sender.canStart(a,s);if(o.ok===!1){w({record:a,reasonCode:o.reasonCode,nextAttemptAt:o.nextAttemptAt,now:s}),d({record:a,now:s,maxWaitMs:i})?(h(a,s),t.failedRecords.push(a)):t.waitingRecords.push(a);continue}S(a),await e.sender.send(a),x(a,s),t.sentRecords.push(a)}catch(o){if(o instanceof f){if(E(o)){k(a,"user_takeover_before_return","User activity was detected after paste and before Return; manual WeChat inspection is required",o.stage),t.manualReviewRecords.push(a);continue}w({record:a,reasonCode:o.reasonCode,nextAttemptAt:o.nextAttemptAt,now:s}),d({record:a,now:s,maxWaitMs:i})?(h(a,s),t.failedRecords.push(a)):t.waitingRecords.push(a);continue}C(a,U(o),o instanceof Error?o.message:String(o)),t.failedRecords.push(a)}}return t}class z{options;activeAutomationLeaseId=null;constructor(t){this.options=t}async canStart(t,s=new Date){const i=await this.activitySnapshot();O(i,this.options.platform);const n=_({snapshot:i,stage:"send_start",policy:this.options.activityGatePolicy});return n.ok===!1?{ok:!1,reasonCode:n.reasonCode,nextAttemptAt:y(s,n.waitMs)}:{ok:!0}}async send(t){await this.withAutomationLease(t,()=>this.sendWithLease(t))}async sendWithLease(t){await this.ensureStageIdle(t,"open_conversation"),r(t,"open_conversation");const s=await this.options.openConversation(t.conversationName);if(!s.opened)throw new Error(s.reason||"conversation_not_opened");r(t,"focus_input"),await M(this.options.helper,this.options.traceId,s.inputPoint??void 0),await this.ensureStageIdle(t,"focus_input"),await this.ensureStageIdle(t,"clipboard_snapshot"),r(t,"clipboard_snapshot");const i=await this.options.helper.request("clipboard.snapshot",{},this.options.traceId);c(i,"clipboard.snapshot");let n=!1;try{await this.sendTextIfPresent(t,()=>{n=!0}),await this.sendAttachmentsIfPresent(t,()=>{n=!0})}finally{const a=i.result&&typeof i.result=="object"?i.result:{},p=await this.options.helper.request("clipboard.restore",a,this.options.traceId);n||c(p,"clipboard.restore")}}async sendTextIfPresent(t,s){if(!t.text)return;await this.ensureStageIdle(t,"clipboard_set"),r(t,"clipboard_set"),await u(this.options.helper,"a",m(this.options.platform),this.options.traceId),await u(this.options.helper,"backspace",[],this.options.traceId);const i=await this.options.helper.request("clipboard.setText",{text:t.text},this.options.traceId);c(i,"clipboard.setText"),await this.ensureStageIdle(t,"paste"),r(t,"paste"),await u(this.options.helper,"v",m(this.options.platform),this.options.traceId),await this.waitAfterPaste(t),await this.ensureStageIdle(t,"before_return"),r(t,"before_return"),await u(this.options.helper,"return",[],this.options.traceId),s(),r(t,"after_return")}async sendAttachmentsIfPresent(t,s){for(const i of t.attachmentLocalRefs??[]){L(i),await this.ensureStageIdle(t,"clipboard_set"),r(t,"clipboard_set");const n=q(i),a=n==="image"&&I(this.options.platform)?await this.options.helper.request("clipboard.setImage",{filePath:i},this.options.traceId):await this.options.helper.request("clipboard.setFiles",{filePaths:[i]},this.options.traceId);c(a,n==="image"&&I(this.options.platform)?"clipboard.setImage":"clipboard.setFiles"),await this.ensureStageIdle(t,"paste"),r(t,"paste"),await u(this.options.helper,"v",m(this.options.platform),this.options.traceId),await this.waitAfterPaste(t),await this.ensureStageIdle(t,"before_return"),r(t,"before_return"),await u(this.options.helper,"return",[],this.options.traceId),s(),r(t,"after_return")}}async withAutomationLease(t,s){const i=await this.options.helper.request("automation.lease.acquire",{owner:"wechat-channel",purpose:`send:${t.bindingId}`,ttlMs:6e4},this.options.traceId);c(i,"automation.lease.acquire");const n=typeof i.result?.leaseId=="string"?i.result.leaseId:"";try{this.activeAutomationLeaseId=n||null,await s()}finally{this.activeAutomationLeaseId=null,n&&await this.releaseAutomationLease(n)}}async releaseAutomationLease(t){try{await this.options.helper.request("automation.lease.release",{leaseId:t},this.options.traceId)}catch{}}async waitAfterPaste(t){await l("send-post-paste",`${this.options.traceId||""}:${t.replyId}:post-paste`,this.options.postPasteSettleMs??void 0)}async ensureStageIdle(t,s){if(this.options.takeoverCheck===!1)return;if(this.activeAutomationLeaseId){const a=await this.automationLeaseDecision();if(a.ok===!1)throw new f({reasonCode:a.reasonCode,nextAttemptAt:a.nextAttemptAt,stage:s,replyId:t.replyId});return}const i=await this.activitySnapshot(),n=_({snapshot:i,stage:T(s),policy:this.options.activityGatePolicy});if(!n.ok)throw new f({reasonCode:n.reasonCode,nextAttemptAt:y(new Date,n.waitMs),stage:s,replyId:t.replyId})}async activitySnapshot(){const t=await this.options.helper.request("activity.snapshot",{},this.options.traceId);return c(t,"activity.snapshot"),R(t.result)}async automationLeaseDecision(){if(!this.activeAutomationLeaseId)return{ok:!0};const t=await this.options.helper.request("automation.lease.status",{},this.options.traceId);c(t,"automation.lease.status");const s=t.result??{};return s.active===!1||s.leaseId!==this.activeAutomationLeaseId||!s.interrupted?{ok:!0}:{ok:!1,reasonCode:P(s.interruptReason),nextAttemptAt:new Date(Date.now()+1e3)}}}class f extends Error{reasonCode;nextAttemptAt;stage;replyId;constructor(t){super(`user_takeover_aborted:${t.reasonCode}:${t.stage}`),this.name="WeChatChannelUserTakeoverAbort",this.reasonCode=t.reasonCode,this.nextAttemptAt=t.nextAttemptAt,this.stage=t.stage,this.replyId=t.replyId}}function T(e){return e==="open_conversation"?"open_conversation":e==="queued"?"send_start":"dangerous_action"}async function M(e,t,s){const i={waitMs:b,...s?{inputPoint:s}:{}};if((await e.request("wechat.focusMessageInput",i,t)).ok){await l("send-focus-stabilize",`${t||""}:focus-stabilize`);const p=await e.request("wechat.focusMessageInput",i,t);c(p,"wechat.focusMessageInput");return}await l("send-focus-retry",`${t||""}:focus-retry`);const a=await e.request("wechat.focusMessageInput",{...i,waitMs:Math.max(b,700)},t);c(a,"wechat.focusMessageInput")}async function u(e,t,s,i){const n=await e.request("keyboard.shortcut",{key:t,modifiers:s},i);c(n,"keyboard.shortcut")}function L(e){if(!g.statSync(e).isFile())throw new Error(`wechat_channel_attachment_not_file:${e}`)}function q(e){const t=A.extname(e).toLowerCase();return[".png",".jpg",".jpeg",".gif",".webp",".heic",".tiff",".bmp"].includes(t)?"image":[".mp4",".mov",".m4v",".avi",".mkv",".webm"].includes(t)?"video":"file"}function I(e){return(e??process.platform)==="win32"}function m(e){return(e??process.platform)==="win32"?["control"]:["command"]}function O(e,t){if((t??process.platform)!=="darwin")return;const s=e?.permissions;if(!s)return;const i=[s.accessibilityTrusted===!1?"accessibility":null,s.iohidPostGranted===!1?"input-monitoring":null].filter(Boolean);if(i.length)throw new Error(`permission_missing:mac_input:${i.join(",")}`)}function U(e){const t=e instanceof Error?e.message:String(e);return/conversation_not|conversation.*visible|conversation.*open/i.test(t)?"conversation_not_opened":/permission|accessibility|screen|automation/i.test(t)?"permission_missing":/clipboard/i.test(t)?"clipboard_failed":/attachment|not_file|ENOENT|no such file/i.test(t)?"attachment_unavailable":"send_failed"}function P(e){return e==="recent_mouse_activity"||e==="recent_mouse_click"||e==="recent_scroll_activity"||e==="recent_keyboard_activity"||e==="frontmost_app_changed"?e:"user_activity_unknown"}function E(e){return e.stage==="before_return"}function c(e,t){if(!e.ok)throw new Error(`${e.errorCode||"helper_command_failed"}: ${e.errorSummary||t}`)}export{z as WeChatChannelOutboundSender,f as WeChatChannelUserTakeoverAbort,j as sendQueuedWeChatOutboundRecords};
+import g from"node:fs";import A from"node:path";import{waitForWeChatChannelPacing as h}from"./pacing.js";import{guardWeChatOutboundRevision as v,markWeChatOutboundFailed as C,markWeChatOutboundManualReview as k,markWeChatOutboundCommitStage as r,markWeChatOutboundSending as S,markWeChatOutboundSentUnconfirmed as x,markWeChatOutboundUserActiveTimeout as d,markWeChatOutboundWaitingUserIdle as w,shouldFailWeChatOutboundForUserActiveTimeout as l}from"./outbound-ledger.js";import{decideWeChatChannelActivityGate as y,nextWeChatChannelActivityRetryAt as I,normalizeWeChatChannelActivitySnapshot as R}from"./human-coordination.js";const W=600*1e3,_=520;async function j(e){const t={sentRecords:[],staleRecords:[],failedRecords:[],waitingRecords:[],manualReviewRecords:[]},s=e.now??new Date,i=e.maxUserActivityWaitMs??W,n=e.ledger.records.filter(a=>a.bindingId===e.bindingId&&a.sendStatus==="queued");for(const a of n){if(l({record:a,now:s,maxWaitMs:i})){d(a,s),t.failedRecords.push(a);continue}if(!v({record:a,currentLastInboundRevision:e.currentLastInboundRevision,now:s}).ok){t.staleRecords.push(a);continue}try{const o=await e.sender.canStart(a,s);if(o.ok===!1){w({record:a,reasonCode:o.reasonCode,nextAttemptAt:o.nextAttemptAt,now:s}),l({record:a,now:s,maxWaitMs:i})?(d(a,s),t.failedRecords.push(a)):t.waitingRecords.push(a);continue}S(a),await e.sender.send(a),x(a,s),t.sentRecords.push(a)}catch(o){if(o instanceof f){if(D(o)){k(a,"user_takeover_before_return","User activity was detected after paste and before Return; manual WeChat inspection is required",o.stage),t.manualReviewRecords.push(a);continue}w({record:a,reasonCode:o.reasonCode,nextAttemptAt:o.nextAttemptAt,now:s}),l({record:a,now:s,maxWaitMs:i})?(d(a,s),t.failedRecords.push(a)):t.waitingRecords.push(a);continue}C(a,U(o),o instanceof Error?o.message:String(o)),t.failedRecords.push(a)}}return t}class H{options;activeAutomationLeaseId=null;constructor(t){this.options=t}async canStart(t,s=new Date){const i=await this.activitySnapshot();await P(this.options.helper,i,this.options.platform,this.options.traceId);const n=y({snapshot:i,stage:"send_start",policy:this.options.activityGatePolicy});return n.ok===!1?{ok:!1,reasonCode:n.reasonCode,nextAttemptAt:I(s,n.waitMs)}:{ok:!0}}async send(t){await this.withAutomationLease(t,()=>this.sendWithLease(t))}async sendWithLease(t){await this.ensureStageIdle(t,"open_conversation"),r(t,"open_conversation");const s=await this.options.openConversation(t.conversationName);if(!s.opened)throw new Error(s.reason||"conversation_not_opened");r(t,"focus_input"),await T(this.options.helper,this.options.traceId,{windowId:s.windowId??void 0,inputPoint:s.inputPoint??void 0}),await this.ensureStageIdle(t,"focus_input"),await this.ensureStageIdle(t,"clipboard_snapshot"),r(t,"clipboard_snapshot");const i=await this.options.helper.request("clipboard.snapshot",{},this.options.traceId);c(i,"clipboard.snapshot");let n=!1;try{await this.sendTextIfPresent(t,()=>{n=!0}),await this.sendAttachmentsIfPresent(t,()=>{n=!0})}finally{const a=i.result&&typeof i.result=="object"?i.result:{},p=await this.options.helper.request("clipboard.restore",a,this.options.traceId);n||c(p,"clipboard.restore")}}async sendTextIfPresent(t,s){if(!t.text)return;await this.ensureStageIdle(t,"clipboard_set"),r(t,"clipboard_set"),await u(this.options.helper,"a",m(this.options.platform),this.options.traceId),await u(this.options.helper,"backspace",[],this.options.traceId);const i=await this.options.helper.request("clipboard.setText",{text:t.text},this.options.traceId);c(i,"clipboard.setText"),await this.ensureStageIdle(t,"paste"),r(t,"paste"),await u(this.options.helper,"v",m(this.options.platform),this.options.traceId),await this.waitAfterPaste(t),await this.ensureStageIdle(t,"before_return"),r(t,"before_return"),await u(this.options.helper,"return",[],this.options.traceId),s(),r(t,"after_return")}async sendAttachmentsIfPresent(t,s){for(const i of t.attachmentLocalRefs??[]){q(i),await this.ensureStageIdle(t,"clipboard_set"),r(t,"clipboard_set");const n=L(i),a=n==="image"&&b(this.options.platform)?await this.options.helper.request("clipboard.setImage",{filePath:i},this.options.traceId):await this.options.helper.request("clipboard.setFiles",{filePaths:[i]},this.options.traceId);c(a,n==="image"&&b(this.options.platform)?"clipboard.setImage":"clipboard.setFiles"),await this.ensureStageIdle(t,"paste"),r(t,"paste"),await u(this.options.helper,"v",m(this.options.platform),this.options.traceId),await this.waitAfterPaste(t),await this.ensureStageIdle(t,"before_return"),r(t,"before_return"),await u(this.options.helper,"return",[],this.options.traceId),s(),r(t,"after_return")}}async withAutomationLease(t,s){const i=await this.options.helper.request("automation.lease.acquire",{owner:"wechat-channel",purpose:`send:${t.bindingId}`,ttlMs:6e4},this.options.traceId);c(i,"automation.lease.acquire");const n=typeof i.result?.leaseId=="string"?i.result.leaseId:"";try{this.activeAutomationLeaseId=n||null,await s()}finally{this.activeAutomationLeaseId=null,n&&await this.releaseAutomationLease(n)}}async releaseAutomationLease(t){try{await this.options.helper.request("automation.lease.release",{leaseId:t},this.options.traceId)}catch{}}async waitAfterPaste(t){await h("send-post-paste",`${this.options.traceId||""}:${t.replyId}:post-paste`,this.options.postPasteSettleMs??void 0)}async ensureStageIdle(t,s){if(this.options.takeoverCheck===!1)return;if(this.activeAutomationLeaseId){const a=await this.automationLeaseDecision();if(a.ok===!1)throw new f({reasonCode:a.reasonCode,nextAttemptAt:a.nextAttemptAt,stage:s,replyId:t.replyId});return}const i=await this.activitySnapshot(),n=y({snapshot:i,stage:M(s),policy:this.options.activityGatePolicy});if(!n.ok)throw new f({reasonCode:n.reasonCode,nextAttemptAt:I(new Date,n.waitMs),stage:s,replyId:t.replyId})}async activitySnapshot(){const t=await this.options.helper.request("activity.snapshot",{},this.options.traceId);return c(t,"activity.snapshot"),R(t.result)}async automationLeaseDecision(){if(!this.activeAutomationLeaseId)return{ok:!0};const t=await this.options.helper.request("automation.lease.status",{},this.options.traceId);c(t,"automation.lease.status");const s=t.result??{};return s.active===!1||s.leaseId!==this.activeAutomationLeaseId||!s.interrupted?{ok:!0}:{ok:!1,reasonCode:E(s.interruptReason),nextAttemptAt:new Date(Date.now()+1e3)}}}class f extends Error{reasonCode;nextAttemptAt;stage;replyId;constructor(t){super(`user_takeover_aborted:${t.reasonCode}:${t.stage}`),this.name="WeChatChannelUserTakeoverAbort",this.reasonCode=t.reasonCode,this.nextAttemptAt=t.nextAttemptAt,this.stage=t.stage,this.replyId=t.replyId}}function M(e){return e==="open_conversation"?"open_conversation":e==="queued"?"send_start":"dangerous_action"}async function T(e,t,s){const i={waitMs:_,...s?.windowId?{windowId:s.windowId}:{},...s?.inputPoint?{inputPoint:s.inputPoint}:{}};if((await e.request("wechat.focusMessageInput",i,t)).ok){await h("send-focus-stabilize",`${t||""}:focus-stabilize`);const p=await e.request("wechat.focusMessageInput",i,t);c(p,"wechat.focusMessageInput");return}await h("send-focus-retry",`${t||""}:focus-retry`);const a=await e.request("wechat.focusMessageInput",{...i,waitMs:Math.max(_,700)},t);c(a,"wechat.focusMessageInput")}async function u(e,t,s,i){const n=await e.request("keyboard.shortcut",{key:t,modifiers:s},i);c(n,"keyboard.shortcut")}function q(e){if(!g.statSync(e).isFile())throw new Error(`wechat_channel_attachment_not_file:${e}`)}function L(e){const t=A.extname(e).toLowerCase();return[".png",".jpg",".jpeg",".gif",".webp",".heic",".tiff",".bmp"].includes(t)?"image":[".mp4",".mov",".m4v",".avi",".mkv",".webm"].includes(t)?"video":"file"}function b(e){return(e??process.platform)==="win32"}function m(e){return(e??process.platform)==="win32"?["control"]:["command"]}async function P(e,t,s,i){if((s??process.platform)!=="darwin")return;const n=t?.permissions;if(!n)return;const a=n.accessibilityTrusted===!1?"accessibility":n.iohidListenGranted===!1?"input-monitoring":null;if(a)throw await O(e,a==="accessibility"?"permissions.requestAccessibility":"permissions.requestInputMonitoring",i),new Error(`permission_missing:mac_input:${a}`)}async function O(e,t,s){try{await e.request(t,{},s)}catch{}}function U(e){const t=e instanceof Error?e.message:String(e);return/conversation_not|conversation.*visible|conversation.*open/i.test(t)?"conversation_not_opened":/permission|accessibility|screen|automation/i.test(t)?"permission_missing":/clipboard/i.test(t)?"clipboard_failed":/attachment|not_file|ENOENT|no such file/i.test(t)?"attachment_unavailable":"send_failed"}function E(e){return e==="recent_mouse_activity"||e==="recent_mouse_click"||e==="recent_scroll_activity"||e==="recent_keyboard_activity"||e==="frontmost_app_changed"?e:"user_activity_unknown"}function D(e){return e.stage==="before_return"}function c(e,t){if(!e.ok)throw new Error(`${e.errorCode||"helper_command_failed"}: ${e.errorSummary||t}`)}export{H as WeChatChannelOutboundSender,f as WeChatChannelUserTakeoverAbort,j as sendQueuedWeChatOutboundRecords};

package/dist/src/channels/wechat-channel/preflight.d.ts

@@ -28,9 +28,6 @@ export type WeChatChannelPreflightInput = {
         wechatRunning?: boolean;
         wechatWindowAvailable?: boolean;
         wechatMainWindowResponsive?: boolean;
-        duplicateInstanceBlocked?: boolean;
-        duplicateMainWindowCount?: number;
-        unsafeAuxiliaryWindowCount?: number;
         windowsVisibleDesktopAvailable?: boolean;
         rdpVisibleDesktopAvailable?: boolean;
         desktopSessionVisible?: boolean;

package/dist/src/channels/wechat-channel/preflight.js

@@ -1 +1 @@
-import{requiredWeChatChannelHelperCapabilitiesForProfile as o,requiredWindowsWeChatChannelHelperCapabilitiesForProfile as t,validateWeChatChannelHelperReady as d}from"./helper-protocol.js";function p(e){const a=[],r=e.platform==="darwin"||e.platform==="win32";if(a.push(i(r,"platform_unsupported","\u5FAE\u4FE1 Channel \u5F53\u524D\u652F\u6301 macOS \u548C Windows \u684C\u9762\u5FAE\u4FE1\u3002")),a.push(i(e.accountTier==="enterprise","enterprise_required","\u5F53\u524D\u9636\u6BB5\u5FAE\u4FE1 Channel \u4EC5\u4F01\u4E1A\u7248\u8D26\u53F7\u53EF\u7528\u3002")),a.push(i(!!e.privacyConsentAccepted,"privacy_consent_required","\u542F\u7528\u524D\u9700\u8981\u786E\u8BA4\u5FAE\u4FE1 Channel \u6570\u636E\u4E0E\u9690\u79C1\u6388\u6743\u3002")),a.push(i(!!e.serverDecisionAvailable,"server_decision_unavailable","\u670D\u52A1\u7AEF\u5224\u65AD\u80FD\u529B\u4E0D\u53EF\u7528\uFF0C\u6682\u4E0D\u80FD\u542F\u7528\u3002")),e.currentMachineId&&e.runtime.machineId&&a.push(i(e.currentMachineId===e.runtime.machineId,"same_machine_required","\u7B2C\u4E00\u7248\u53EA\u652F\u6301\u540C\u673A\u5FAE\u4FE1\u4E0E\u540C\u673A\u795E\u5FF5\u8FD0\u884C\u65F6\u7ED1\u5B9A\u3002")),e.localAgentMachineId&&e.runtime.machineId&&a.push(i(e.localAgentMachineId===e.runtime.machineId,"same_machine_required","\u7ED1\u5B9A\u7684 Agent \u5FC5\u987B\u4E0E\u5FAE\u4FE1\u8FD0\u884C\u65F6\u5728\u540C\u4E00\u53F0\u673A\u5668\u3002")),a.push(i(e.localAgentAvailable!==!1,"local_agent_unavailable","\u672C\u673A Agent \u4E0D\u53EF\u7528\uFF0C\u65E0\u6CD5\u5B89\u5168\u63A5\u7BA1\u5FAE\u4FE1\u56DE\u590D\u3002")),!e.helperReady)a.push(i(!1,"helper_not_ready","\u5E73\u53F0 helper \u672A\u5C31\u7EEA\u3002"));else{const l=d(e.helperReady,e.expectedHelperVersion,e.requiredHelperCapabilities??c(e.platform,e.binding));l.ok?a.push(i(!0,"ok",e.platform==="win32"?"Windows helper \u7248\u672C\u4E0E\u80FD\u529B\u68C0\u67E5\u901A\u8FC7\u3002":"macOS helper \u7248\u672C\u4E0E\u80FD\u529B\u68C0\u67E5\u901A\u8FC7\u3002")):a.push(i(!1,l.errorCode,l.errorSummary))}const n=e.permissions;n&&(a.push(i(n.screenRecording!==!1,"permission_screen_recording_missing","\u7F3A\u5C11\u5C4F\u5E55\u5F55\u5236\u6743\u9650\u3002")),a.push(i(n.automation!==!1,"permission_automation_missing","\u7F3A\u5C11\u81EA\u52A8\u5316\u63A7\u5236\u6743\u9650\u3002")),a.push(i(n.wechatRunning!==!1,"wechat_not_running","\u5FAE\u4FE1\u672A\u8FD0\u884C\u3002")),a.push(i(n.wechatWindowAvailable!==!1,"wechat_window_unavailable","\u5FAE\u4FE1\u7A97\u53E3\u4E0D\u53EF\u7528\u3002")),a.push(i(n.wechatMainWindowResponsive!==!1,"wechat_window_unresponsive","\u5FAE\u4FE1\u7A97\u53E3\u65E0\u54CD\u5E94\uFF0C\u9700\u6062\u590D\u540E\u518D\u7EE7\u7EED\u3002")),a.push(i(n.windowsVisibleDesktopAvailable!==!1&&n.rdpVisibleDesktopAvailable!==!1&&n.desktopSessionVisible!==!1&&n.screenLocked!==!0&&n.rdpDisconnected!==!0,"windows_visible_desktop_unavailable","Windows \u53EF\u89C1\u684C\u9762\u4E0D\u53EF\u7528\uFF0C\u8BF7\u89E3\u9501\u6216\u4FDD\u6301 RDP \u53EF\u89C1\u684C\u9762\u4F1A\u8BDD\u540E\u518D\u542F\u7528\u3002")),a.push(i(n.dpiMappingAvailable!==!1&&n.displayTopologySupported!==!1,"dpi_mapping_failed","Windows DPI / \u591A\u5C4F\u5750\u6807\u6620\u5C04\u4E0D\u53EF\u7528\uFF0C\u8BF7\u628A\u5FAE\u4FE1\u5B8C\u6574\u653E\u5728\u4E00\u4E2A\u53EF\u89C1\u663E\u793A\u5668\u4E0A\u540E\u518D\u542F\u7528\u3002")),a.push(i(n.duplicateInstanceBlocked!==!0&&Number(n.duplicateMainWindowCount??0)===0&&Number(n.unsafeAuxiliaryWindowCount??0)===0,"wechat_single_main_window_required","\u8BF7\u53EA\u4FDD\u7559\u4E00\u4E2A\u5DF2\u767B\u5F55\u7684\u5FAE\u4FE1\u4E3B\u7A97\u53E3\uFF0C\u5173\u95ED\u91CD\u590D\u4E3B\u7A97\u53E3\u3001\u89C6\u9891\u9884\u89C8\u6216\u767B\u5F55\u63D0\u793A\u540E\u518D\u542F\u7528\u3002")));const s=a.filter(l=>!l.ok&&l.severity==="blocking");return{ok:s.length===0,canEnable:s.length===0,status:s.length===0?"ready":"blocked",checks:a}}function i(e,a,r){return{ok:e,code:e?"ok":a,severity:"blocking",message:r}}function c(e,a){const r=e==="win32"?t:o;return!a||a.allowReply!==!1?r("send"):a.downloadMedia!==!1?r("download"):r("observe")}export{p as evaluateWeChatChannelPreflight};
+import{requiredWeChatChannelHelperCapabilitiesForProfile as o,requiredWindowsWeChatChannelHelperCapabilitiesForProfile as t,validateWeChatChannelHelperReady as d}from"./helper-protocol.js";function p(e){const a=[],n=e.platform==="darwin"||e.platform==="win32";if(a.push(i(n,"platform_unsupported","\u5FAE\u4FE1 Channel \u5F53\u524D\u652F\u6301 macOS \u548C Windows \u684C\u9762\u5FAE\u4FE1\u3002")),a.push(i(e.accountTier==="enterprise","enterprise_required","\u5F53\u524D\u9636\u6BB5\u5FAE\u4FE1 Channel \u4EC5\u4F01\u4E1A\u7248\u8D26\u53F7\u53EF\u7528\u3002")),a.push(i(!!e.privacyConsentAccepted,"privacy_consent_required","\u542F\u7528\u524D\u9700\u8981\u786E\u8BA4\u5FAE\u4FE1 Channel \u6570\u636E\u4E0E\u9690\u79C1\u6388\u6743\u3002")),a.push(i(!!e.serverDecisionAvailable,"server_decision_unavailable","\u670D\u52A1\u7AEF\u5224\u65AD\u80FD\u529B\u4E0D\u53EF\u7528\uFF0C\u6682\u4E0D\u80FD\u542F\u7528\u3002")),e.currentMachineId&&e.runtime.machineId&&a.push(i(e.currentMachineId===e.runtime.machineId,"same_machine_required","\u7B2C\u4E00\u7248\u53EA\u652F\u6301\u540C\u673A\u5FAE\u4FE1\u4E0E\u540C\u673A\u795E\u5FF5\u8FD0\u884C\u65F6\u7ED1\u5B9A\u3002")),e.localAgentMachineId&&e.runtime.machineId&&a.push(i(e.localAgentMachineId===e.runtime.machineId,"same_machine_required","\u7ED1\u5B9A\u7684 Agent \u5FC5\u987B\u4E0E\u5FAE\u4FE1\u8FD0\u884C\u65F6\u5728\u540C\u4E00\u53F0\u673A\u5668\u3002")),a.push(i(e.localAgentAvailable!==!1,"local_agent_unavailable","\u672C\u673A Agent \u4E0D\u53EF\u7528\uFF0C\u65E0\u6CD5\u5B89\u5168\u63A5\u7BA1\u5FAE\u4FE1\u56DE\u590D\u3002")),!e.helperReady)a.push(i(!1,"helper_not_ready","\u5E73\u53F0 helper \u672A\u5C31\u7EEA\u3002"));else{const l=d(e.helperReady,e.expectedHelperVersion,e.requiredHelperCapabilities??c(e.platform,e.binding));l.ok?a.push(i(!0,"ok",e.platform==="win32"?"Windows helper \u7248\u672C\u4E0E\u80FD\u529B\u68C0\u67E5\u901A\u8FC7\u3002":"macOS helper \u7248\u672C\u4E0E\u80FD\u529B\u68C0\u67E5\u901A\u8FC7\u3002")):a.push(i(!1,l.errorCode,l.errorSummary))}const r=e.permissions;r&&(a.push(i(r.screenRecording!==!1,"permission_screen_recording_missing","\u7F3A\u5C11\u5C4F\u5E55\u5F55\u5236\u6743\u9650\u3002")),a.push(i(r.automation!==!1,"permission_automation_missing","\u7F3A\u5C11\u81EA\u52A8\u5316\u63A7\u5236\u6743\u9650\u3002")),a.push(i(r.wechatRunning!==!1,"wechat_not_running","\u5FAE\u4FE1\u672A\u8FD0\u884C\u3002")),a.push(i(r.wechatWindowAvailable!==!1,"wechat_window_unavailable","\u5FAE\u4FE1\u7A97\u53E3\u4E0D\u53EF\u7528\u3002")),a.push(i(r.wechatMainWindowResponsive!==!1,"wechat_window_unresponsive","\u5FAE\u4FE1\u7A97\u53E3\u65E0\u54CD\u5E94\uFF0C\u9700\u6062\u590D\u540E\u518D\u7EE7\u7EED\u3002")),a.push(i(r.windowsVisibleDesktopAvailable!==!1&&r.rdpVisibleDesktopAvailable!==!1&&r.desktopSessionVisible!==!1&&r.screenLocked!==!0&&r.rdpDisconnected!==!0,"windows_visible_desktop_unavailable","Windows \u53EF\u89C1\u684C\u9762\u4E0D\u53EF\u7528\uFF0C\u8BF7\u89E3\u9501\u6216\u4FDD\u6301 RDP \u53EF\u89C1\u684C\u9762\u4F1A\u8BDD\u540E\u518D\u542F\u7528\u3002")),a.push(i(r.dpiMappingAvailable!==!1&&r.displayTopologySupported!==!1,"dpi_mapping_failed","Windows DPI / \u591A\u5C4F\u5750\u6807\u6620\u5C04\u4E0D\u53EF\u7528\uFF0C\u8BF7\u628A\u5FAE\u4FE1\u5B8C\u6574\u653E\u5728\u4E00\u4E2A\u53EF\u89C1\u663E\u793A\u5668\u4E0A\u540E\u518D\u542F\u7528\u3002")));const s=a.filter(l=>!l.ok&&l.severity==="blocking");return{ok:s.length===0,canEnable:s.length===0,status:s.length===0?"ready":"blocked",checks:a}}function i(e,a,n){return{ok:e,code:e?"ok":a,severity:"blocking",message:n}}function c(e,a){const n=e==="win32"?t:o;return!a||a.allowReply!==!1?n("send"):a.downloadMedia!==!1?n("download"):n("observe")}export{p as evaluateWeChatChannelPreflight};

package/dist/src/channels/wechat-channel/runner.d.ts

@@ -1,9 +1,9 @@
 import type { WeChatChannelRuntime, WeChatChannelBindingConfig } from './runtime.js';
 import { type WeChatChannelApiClient, type WeChatChannelObservedMessage } from './client.js';
-import { type WeChatChannelHelperClientOptions } from './helper-client.js';
+import { type WeChatChannelHelperClientOptions, type WeChatChannelHelperRequestTraceEvent } from './helper-client.js';
 import type { WeChatChannelHelperTransport } from './observer.js';
 import { type WeChatChannelObserveApi } from './observer.js';
-import { WeChatChannelScheduler, type WeChatChannelSchedulerTickResult } from './scheduler.js';
+import { WeChatChannelScheduler, type WeChatChannelSchedulerTickOptions, type WeChatChannelSchedulerTickResult } from './scheduler.js';
 export type WeChatChannelProductRunnerOptions = {
     runtime: WeChatChannelRuntime;
     workDir: string;
@@ -13,6 +13,7 @@ export type WeChatChannelProductRunnerOptions = {
         stop?: () => Promise<void>;
     };
     helperClientOptions?: WeChatChannelHelperClientOptions;
+    helperRequestLogger?: (event: WeChatChannelHelperRequestTraceEvent) => void;
     ledgerPath?: string;
     outboundLedgerPath?: string;
     onInboundMessages?: (binding: WeChatChannelBindingConfig, messages: WeChatChannelObservedMessage[]) => Promise<void> | void;
@@ -28,7 +29,7 @@ export declare class WeChatChannelProductRunner {
     private helperStarted;
     constructor(options: WeChatChannelProductRunnerOptions);
     start(): Promise<void>;
-    tick(): Promise<WeChatChannelSchedulerTickResult | void>;
+    tick(options?: WeChatChannelSchedulerTickOptions): Promise<WeChatChannelSchedulerTickResult | void>;
     stop(): Promise<void>;
     private ensureHelperStarted;
     private shouldSkipObserveForUnchangedFingerprint;

package/dist/src/channels/wechat-channel/runner.js

@@ -1 +1 @@
-import l from"node:path";import d from"node:fs";import{createWeChatChannelApiClient as v}from"./client.js";import{WeChatChannelHelperClient as c}from"./helper-client.js";import{resolveWeChatChannelHelperAsset as y,WECHAT_CHANNEL_HELPER_VERSION as k}from"./helper-assets.js";import{requiredWindowsWeChatChannelHelperCapabilitiesForProfile as u}from"./helper-protocol.js";import{captureWeChatWindow as W,ensureWeChatWindowReady as p,fallbackWeChatMessageInputPointForWindow as S,focusKnownWeChatWindow as f,observeWeChatChannelBindingViaHelper as I,openConversationBySearch as P,recognizeWeChatScreenshot as A}from"./observer.js";import{WeChatChannelScheduler as O}from"./scheduler.js";import{loadWeChatChannelLedger as F}from"./ledger.js";import{buildWeChatConversationFingerprint as x,matchWeChatConversationFingerprints as _}from"./fingerprint.js";import{WeChatChannelOutboundSender as D}from"./outbound-sender.js";import{decideWeChatChannelActivityGate as H,nextWeChatChannelActivityRetryAt as M,normalizeWeChatChannelActivitySnapshot as T}from"./human-coordination.js";class R{options;scheduler;helper;helperStarted=!1;constructor(e){this.options=e;const n=e.api??v();this.helper=e.helper??L(e),this.scheduler=new O({runtime:e.runtime,workDir:e.workDir,api:n,ledgerPath:e.ledgerPath,outboundLedgerPath:e.outboundLedgerPath,onInboundMessages:e.onInboundMessages,activityGate:{canObserve:async(t,a)=>{if(e.runtime.foregroundPolicy==="work")return{ok:!0};const o=await this.helper.request("activity.snapshot",{});if(!o.ok)return{ok:!1,reasonCode:"user_activity_unknown",nextAttemptAt:new Date(a.getTime()+5e3)};const i=H({snapshot:T(o.result),stage:"observe"});return i.ok?{ok:!0}:{ok:!1,reasonCode:i.reasonCode,nextAttemptAt:M(a,i.waitMs)}}},shouldSkipObserve:(t,a)=>this.shouldSkipObserveForUnchangedFingerprint(t,a.foregroundMode),outboundSender:new D({helper:this.helper,platform:e.runtime.policy.platform,openConversation:async t=>{const a=await p(this.helper),o=await f(this.helper,a);return{...await P({helper:this.helper,window:o,settleToBottom:!1,binding:{bindingId:`outbound:${t}`,sessionId:"outbound",conversationDisplayName:t,enabled:!0,allowReply:!0,downloadMedia:!0}}),inputPoint:S(o)}}}),observeBinding:(t,a)=>I({runtime:e.runtime,binding:t,helper:this.helper,api:n,workDir:e.workDir,localLedgerTailAnchors:E(e.ledgerPath??U(e.workDir,e.runtime.runtimeId),e.runtime.runtimeId,t.bindingId),localOutboundEchoAnchors:a?.localOutboundEchoAnchors,foregroundMode:a?.foregroundMode,onObservationEvidence:({ocr:o})=>{N({statePath:g(e.workDir,e.runtime.runtimeId),runtimeId:e.runtime.runtimeId,binding:t,ocr:o})}})})}async start(){await this.ensureHelperStarted(),await this.scheduler.start()}async tick(){return await this.ensureHelperStarted(),this.scheduler.tick()}async stop(){this.scheduler.stop(),this.helperStarted&&this.helper.stop&&await this.helper.stop(),this.helperStarted=!1}async ensureHelperStarted(){this.helperStarted||(this.helper.start&&await this.helper.start(),this.helperStarted=!0)}async shouldSkipObserveForUnchangedFingerprint(e,n="required"){if(this.options.runtime.policy.platform!=="darwin"&&this.options.runtime.policy.platform!=="win32")return{skip:!1};const t=g(this.options.workDir,this.options.runtime.runtimeId),a=h(t,this.options.runtime.runtimeId).bindings[e.bindingId];if(!a?.fingerprint)return{skip:!1};try{const o=await p(this.helper,void 0,{foreground:n}),i=n==="background"?o:await f(this.helper,o),C=await W(this.helper,i.windowId,void 0,i.bounds),b=await A(this.helper,C),s=w({binding:e,ocr:b,prior:a});return!s?.fingerprint||s.fingerprint!==a.fingerprint?{skip:!1}:{skip:!0,reasonCode:"conversation_fingerprint_unchanged",fingerprint:s.fingerprint}}catch{return{skip:!1}}}}function re(r){return new R(r)}function E(r,e,n,t=3){return(F(r,e).bindings[n]?.recent??[]).slice(-t).map(i=>({stableMessageKey:i.stableMessageKey,senderRole:i.senderRole,kind:i.kind,anchorText:i.anchorText??i.normalizedText??i.textExcerpt??null,anchorMetadata:i.anchorMetadata??null}))}function L(r){if(r.helperClientOptions)return new c({...r.helperClientOptions,requiredCapabilities:r.helperClientOptions.requiredCapabilities??m(r.runtime),guardUnsafeWindowsCommands:r.helperClientOptions.guardUnsafeWindowsCommands??r.runtime.policy.platform==="win32",skipUserActivityGuard:r.helperClientOptions.skipUserActivityGuard??r.runtime.foregroundPolicy==="work",cleanupWindowsOverlays:r.helperClientOptions.cleanupWindowsOverlays??r.runtime.policy.platform==="win32"});const e=y();if(!e.ok)throw new Error(`${e.reasonCode}: ${e.message}`);return new c({helperPath:e.helperPath,expectedHelperVersion:e.version||k,requiredCapabilities:m(r.runtime),guardUnsafeWindowsCommands:r.runtime.policy.platform==="win32",skipUserActivityGuard:r.runtime.foregroundPolicy==="work",cleanupWindowsOverlays:r.runtime.policy.platform==="win32"})}function m(r){if(r.policy.platform==="win32")return r.bindings.some(e=>e.enabled!==!1&&e.allowReply!==!1)?u("send"):r.bindings.some(e=>e.enabled!==!1&&e.downloadMedia!==!1)?u("download"):u("observe")}function U(r,e){return l.join(r,"wechat-channel",`${e}.ledger.json`)}function g(r,e){return l.join(r,"wechat-channel",`${$(e)}.conversation-fingerprints.json`)}function h(r,e){try{const n=JSON.parse(d.readFileSync(r,"utf8"));if(n?.version===1&&n.runtimeId===e&&n.bindings&&typeof n.bindings=="object")return n}catch{}return{version:1,runtimeId:e,bindings:{}}}function q(r,e){d.mkdirSync(l.dirname(r),{recursive:!0}),d.writeFileSync(r,JSON.stringify(e,null,2))}function N(r){const e=w({binding:r.binding,ocr:r.ocr,prior:h(r.statePath,r.runtimeId).bindings[r.binding.bindingId]});if(!e?.fingerprint)return;const n=h(r.statePath,r.runtimeId);n.bindings[r.binding.bindingId]={bindingId:r.binding.bindingId,fingerprint:e.fingerprint,title:e.item.title??null,preview:e.item.preview??null,timeText:e.item.timeText??null,unreadText:e.item.unreadText??null,observedAt:new Date().toISOString()},q(r.statePath,n)}function w(r){const e=r.ocr.visibleConversationFingerprints??[],n=_({visibleItems:e,targets:[{bindingId:r.binding.bindingId,conversationDisplayName:r.binding.conversationDisplayName,lastConversationFingerprint:r.prior?.fingerprint,lastPreview:r.prior?.preview??void 0}]})[0];if(!n)return null;const t=n.item.fingerprint||x(n.item);return t?{item:n.item,fingerprint:t}:null}function $(r){return String(r||"").trim().replace(/[^a-zA-Z0-9._-]+/g,"_").replace(/^_+|_+$/g,"")||"wechat-channel-runtime"}export{R as WeChatChannelProductRunner,E as buildLocalLedgerTailAnchors,re as createWeChatChannelProductRunner};
+import d from"node:path";import u from"node:fs";import{createWeChatChannelApiClient as p}from"./client.js";import{WeChatChannelHelperClient as m}from"./helper-client.js";import{resolveWeChatChannelHelperAsset as k,WECHAT_CHANNEL_HELPER_VERSION as W}from"./helper-assets.js";import{requiredWindowsWeChatChannelHelperCapabilitiesForProfile as h}from"./helper-protocol.js";import{captureWeChatWindow as S,fallbackWeChatMessageInputPointForWindow as I,focusKnownWeChatWindow as f,observeWeChatChannelBindingViaHelper as P,openConversationBySearch as O,recognizeWeChatScreenshot as A,selectWeChatWindowForBinding as g}from"./observer.js";import{WeChatChannelScheduler as F}from"./scheduler.js";import{loadWeChatChannelLedger as D}from"./ledger.js";import{buildWeChatConversationFingerprint as M,matchWeChatConversationFingerprints as T}from"./fingerprint.js";import{WeChatChannelOutboundSender as x}from"./outbound-sender.js";import{decideWeChatChannelActivityGate as L,nextWeChatChannelActivityRetryAt as _,normalizeWeChatChannelActivitySnapshot as q}from"./human-coordination.js";class H{options;scheduler;helper;helperStarted=!1;constructor(e){this.options=e;const n=e.api??p();this.helper=e.helper??E(e),this.scheduler=new F({runtime:e.runtime,workDir:e.workDir,api:n,ledgerPath:e.ledgerPath,outboundLedgerPath:e.outboundLedgerPath,onInboundMessages:e.onInboundMessages,activityGate:{canObserve:async(i,a)=>{if(e.runtime.foregroundPolicy==="work")return{ok:!0};const o=await this.helper.request("activity.snapshot",{});if(!o.ok)return{ok:!1,reasonCode:"user_activity_unknown",nextAttemptAt:new Date(a.getTime()+5e3)};const t=L({snapshot:q(o.result),stage:"observe"});return t.ok?{ok:!0}:{ok:!1,reasonCode:t.reasonCode,nextAttemptAt:_(a,t.waitMs)}}},shouldSkipObserve:(i,a)=>this.shouldSkipObserveForUnchangedFingerprint(i,a.foregroundMode),outboundSender:new x({helper:this.helper,platform:e.runtime.policy.platform,activityGatePolicy:e.runtime.foregroundPolicy==="work"?{mouseMovedThresholdMs:0,mouseClickThresholdMs:0,scrollWheelThresholdMs:0,keyDownThresholdMs:0}:void 0,takeoverCheck:e.runtime.foregroundPolicy!=="work",openConversation:async i=>{const a={bindingId:`outbound:${i}`,sessionId:"outbound",conversationDisplayName:i,enabled:!0,allowReply:!0,downloadMedia:!0},o=await g({runtime:e.runtime,binding:a,helper:this.helper,api:n,workDir:e.workDir}),t=await f(this.helper,o);return{...await O({helper:this.helper,window:t,settleToBottom:!1,binding:a}),windowId:t.windowId,inputPoint:I(t)}}}),observeBinding:(i,a)=>P({runtime:e.runtime,binding:i,helper:this.helper,api:n,workDir:e.workDir,localLedgerTailAnchors:R(e.ledgerPath??U(e.workDir,e.runtime.runtimeId),e.runtime.runtimeId,i.bindingId),localOutboundEchoAnchors:a?.localOutboundEchoAnchors,foregroundMode:a?.foregroundMode,onObservationEvidence:({ocr:o})=>{N({statePath:C(e.workDir,e.runtime.runtimeId),runtimeId:e.runtime.runtimeId,binding:i,ocr:o})}})})}async start(){await this.ensureHelperStarted(),await this.scheduler.start()}async tick(e){return await this.ensureHelperStarted(),this.scheduler.tick(e)}async stop(){this.scheduler.stop(),this.helperStarted&&this.helper.stop&&await this.helper.stop(),this.helperStarted=!1}async ensureHelperStarted(){this.helperStarted||(this.helper.start&&await this.helper.start(),this.helperStarted=!0)}async shouldSkipObserveForUnchangedFingerprint(e,n="required"){if(this.options.runtime.policy.platform!=="darwin"&&this.options.runtime.policy.platform!=="win32")return{skip:!1};const i=C(this.options.workDir,this.options.runtime.runtimeId),a=c(i,this.options.runtime.runtimeId).bindings[e.bindingId];if(!a?.fingerprint)return{skip:!1};try{const o=this.options.api??p(),t=await g({runtime:this.options.runtime,binding:e,helper:this.helper,api:o,workDir:this.options.workDir},{foregroundMode:n}),s=n==="background"?t:await f(this.helper,t),v=await S(this.helper,s.windowId,void 0,s.bounds),y=await A(this.helper,v),l=b({binding:e,ocr:y,prior:a});return!l?.fingerprint||l.fingerprint!==a.fingerprint?{skip:!1}:{skip:!0,reasonCode:"conversation_fingerprint_unchanged",fingerprint:l.fingerprint}}catch{return{skip:!1}}}}function ne(r){return new H(r)}function R(r,e,n,i=3){return(D(r,e).bindings[n]?.recent??[]).slice(-i).map(t=>({stableMessageKey:t.stableMessageKey,senderRole:t.senderRole,kind:t.kind,anchorText:t.anchorText??t.normalizedText??t.textExcerpt??null,anchorMetadata:t.anchorMetadata??null}))}function E(r){if(r.helperClientOptions)return new m({...r.helperClientOptions,requiredCapabilities:r.helperClientOptions.requiredCapabilities??w(r.runtime),guardUnsafeWindowsCommands:r.helperClientOptions.guardUnsafeWindowsCommands??r.runtime.policy.platform==="win32",skipUserActivityGuard:r.helperClientOptions.skipUserActivityGuard??r.runtime.foregroundPolicy==="work",cleanupWindowsOverlays:r.helperClientOptions.cleanupWindowsOverlays??r.runtime.policy.platform==="win32",requestLogger:r.helperClientOptions.requestLogger??r.helperRequestLogger});const e=k();if(!e.ok)throw new Error(`${e.reasonCode}: ${e.message}`);return new m({helperPath:e.helperPath,expectedHelperVersion:e.version||W,requiredCapabilities:w(r.runtime),guardUnsafeWindowsCommands:r.runtime.policy.platform==="win32",skipUserActivityGuard:r.runtime.foregroundPolicy==="work",cleanupWindowsOverlays:r.runtime.policy.platform==="win32",requestLogger:r.helperRequestLogger})}function w(r){if(r.policy.platform==="win32")return r.bindings.some(e=>e.enabled!==!1&&e.allowReply!==!1)?h("send"):r.bindings.some(e=>e.enabled!==!1&&e.downloadMedia!==!1)?h("download"):h("observe")}function U(r,e){return d.join(r,"wechat-channel",`${e}.ledger.json`)}function C(r,e){return d.join(r,"wechat-channel",`${G(e)}.conversation-fingerprints.json`)}function c(r,e){try{const n=JSON.parse(u.readFileSync(r,"utf8"));if(n?.version===1&&n.runtimeId===e&&n.bindings&&typeof n.bindings=="object")return n}catch{}return{version:1,runtimeId:e,bindings:{}}}function B(r,e){u.mkdirSync(d.dirname(r),{recursive:!0}),u.writeFileSync(r,JSON.stringify(e,null,2))}function N(r){const e=b({binding:r.binding,ocr:r.ocr,prior:c(r.statePath,r.runtimeId).bindings[r.binding.bindingId]});if(!e?.fingerprint)return;const n=c(r.statePath,r.runtimeId);n.bindings[r.binding.bindingId]={bindingId:r.binding.bindingId,fingerprint:e.fingerprint,title:e.item.title??null,preview:e.item.preview??null,timeText:e.item.timeText??null,unreadText:e.item.unreadText??null,observedAt:new Date().toISOString()},B(r.statePath,n)}function b(r){const e=r.ocr.visibleConversationFingerprints??[],n=T({visibleItems:e,targets:[{bindingId:r.binding.bindingId,conversationDisplayName:r.binding.conversationDisplayName,lastConversationFingerprint:r.prior?.fingerprint,lastPreview:r.prior?.preview??void 0}]})[0];if(!n)return null;const i=n.item.fingerprint||M(n.item);return i?{item:n.item,fingerprint:i}:null}function G(r){return String(r||"").trim().replace(/[^a-zA-Z0-9._-]+/g,"_").replace(/^_+|_+$/g,"")||"wechat-channel-runtime"}export{H as WeChatChannelProductRunner,R as buildLocalLedgerTailAnchors,ne as createWeChatChannelProductRunner};

package/dist/src/channels/wechat-channel/runtime.d.ts

@@ -4,6 +4,7 @@ export declare const WECHAT_CHANNEL_RECENT_MESSAGE_WINDOW = 20;
 export declare const WECHAT_CHANNEL_DEFAULT_POLL_INTERVAL_MS: number;
 export declare const WECHAT_CHANNEL_MIN_POLL_INTERVAL_MS: number;
 export declare const WECHAT_CHANNEL_MAX_POLL_INTERVAL_MS: number;
+export declare const WECHAT_CHANNEL_DEFAULT_FOREGROUND_POLICY: "work";
 export type WeChatChannelForegroundPolicy = 'polite' | 'work';
 export type WeChatChannelRuntimePlatform = 'darwin' | 'win32';
 export type WeChatChannelRuntimePolicy = {
@@ -45,3 +46,4 @@ export type WeChatChannelRuntime = {
 export declare function defaultWeChatChannelRuntimePolicy(pollIntervalMs?: number | null, platform?: WeChatChannelRuntimePlatform | null): WeChatChannelRuntimePolicy;
 export declare function normalizeWeChatChannelPollIntervalMs(value?: number | null): number;
 export declare function createWeChatChannelRuntime(config: WeChatChannelRuntimeConfig): WeChatChannelRuntime;
+export declare function normalizeWeChatChannelForegroundPolicy(policy?: WeChatChannelForegroundPolicy | null): WeChatChannelForegroundPolicy;

package/dist/src/channels/wechat-channel/runtime.js

@@ -1 +1 @@
-const a="wechat_channel",E=1,d=20,A=6e4,L=3e4,u=3e5;function _(n,e){return{kind:a,runtimeVersion:1,platform:l(e),pollIntervalMs:s(n),minPollIntervalMs:3e4,maxPollIntervalMs:3e5,recentMessageWindow:20,requiresServerDecision:!0,requiresPlatformHelper:!0,productRuntimeUsesLabFacade:!1}}function s(n){return Number.isFinite(n)?Math.min(3e5,Math.max(3e4,Number(n))):6e4}function C(n){const e=o(n.runtimeId,"runtimeId"),t=o(n.machineId,"machineId"),r=s(n.pollIntervalMs),i=l(n.platform);return{kind:a,runtimeId:e,machineId:t,foregroundPolicy:n.foregroundPolicy==="work"?"work":"polite",policy:_(r,i),bindings:N(n.bindings??[])}}function l(n){return n==="win32"?"win32":n==="darwin"?"darwin":process.platform==="win32"?"win32":"darwin"}function N(n){const e=new Set,t=[];for(const r of n){const i=o(r.bindingId,"bindingId");e.has(i)||(e.add(i),t.push({bindingId:i,sessionId:o(r.sessionId,"sessionId"),conversationDisplayName:o(r.conversationDisplayName,"conversationDisplayName"),enabled:r.enabled!==!1,allowReply:r.allowReply!==!1,downloadMedia:r.downloadMedia!==!1}))}return t}function o(n,e){const t=String(n||"").trim();if(!t)throw new Error(`WeChat channel ${e} is required`);return t}export{A as WECHAT_CHANNEL_DEFAULT_POLL_INTERVAL_MS,u as WECHAT_CHANNEL_MAX_POLL_INTERVAL_MS,L as WECHAT_CHANNEL_MIN_POLL_INTERVAL_MS,d as WECHAT_CHANNEL_RECENT_MESSAGE_WINDOW,a as WECHAT_CHANNEL_RUNTIME_KIND,E as WECHAT_CHANNEL_RUNTIME_VERSION,C as createWeChatChannelRuntime,_ as defaultWeChatChannelRuntimePolicy,s as normalizeWeChatChannelPollIntervalMs};
+const a="wechat_channel",A=1,L=20,C=6e4,u=3e4,c=3e5,s="work";function N(n,e){return{kind:a,runtimeVersion:1,platform:_(e),pollIntervalMs:l(n),minPollIntervalMs:3e4,maxPollIntervalMs:3e5,recentMessageWindow:20,requiresServerDecision:!0,requiresPlatformHelper:!0,productRuntimeUsesLabFacade:!1}}function l(n){return Number.isFinite(n)?Math.min(3e5,Math.max(3e4,Number(n))):6e4}function I(n){const e=i(n.runtimeId,"runtimeId"),t=i(n.machineId,"machineId"),r=l(n.pollIntervalMs),o=_(n.platform);return{kind:a,runtimeId:e,machineId:t,foregroundPolicy:E(n.foregroundPolicy),policy:N(r,o),bindings:d(n.bindings??[])}}function E(n){return n==="polite"?"polite":s}function _(n){return n==="win32"?"win32":n==="darwin"?"darwin":process.platform==="win32"?"win32":"darwin"}function d(n){const e=new Set,t=[];for(const r of n){const o=i(r.bindingId,"bindingId");e.has(o)||(e.add(o),t.push({bindingId:o,sessionId:i(r.sessionId,"sessionId"),conversationDisplayName:i(r.conversationDisplayName,"conversationDisplayName"),enabled:r.enabled!==!1,allowReply:r.allowReply!==!1,downloadMedia:r.downloadMedia!==!1}))}return t}function i(n,e){const t=String(n||"").trim();if(!t)throw new Error(`WeChat channel ${e} is required`);return t}export{s as WECHAT_CHANNEL_DEFAULT_FOREGROUND_POLICY,C as WECHAT_CHANNEL_DEFAULT_POLL_INTERVAL_MS,c as WECHAT_CHANNEL_MAX_POLL_INTERVAL_MS,u as WECHAT_CHANNEL_MIN_POLL_INTERVAL_MS,L as WECHAT_CHANNEL_RECENT_MESSAGE_WINDOW,a as WECHAT_CHANNEL_RUNTIME_KIND,A as WECHAT_CHANNEL_RUNTIME_VERSION,I as createWeChatChannelRuntime,N as defaultWeChatChannelRuntimePolicy,E as normalizeWeChatChannelForegroundPolicy,l as normalizeWeChatChannelPollIntervalMs};

package/dist/src/channels/wechat-channel/scheduler.d.ts

@@ -28,6 +28,9 @@ export type WeChatChannelSchedulerOptions = {
     outboundLedgerPath?: string;
     maxUserActivityWaitMs?: number;
 };
+export type WeChatChannelSchedulerTickOptions = {
+    forceObserve?: boolean;
+};
 export type WeChatChannelSchedulerActivityGate = {
     canObserve: (binding: WeChatChannelBindingConfig, now: Date) => Promise<{
         ok: true;
@@ -61,10 +64,11 @@ export declare class WeChatChannelScheduler {
     private options;
     private timer;
     private running;
+    private runningTick;
     constructor(options: WeChatChannelSchedulerOptions);
     start(): Promise<void>;
     stop(): void;
-    tick(): Promise<WeChatChannelSchedulerTickResult | void>;
+    tick(options?: WeChatChannelSchedulerTickOptions): Promise<WeChatChannelSchedulerTickResult | void>;
     noteInterruption(bindingId: string, reason?: string, now?: Date): void;
     private reportOutboundProjections;
 }

package/dist/src/channels/wechat-channel/scheduler.js

@@ -1 +1 @@
-import w from"node:path";import{loadWeChatChannelLedger as C,markWeChatChannelBindingDisabled as I,saveWeChatChannelLedger as v,updateWeChatChannelBindingLedger as S}from"./ledger.js";import{classifyWeChatOutboundEchoes as y,isWeChatOutboundTerminalDeliveryStatus as O,loadWeChatChannelOutboundLedger as E,markWeChatOutboundUserActiveTimeout as W,markWeChatOutboundWaitingUserIdle as A,saveWeChatChannelOutboundLedger as k,shouldFailWeChatOutboundForUserActiveTimeout as x}from"./outbound-ledger.js";import{clearExpiredWeChatChannelCooldown as M,isWeChatChannelCooldownActive as U,noteWeChatChannelBillingPause as L,noteWeChatChannelInterruption as P,noteWeChatChannelStableRun as T}from"./cooldown.js";import{sendQueuedWeChatOutboundRecords as B}from"./outbound-sender.js";const D=600*1e3;class tn{options;timer=null;running=!1;constructor(t){this.options=t}async start(){this.timer||(await this.tick(),this.timer=setInterval(()=>{this.tick().catch(()=>{})},this.options.runtime.policy.pollIntervalMs),this.timer.unref())}stop(){this.timer&&(clearInterval(this.timer),this.timer=null)}async tick(){if(!this.running){this.running=!0;try{const t=this.options.ledgerPath||R(this.options.workDir,this.options.runtime.runtimeId),i=this.options.outboundLedgerPath||N(this.options.workDir,this.options.runtime.runtimeId),o=C(t,this.options.runtime.runtimeId),s=E(i,this.options.runtime.runtimeId),a=[],c=new Date;for(const e of this.options.runtime.bindings.filter(d=>!d.enabled))o.bindings[e.bindingId]?.disabledSince||I({ledger:o,bindingId:e.bindingId});for(const e of this.options.runtime.bindings.filter(d=>d.enabled)){await this.options.api.upsertRuntime(this.options.runtime,e);const d=o.bindings[e.bindingId],f=s.records.filter(r=>r.bindingId===e.bindingId),p=K(this.options.runtime,f);if(d?.cooldown&&(d.cooldown=M(d.cooldown),U(d.cooldown))){await this.options.api.reportRunStatus(this.options.runtime,e,{status:"cooldown",reasonCode:d.cooldown.manualReviewReason||"user_interruption_cooldown"}),a.push({bindingId:e.bindingId,observedCount:0,newInboundCount:0,outboundSentCount:0,staleOutboundCount:0,failedOutboundCount:0,waitingOutboundCount:0,confirmedEchoCount:0,manualReviewCount:0,revision:d.revision});continue}const b=this.options.activityGate?await this.options.activityGate.canObserve(e,c):{ok:!0};if(b.ok===!1){const r=Y({records:s.records,bindingId:e.bindingId,reasonCode:b.reasonCode,nextAttemptAt:b.nextAttemptAt,now:c,maxUserActivityWaitMs:this.options.maxUserActivityWaitMs??D});await this.reportOutboundProjections(e,[...r.waitingRecords,...r.failedRecords]),await this.options.api.reportRunStatus(this.options.runtime,e,{status:"observe_deferred_user_active",reasonCode:r.failedRecords[0]?.failureCode||b.reasonCode}),a.push({bindingId:e.bindingId,observedCount:0,newInboundCount:0,outboundSentCount:0,staleOutboundCount:0,failedOutboundCount:r.failedRecords.length,waitingOutboundCount:r.waitingRecords.length,confirmedEchoCount:0,manualReviewCount:0,revision:d?.revision??0});continue}if(this.options.shouldSkipObserve&&G(d,f)){const r=await this.options.shouldSkipObserve(e,{ledgerBinding:d,outboundRecords:f,now:c,foregroundMode:p});if(r.skip){await this.options.api.reportRunStatus(this.options.runtime,e,{status:F(r.reasonCode),reasonCode:r.reasonCode}),a.push({bindingId:e.bindingId,observedCount:0,newInboundCount:0,outboundSentCount:0,staleOutboundCount:0,failedOutboundCount:0,waitingOutboundCount:0,confirmedEchoCount:0,manualReviewCount:0,revision:d?.revision??0});continue}}let m;try{m=await this.options.observeBinding(e,{localOutboundEchoAnchors:H(s.records,e.bindingId),foregroundMode:p})}catch(r){if(q(r)){await this.options.api.reportRunStatus(this.options.runtime,e,{status:"observe_deferred_window_unavailable",reasonCode:_(r,"wechat_window_unavailable"),lastErrorSummary:r instanceof Error?r.message:"wechat_window_unavailable"}),a.push({bindingId:e.bindingId,observedCount:0,newInboundCount:0,outboundSentCount:0,staleOutboundCount:0,failedOutboundCount:0,waitingOutboundCount:0,confirmedEchoCount:0,manualReviewCount:0,revision:d?.revision??0});continue}if($(r)){await this.options.api.reportRunStatus(this.options.runtime,e,{status:"wechat_window_unresponsive",reasonCode:"wechat_window_unresponsive",lastErrorSummary:r instanceof Error?r.message:"wechat_window_unresponsive"}),a.push({bindingId:e.bindingId,observedCount:0,newInboundCount:0,outboundSentCount:0,staleOutboundCount:0,failedOutboundCount:0,waitingOutboundCount:0,confirmedEchoCount:0,manualReviewCount:0,revision:d?.revision??0});continue}if(j(r)){const g=d??{bindingId:e.bindingId,baselineEstablished:!1,revision:0,recent:[],pendingSendKeys:[]};g.cooldown=L({state:g.cooldown,reason:"insufficient_credits",now:c}),o.bindings[e.bindingId]=g,await this.options.api.reportRunStatus(this.options.runtime,e,{status:"billing_paused",reasonCode:"insufficient_credits",lastErrorSummary:r instanceof Error?r.message:"insufficient_credits"}),a.push({bindingId:e.bindingId,observedCount:0,newInboundCount:0,outboundSentCount:0,staleOutboundCount:0,failedOutboundCount:0,waitingOutboundCount:0,confirmedEchoCount:0,manualReviewCount:0,revision:g.revision});continue}throw r}const h=y({ledger:s,bindingId:e.bindingId,messages:m}),l=S({ledger:o,bindingId:e.bindingId,observedMessages:h.remainingMessages}),u=this.options.outboundSender?await B({ledger:s,bindingId:e.bindingId,currentLastInboundRevision:l.binding.revision,sender:this.options.outboundSender,now:c,maxUserActivityWaitMs:this.options.maxUserActivityWaitMs}):{sentRecords:[],staleRecords:[],failedRecords:[],waitingRecords:[],manualReviewRecords:[]};l.binding.cooldown=T(l.binding.cooldown),l.newMessages.length>0&&(await this.options.api.ingest(this.options.runtime,e,{idempotencyKey:`${e.bindingId}:${l.binding.revision}:${Q(l.newMessages)}`,messages:l.newMessages}),await this.options.onInboundMessages?.(e,l.newMessages)),await this.reportOutboundProjections(e,[...h.confirmedRecords,...h.manualReviewRecords,...u.sentRecords,...u.staleRecords,...u.failedRecords,...u.waitingRecords,...u.manualReviewRecords]),await this.options.api.reportRunStatus(this.options.runtime,e,{status:V(l.newMessages.length,h.confirmedRecords,h.manualReviewRecords,u.sentRecords,u.staleRecords,u.failedRecords,u.waitingRecords,u.manualReviewRecords),reasonCode:u.waitingRecords[0]?.deferReason}),a.push({bindingId:e.bindingId,observedCount:m.length,newInboundCount:l.newMessages.length,outboundSentCount:u.sentRecords.length,staleOutboundCount:u.staleRecords.length,failedOutboundCount:u.failedRecords.length,waitingOutboundCount:u.waitingRecords.length,confirmedEchoCount:h.confirmedRecords.length,manualReviewCount:h.manualReviewRecords.length+u.manualReviewRecords.length,revision:l.binding.revision})}return v(t,o),k(i,s),a}finally{this.running=!1}}}noteInterruption(t,i,o=new Date){const s=this.options.ledgerPath||R(this.options.workDir,this.options.runtime.runtimeId),a=C(s,this.options.runtime.runtimeId),c=a.bindings[t]??{bindingId:t,baselineEstablished:!1,revision:0,recent:[],pendingSendKeys:[]};c.cooldown=P({state:c.cooldown,reason:i,now:o}),a.bindings[t]=c,v(s,a)}async reportOutboundProjections(t,i){if(this.options.api.reportOutboundStatus)for(const o of i)await this.options.api.reportOutboundStatus(this.options.runtime,t,{replyId:o.replyId,idempotencyKey:o.idempotencyKey,status:o.sendStatus,replyBaseRevision:o.replyBaseRevision,sentAt:o.sentAt,confirmedAt:o.confirmedAt,failureCode:o.failureCode,lastErrorSummary:o.lastErrorSummary,nextAttemptAt:o.nextAttemptAt,attemptCount:o.attemptCount,commitStage:o.commitStage,copyableContentRef:o.copyableContentRef,copyableText:z(o)?o.text:void 0,agentVisible:O(o)?!1:void 0})}}function j(n){return!n||typeof n!="object"?!1:n.reasonCode==="insufficient_credits"?!0:n instanceof Error&&/\binsufficient_credits\b/.test(n.message)}function K(n,t){return n.foregroundPolicy==="work"||t.some(i=>i.sendStatus==="queued"||i.sendStatus==="sending"||i.sendStatus==="sent_unconfirmed")?"required":"background"}function F(n){return n==="conversation_not_visible_background"?"observe_deferred_window_unavailable":"baseline_or_no_change"}function q(n){const t=_(n);return t==="wechat_window_unavailable"||t==="wechat_window_not_found"||t==="conversation_not_visible_background"||t==="wechat_window_obstructed_background"}function _(n,t="unknown_error"){if(n&&typeof n=="object"){const s=n.reasonCode??n.errorCode;if(typeof s=="string"&&s.trim())return s.trim()}return(n instanceof Error?n.message:String(n||"")).match(/^([a-z0-9_./-]+)(?::|\b)/i)?.[1]||t}function $(n){return n instanceof Error&&/\bwechat_window_unresponsive\b/i.test(n.message)}function G(n,t){return!n?.baselineEstablished||n.disabledSince||!n.recent.length?!1:!t.some(i=>i.sendStatus==="queued"||i.sendStatus==="sending"||i.sendStatus==="sent_unconfirmed")}function z(n){return(n.sendStatus==="failed"||n.sendStatus==="manual_review")&&!!n.text}function R(n,t){return w.join(n,"wechat-channel",`${t}.ledger.json`)}function N(n,t){return w.join(n,"wechat-channel",`${t}.outbound-ledger.json`)}function Q(n){return n.at(-1)?.stableMessageKey||"empty"}function V(n,t,i,o=[],s=[],a=[],c=[],e=[]){return i.length>0||e.length>0?"manual_review":a.length>0?"outbound_send_failed":s.length>0?"outbound_stale":c.length>0?"send_waiting_user_idle":n>0?"new_messages_ingested":o.length>0?"outbound_sent_unconfirmed":t.length>0?"outbound_echo_confirmed":"baseline_or_no_change"}function H(n,t){return n.filter(i=>i.bindingId===t&&i.sendStatus==="sent_unconfirmed").map(i=>({replyId:i.replyId,idempotencyKey:i.idempotencyKey,expectedEchoAnchor:i.expectedEchoAnchor||i.textNormalized||i.text||""}))}function Y(n){const t=n.records.filter(s=>s.bindingId===n.bindingId&&s.sendStatus==="queued"),i=[],o=[];for(const s of t)A({record:s,reasonCode:n.reasonCode,nextAttemptAt:n.nextAttemptAt,now:n.now}),x({record:s,now:n.now,maxWaitMs:n.maxUserActivityWaitMs})?(W(s,n.now),i.push(s)):o.push(s);return{waitingRecords:o,failedRecords:i}}export{tn as WeChatChannelScheduler};
+import v from"node:path";import{loadWeChatChannelLedger as _,markWeChatChannelBindingDisabled as y,saveWeChatChannelLedger as R,updateWeChatChannelBindingLedger as O}from"./ledger.js";import{classifyWeChatOutboundEchoes as k,isWeChatOutboundTerminalDeliveryStatus as E,loadWeChatChannelOutboundLedger as W,markWeChatOutboundUserActiveTimeout as A,markWeChatOutboundWaitingUserIdle as x,saveWeChatChannelOutboundLedger as M,shouldFailWeChatOutboundForUserActiveTimeout as T}from"./outbound-ledger.js";import{clearExpiredWeChatChannelCooldown as P,isWeChatChannelCooldownActive as U,noteWeChatChannelBillingPause as L,noteWeChatChannelInterruption as B,noteWeChatChannelStableRun as D}from"./cooldown.js";import{sendQueuedWeChatOutboundRecords as j}from"./outbound-sender.js";const K=600*1e3;class sn{options;timer=null;running=!1;runningTick=null;constructor(t){this.options=t}async start(){this.timer||(await this.tick(),this.timer=setInterval(()=>{this.tick().catch(()=>{})},this.options.runtime.policy.pollIntervalMs),this.timer.unref())}stop(){this.timer&&(clearInterval(this.timer),this.timer=null)}async tick(t={}){for(;this.running;){if(!t.forceObserve)return;const i=this.runningTick;if(!i)return;await i}this.running=!0;let o=()=>{};this.runningTick=new Promise(i=>{o=i});try{const i=this.options.ledgerPath||S(this.options.workDir,this.options.runtime.runtimeId),r=this.options.outboundLedgerPath||V(this.options.workDir,this.options.runtime.runtimeId),d=_(i,this.options.runtime.runtimeId),c=W(r,this.options.runtime.runtimeId),h=[],g=new Date;for(const e of this.options.runtime.bindings.filter(u=>!u.enabled))d.bindings[e.bindingId]?.disabledSince||y({ledger:d,bindingId:e.bindingId});for(const e of this.options.runtime.bindings.filter(u=>u.enabled)){await this.options.api.upsertRuntime(this.options.runtime,e);const u=d.bindings[e.bindingId],p=c.records.filter(s=>s.bindingId===e.bindingId),C=q(this.options.runtime,p);if(u?.cooldown&&(u.cooldown=P(u.cooldown),U(u.cooldown))){await this.options.api.reportRunStatus(this.options.runtime,e,{status:"cooldown",reasonCode:u.cooldown.manualReviewReason||"user_interruption_cooldown"}),h.push({bindingId:e.bindingId,observedCount:0,newInboundCount:0,outboundSentCount:0,staleOutboundCount:0,failedOutboundCount:0,waitingOutboundCount:0,confirmedEchoCount:0,manualReviewCount:0,revision:u.revision});continue}const f=this.options.activityGate?await this.options.activityGate.canObserve(e,g):{ok:!0};if(f.ok===!1){const s=X({records:c.records,bindingId:e.bindingId,reasonCode:f.reasonCode,nextAttemptAt:f.nextAttemptAt,now:g,maxUserActivityWaitMs:this.options.maxUserActivityWaitMs??K});await this.reportOutboundProjections(e,[...s.waitingRecords,...s.failedRecords]),await this.options.api.reportRunStatus(this.options.runtime,e,{status:"observe_deferred_user_active",reasonCode:s.failedRecords[0]?.failureCode||f.reasonCode}),h.push({bindingId:e.bindingId,observedCount:0,newInboundCount:0,outboundSentCount:0,staleOutboundCount:0,failedOutboundCount:s.failedRecords.length,waitingOutboundCount:s.waitingRecords.length,confirmedEchoCount:0,manualReviewCount:0,revision:u?.revision??0});continue}if(!t.forceObserve&&this.options.shouldSkipObserve&&N(u,p)){const s=await this.options.shouldSkipObserve(e,{ledgerBinding:u,outboundRecords:p,now:g,foregroundMode:C});if(s.skip){await this.options.api.reportRunStatus(this.options.runtime,e,{status:$(s.reasonCode),reasonCode:s.reasonCode}),h.push({bindingId:e.bindingId,observedCount:0,newInboundCount:0,outboundSentCount:0,staleOutboundCount:0,failedOutboundCount:0,waitingOutboundCount:0,confirmedEchoCount:0,manualReviewCount:0,revision:u?.revision??0});continue}}let w;try{w=await this.options.observeBinding(e,{localOutboundEchoAnchors:J(c.records,e.bindingId),foregroundMode:C})}catch(s){if(G(s)){await this.options.api.reportRunStatus(this.options.runtime,e,{status:"observe_deferred_window_unavailable",reasonCode:I(s,"wechat_window_unavailable"),lastErrorSummary:s instanceof Error?s.message:"wechat_window_unavailable"}),h.push({bindingId:e.bindingId,observedCount:0,newInboundCount:0,outboundSentCount:0,staleOutboundCount:0,failedOutboundCount:0,waitingOutboundCount:0,confirmedEchoCount:0,manualReviewCount:0,revision:u?.revision??0});continue}if(z(s)){await this.options.api.reportRunStatus(this.options.runtime,e,{status:"wechat_window_unresponsive",reasonCode:"wechat_window_unresponsive",lastErrorSummary:s instanceof Error?s.message:"wechat_window_unresponsive"}),h.push({bindingId:e.bindingId,observedCount:0,newInboundCount:0,outboundSentCount:0,staleOutboundCount:0,failedOutboundCount:0,waitingOutboundCount:0,confirmedEchoCount:0,manualReviewCount:0,revision:u?.revision??0});continue}if(F(s)){const m=u??{bindingId:e.bindingId,baselineEstablished:!1,revision:0,recent:[],pendingSendKeys:[]};m.cooldown=L({state:m.cooldown,reason:"insufficient_credits",now:g}),d.bindings[e.bindingId]=m,await this.options.api.reportRunStatus(this.options.runtime,e,{status:"billing_paused",reasonCode:"insufficient_credits",lastErrorSummary:s instanceof Error?s.message:"insufficient_credits"}),h.push({bindingId:e.bindingId,observedCount:0,newInboundCount:0,outboundSentCount:0,staleOutboundCount:0,failedOutboundCount:0,waitingOutboundCount:0,confirmedEchoCount:0,manualReviewCount:0,revision:m.revision});continue}throw s}const b=k({ledger:c,bindingId:e.bindingId,messages:w}),l=O({ledger:d,bindingId:e.bindingId,observedMessages:b.remainingMessages}),a=this.options.outboundSender?await j({ledger:c,bindingId:e.bindingId,currentLastInboundRevision:l.binding.revision,sender:this.options.outboundSender,now:g,maxUserActivityWaitMs:this.options.maxUserActivityWaitMs}):{sentRecords:[],staleRecords:[],failedRecords:[],waitingRecords:[],manualReviewRecords:[]};l.binding.cooldown=D(l.binding.cooldown),l.newMessages.length>0&&(await this.options.api.ingest(this.options.runtime,e,{idempotencyKey:`${e.bindingId}:${l.binding.revision}:${H(l.newMessages)}`,messages:l.newMessages}),await this.options.onInboundMessages?.(e,l.newMessages)),await this.reportOutboundProjections(e,[...b.confirmedRecords,...b.manualReviewRecords,...a.sentRecords,...a.staleRecords,...a.failedRecords,...a.waitingRecords,...a.manualReviewRecords]),await this.options.api.reportRunStatus(this.options.runtime,e,{status:Y(l.newMessages.length,b.confirmedRecords,b.manualReviewRecords,a.sentRecords,a.staleRecords,a.failedRecords,a.waitingRecords,a.manualReviewRecords),reasonCode:a.waitingRecords[0]?.deferReason}),h.push({bindingId:e.bindingId,observedCount:w.length,newInboundCount:l.newMessages.length,outboundSentCount:a.sentRecords.length,staleOutboundCount:a.staleRecords.length,failedOutboundCount:a.failedRecords.length,waitingOutboundCount:a.waitingRecords.length,confirmedEchoCount:b.confirmedRecords.length,manualReviewCount:b.manualReviewRecords.length+a.manualReviewRecords.length,revision:l.binding.revision})}return R(i,d),M(r,c),h}finally{o(),this.runningTick=null,this.running=!1}}noteInterruption(t,o,i=new Date){const r=this.options.ledgerPath||S(this.options.workDir,this.options.runtime.runtimeId),d=_(r,this.options.runtime.runtimeId),c=d.bindings[t]??{bindingId:t,baselineEstablished:!1,revision:0,recent:[],pendingSendKeys:[]};c.cooldown=B({state:c.cooldown,reason:o,now:i}),d.bindings[t]=c,R(r,d)}async reportOutboundProjections(t,o){if(this.options.api.reportOutboundStatus)for(const i of o)await this.options.api.reportOutboundStatus(this.options.runtime,t,{replyId:i.replyId,idempotencyKey:i.idempotencyKey,status:i.sendStatus,replyBaseRevision:i.replyBaseRevision,sentAt:i.sentAt,confirmedAt:i.confirmedAt,failureCode:i.failureCode,lastErrorSummary:i.lastErrorSummary,nextAttemptAt:i.nextAttemptAt,attemptCount:i.attemptCount,commitStage:i.commitStage,copyableContentRef:i.copyableContentRef,copyableText:Q(i)?i.text:void 0,agentVisible:E(i)?!1:void 0})}}function F(n){return!n||typeof n!="object"?!1:n.reasonCode==="insufficient_credits"?!0:n instanceof Error&&/\binsufficient_credits\b/.test(n.message)}function q(n,t){return n.foregroundPolicy==="work"||t.some(o=>o.sendStatus==="queued"||o.sendStatus==="sending"||o.sendStatus==="sent_unconfirmed")?"required":"background"}function $(n){return n==="conversation_not_visible_background"?"observe_deferred_window_unavailable":"baseline_or_no_change"}function G(n){const t=I(n);return t==="wechat_window_unavailable"||t==="wechat_window_not_found"||t==="conversation_not_visible_background"||t==="wechat_window_obstructed_background"}function I(n,t="unknown_error"){if(n&&typeof n=="object"){const r=n.reasonCode??n.errorCode;if(typeof r=="string"&&r.trim())return r.trim()}return(n instanceof Error?n.message:String(n||"")).match(/^([a-z0-9_./-]+)(?::|\b)/i)?.[1]||t}function z(n){return n instanceof Error&&/\bwechat_window_unresponsive\b/i.test(n.message)}function N(n,t){return!n?.baselineEstablished||n.disabledSince||!n.recent.length?!1:!t.some(o=>o.sendStatus==="queued"||o.sendStatus==="sending"||o.sendStatus==="sent_unconfirmed")}function Q(n){return(n.sendStatus==="failed"||n.sendStatus==="manual_review")&&!!n.text}function S(n,t){return v.join(n,"wechat-channel",`${t}.ledger.json`)}function V(n,t){return v.join(n,"wechat-channel",`${t}.outbound-ledger.json`)}function H(n){return n.at(-1)?.stableMessageKey||"empty"}function Y(n,t,o,i=[],r=[],d=[],c=[],h=[]){return o.length>0||h.length>0?"manual_review":d.length>0?"outbound_send_failed":r.length>0?"outbound_stale":c.length>0?"send_waiting_user_idle":n>0?"new_messages_ingested":i.length>0?"outbound_sent_unconfirmed":t.length>0?"outbound_echo_confirmed":"baseline_or_no_change"}function J(n,t){return n.filter(o=>o.bindingId===t&&o.sendStatus==="sent_unconfirmed").map(o=>({replyId:o.replyId,idempotencyKey:o.idempotencyKey,expectedEchoAnchor:o.expectedEchoAnchor||o.textNormalized||o.text||""}))}function X(n){const t=n.records.filter(r=>r.bindingId===n.bindingId&&r.sendStatus==="queued"),o=[],i=[];for(const r of t)x({record:r,reasonCode:n.reasonCode,nextAttemptAt:n.nextAttemptAt,now:n.now}),T({record:r,now:n.now,maxWaitMs:n.maxUserActivityWaitMs})?(A(r,n.now),o.push(r)):i.push(r);return{waitingRecords:i,failedRecords:o}}export{sn as WeChatChannelScheduler};

package/dist/src/channels/wechat-rpa/product-channel.d.ts

@@ -1,6 +1,7 @@
 import type { ExternalChannelConfig, ExternalMessageEvent, ExternalReply } from '../base.js';
 import type { WeChatRpaPendingReplyProjection } from '@shennian/wire';
 import { type WeChatChannelProductRunnerOptions } from '../wechat-channel/runner.js';
+import type { WeChatChannelSchedulerTickOptions } from '../wechat-channel/scheduler.js';
 import { type WeChatChannelBindingConfig, type WeChatChannelRuntime } from '../wechat-channel/runtime.js';
 import type { WeChatChannelObservedMessage } from '../wechat-channel/client.js';
 import { type WeChatChannelOutboundRecord } from '../wechat-channel/outbound-ledger.js';
@@ -16,7 +17,7 @@ export type WeChatRpaProductSourceSecret = {
 };
 export type WeChatChannelProductRunnerLike = {
     start(): Promise<void>;
-    tick(): Promise<unknown>;
+    tick(options?: WeChatChannelSchedulerTickOptions): Promise<unknown>;
     stop(): Promise<void>;
 };
 export type WeChatRpaProductSourceConnection = {
@@ -25,6 +26,7 @@ export type WeChatRpaProductSourceConnection = {
     emitted: ExternalMessageEvent[];
     ledgerPath: string;
     outboundLedgerPath: string;
+    helperTracePath: string;
 };
 export type WeChatRpaProductRunnerFactory = (options: WeChatChannelProductRunnerOptions) => WeChatChannelProductRunnerLike;
 export declare function createWeChatRpaProductSourceConnection(input: {
@@ -67,5 +69,6 @@ export declare function weChatChannelConversationId(conversationName: string): s
 export declare function weChatChannelBindingId(channelId: string, conversationName: string): string;
 export declare function weChatChannelLedgerPath(workDir: string, runtimeId: string): string;
 export declare function weChatChannelOutboundLedgerPath(workDir: string, runtimeId: string): string;
+export declare function weChatChannelHelperTracePath(workDir: string, runtimeId: string): string;
 export declare function safeWeChatChannelRuntimePathSegment(runtimeId: string): string;
 export declare function observedMessageToExternalEvent(config: ExternalChannelConfig, binding: WeChatChannelBindingConfig, message: WeChatChannelObservedMessage): ExternalMessageEvent | null;