omo-ai 5.1.74 → 5.1.75
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/darwin/omo-keychain +0 -0
- package/bin/lib/service-auth.generated.js +1 -1
- package/package.json +1 -1
- package/plugin/CHANGELOG.md +13 -0
- package/plugin/extensions/assets.generated.json +1 -1
- package/plugin/extensions/gateway-store-worker.mjs +1 -1
- package/plugin/extensions/memory-run-supervisor.mjs +1 -1
- package/plugin/extensions/omo-claim-receipt.js +1 -1
- package/plugin/extensions/omo-computer-run-worker.mjs +1 -1
- package/plugin/extensions/omo-computer-use.js +1 -1
- package/plugin/extensions/omo-desktop-toolkit.js +1 -1
- package/plugin/extensions/omo-device-account.js +2 -2
- package/plugin/extensions/omo-device-service.js +2 -2
- package/plugin/extensions/omo-feedback.js +2 -2
- package/plugin/extensions/omo-init-deep-advisor.js +1 -1
- package/plugin/extensions/omo-member.js +1 -1
- package/plugin/extensions/omo-memory-commands.js +1 -1
- package/plugin/extensions/omo-memory-doctor.js +1 -1
- package/plugin/extensions/omo-memory-memfs.js +1 -1
- package/plugin/extensions/omo-memory-palace.js +1 -1
- package/plugin/extensions/omo-memory-sync.js +2 -2
- package/plugin/extensions/omo-onboarding-scan.js +1 -1
- package/plugin/extensions/omo-recall-store.js +1 -1
- package/plugin/extensions/omo-session-history.js +1 -1
- package/plugin/extensions/omo-side-panel.js +1 -1
- package/plugin/extensions/omo-task.js +1 -1
- package/plugin/extensions/omo-telemetry-otlp.js +1 -1
- package/plugin/extensions/omo-telemetry-posthog.js +1 -1
- package/plugin/extensions/omo-telemetry-recovery.js +1 -1
- package/plugin/extensions/omo-thread-client.js +1 -1
- package/plugin/extensions/omo-wake.js +2 -2
- package/plugin/extensions/omo.js +3 -3
- package/plugin/package.json +1 -1
- package/plugin/runtime/agent-toolkit-sdk/sdk.js +2 -2
- package/plugin/runtime/ast-grep-mcp/manifest.json +1 -1
- package/plugin/runtime/bunshin-ts/sdk.js +2 -2
- package/plugin/runtime/category-coverage/assets.generated.json +1 -1
- package/plugin/runtime/rollback-migrate.js +1 -1
- package/plugin/runtime/thread-sdk/sdk.js +2 -2
- package/plugin/skills/browser/runtime/omowright/manifest.json +1 -1
package/bin/darwin/omo-keychain
CHANGED
|
Binary file
|
|
@@ -241,7 +241,7 @@ $ErrorActionPreference = 'Stop'
|
|
|
241
241
|
(New-Object System.Security.AccessControl.RawSecurityDescriptor("O:$env:LA_SID")).GetSddlForm('Owner')
|
|
242
242
|
`,runPowerShell2=async(script,env)=>{let encoded=Buffer.from(script,"utf16le").toString("base64"),proc=spawn4("powershell.exe",["-NoProfile","-NonInteractive","-ExecutionPolicy","Bypass","-EncodedCommand",encoded],{env:{...process.env,...env},stdio:["ignore","pipe","pipe"],windowsHide:!0}),chunks=[],errChunks=[];return proc.stdout.on("data",(chunk)=>chunks.push(chunk)),proc.stderr.on("data",(chunk)=>errChunks.push(chunk)),{code:await new Promise((resolve,reject)=>{proc.once("error",reject),proc.once("close",(exitCode)=>resolve(exitCode??-1))}),out:Buffer.concat(chunks).toString("utf8"),err:Buffer.concat(errChunks).toString("utf8")}},firstErrorLine=(err)=>{let line=(err??"").split(/\r?\n/).find((text)=>text.trim()!==""&&!text.startsWith("#< CLIXML"))?.trim()??"";return line===""?"":`: ${line.slice(0,300)}`},userSidToken=async(userSid,run=runPowerShell2)=>{let{code,out}=await run(SID_TOKEN_SCRIPT,{LA_SID:userSid});return(code===0?/^O:(S-1-\d+(?:-\d+)+|[A-Z]{2})$/.exec(out.trim()):null)?.[1]},aliasedDaclVerdict=(dacl,userSid,kind,userAlias)=>{let asSid=(token)=>userAlias!==void 0&&token===userAlias?userSid:token;return exactDaclVerdict({...dacl,owner:asSid(dacl.owner),aces:dacl.aces.map((ace)=>({...ace,sid:asSid(ace.sid)}))},userSid,kind)},applyExactDacl2=async(path,userSid,kind,run=runPowerShell2)=>{let{code,err}=await run(APPLY_DACL_SCRIPT,{LA_PATH:path,LA_SID:userSid,LA_KIND:kind});if(code!==0)throw new LocalApiError("insecure_state_dir",`the exact DACL could not be applied${firstErrorLine(err)}`)},verifyExactDacl2=async(path,userSid,kind,run=runPowerShell2)=>{let dacl;try{dacl=await describeDacl(path,run)}catch(error){if(error instanceof LocalApiError)return!1;throw error}return aliasedDaclVerdict(dacl,userSid,kind,await userSidToken(userSid,run))},windowsSecureFile2=(userSid,run=runPowerShell2)=>async(path,kind)=>{let target=kind==="dir"?"dir":"file";if(await applyExactDacl2(path,userSid,target,run),!await verifyExactDacl2(path,userSid,target,run))throw new LocalApiError("insecure_state_dir","the DACL is not exactly one ACE for the user")};var CHECKSUMS="checksums.txt",SIGNATURE="checksums.txt.sig",MANIFEST="latest.json",SIGNATURE_BYTES=64,CHECKSUMS_MAX_BYTES=65536,MANIFEST_MAX_BYTES=4096,BINARY_MAX_BYTES=536870912,DEVICE_SERVICE_HOSTS=["darwin-arm64","darwin-x64","linux-x64","linux-arm64","windows-x64","windows-arm64"],isDeviceServiceHost=(value)=>DEVICE_SERVICE_HOSTS.some((host)=>host===value),deviceServiceHost=(platform,arch)=>{let host=`${platform==="win32"?"windows":platform}-${arch}`;return isDeviceServiceHost(host)?host:void 0},deviceServiceAssetName=(host)=>host.startsWith("windows-")?`omo-device-service-${host}.exe`:`omo-device-service-${host}`,RELEASE_FILES=new Set([MANIFEST,...DEVICE_SERVICE_HOSTS.map(deviceServiceAssetName)]),CHECKSUM_LINE=/^([0-9a-f]{64}) {2}([A-Za-z0-9.-]+)$/,strictUtf8=(bytes)=>{try{return new TextDecoder("utf-8",{fatal:!0}).decode(bytes)}catch{return}},parseChecksums=(bytes)=>{let text=strictUtf8(bytes);if(text===void 0||!text.endsWith(`
|
|
243
243
|
`))return;let digests=new Map;for(let line of text.slice(0,-1).split(`
|
|
244
|
-
`)){let match=CHECKSUM_LINE.exec(line),digest=match?.[1],name=match?.[2];if(digest===void 0||name===void 0||!RELEASE_FILES.has(name)||digests.has(name))return;digests.set(name,digest)}return digests},parseManifest=(bytes)=>{let text=strictUtf8(bytes);if(text===void 0)return;let value;try{value=JSON.parse(text)}catch{return}if(typeof value!=="object"||value===null||Array.isArray(value))return;if(Object.keys(value).toSorted().join(",")!=="min_engine_version,version")return;let version=Reflect.get(value,"version"),engine=Reflect.get(value,"min_engine_version");if(typeof version!=="string"||typeof engine!=="string"||!isSemver(version)||!isSemver(engine))return;return{version,min_engine_version:engine}};import{spawnSync as spawnSync2}from"node:child_process";var P=(1n<<255n)-19n,L=(1n<<252n)+27742317777372353535851937790883648493n,mod=(n)=>{let r=n%P;return r<0n?r+P:r},power=(base,exponent)=>{let result=1n,b=mod(base);for(let n=exponent;n>0n;n>>=1n){if(n&1n)result=mod(result*b);b=mod(b*b)}return result},D=mod(-121665n*power(121666n,P-2n)),SQRT_MINUS_ONE=power(2n,(P-1n)/4n),squareN=(x,n)=>{for(let i=0;i<n;i++)x=mod(x*x);return x},sqrtPower=(z)=>{let z2=mod(z*z),z9=mod(squareN(z2,2)*z),a=mod(squareN(mod(z2*z9),1)*z9);a=mod(squareN(a,5)*a);let b=mod(squareN(a,10)*a);return b=mod(squareN(b,20)*b),a=mod(squareN(b,10)*a),b=mod(squareN(a,50)*a),b=mod(squareN(b,100)*b),a=mod(squareN(b,50)*a),mod(squareN(a,2)*z)},IDENTITY={x:0n,y:1n,z:1n,t:0n},add=(p,q)=>{let a=mod((p.y-p.x)*(q.y-q.x)),b=mod((p.y+p.x)*(q.y+q.x)),c=mod(2n*D*p.t*q.t),d=mod(2n*p.z*q.z),e=b-a,f=d-c,g=d+c,h=b+a;return{x:mod(e*f),y:mod(g*h),z:mod(f*g),t:mod(e*h)}},multiply=(point,scalar)=>{let result=IDENTITY,p=point;for(let n=scalar;n>0n;n>>=1n){if(n&1n)result=add(result,p);p=add(p,p)}return result},equal=(p,q)=>mod(p.x*q.z-q.x*p.z)===0n&&mod(p.y*q.z-q.y*p.z)===0n,littleEndian=(bytes)=>{let n=0n;for(let b of Array.from(bytes).reverse())n=n<<8n|BigInt(b);return n},decodePoint=(bytes)=>{if(bytes.length!==32)return;let encoded=littleEndian(bytes),sign=encoded>>255n,y=encoded&(1n<<255n)-1n;if(y>=P)return;let y2=mod(y*y),u=mod(y2-1n),v=mod(D*y2+1n),v3=mod(v*v*v),v7=mod(v3*v3*v),x=mod(u*v3*sqrtPower(mod(u*v7)));if(mod(v*x*x)===mod(-u))x=mod(x*SQRT_MINUS_ONE);if(mod(v*x*x)!==u)return;if(x===0n&&sign===1n)return;if((x&1n)!==sign)x=mod(-x);let point={x,y,z:1n,t:mod(x*y)};if(equal(multiply(point,8n),IDENTITY))return;return point};var keyCache=new Map,cachedPublicKey=(key)=>{let encoded=Array.from(key,(b)=>b.toString(16).padStart(2,"0")).join(""),cached=keyCache.get(encoded);if(cached!==void 0)return keyCache.delete(encoded),keyCache.set(encoded,cached),cached;let point=decodePublicKeyUncached(key);if(keyCache.size===1024){let oldest=keyCache.keys().next().value;if(oldest!==void 0)keyCache.delete(oldest)}let entry={point:point??!1};return keyCache.set(encoded,entry),entry},decodePublicKey=(key)=>{if(key.length!==32)return;let point=cachedPublicKey(key).point;return point===!1?void 0:point},decodePublicKeyUncached=(key)=>{let point=decodePoint(key);if(point===void 0||!equal(multiply(point,L),IDENTITY))return;return point},strictEd25519Key=(key)=>decodePublicKey(key)!==void 0,strictEd25519Precheck=(key,sig)=>{if(key.length!==32||sig.length!==64)return{ok:!1,refusal:"malformed"};if(decodePublicKey(key)===void 0||decodePoint(sig.subarray(0,32))===void 0||littleEndian(sig.subarray(32))>=L)return{ok:!1,refusal:"malformed"};return{ok:!0}},strictEd25519Verify=async(key,sig,msg)=>{let checked=strictEd25519Precheck(key,sig);if(!checked.ok)return checked;let aBytes=Uint8Array.from(key),signature=Uint8Array.from(sig),message=Uint8Array.from(msg),cached=cachedPublicKey(aBytes);if(cached.point===!1)throw Error("prechecked Ed25519 key lost its validated point");cached.native??=crypto.subtle.importKey("raw",aBytes,"Ed25519",!1,["verify"]).catch((error)=>{throw delete cached.native,error});let nativeKey=await cached.native;return await crypto.subtle.verify("Ed25519",nativeKey,signature,message)?{ok:!0}:{ok:!1,refusal:"signature"}};var release_key_default={alg:"Ed25519",public_keys_hex:["6c6781a91888e3e5be10d1b27466319a7d5adf2a7d2b254f4118eda9cbcb4465","ca9407b484a30ac7f09cb152455176f1e03fc6ca3446ff930bc7587215759016"]};var HEX_KEY=/^[0-9a-f]{64}$/,parseReleaseKeySet=(value)=>{if(typeof value!=="object"||value===null||Array.isArray(value))throw Error("release key: not an object");if(Object.keys(value).toSorted().join(",")!=="alg,public_keys_hex")throw Error("release key: fields must be exactly alg and public_keys_hex");let alg=Reflect.get(value,"alg"),hexes=Reflect.get(value,"public_keys_hex");if(alg!=="Ed25519")throw Error("release key: alg must be Ed25519");if(!Array.isArray(hexes))throw Error("release key: public_keys_hex must be an array");if(new Set(hexes).size!==hexes.length)throw Error("release key: public_keys_hex must not repeat a key");return hexes.map((hex)=>{if(typeof hex!=="string"||!HEX_KEY.test(hex))throw Error("release key: each public_keys_hex entry must be 64 lowercase hex characters");return hex})},DEVICE_SERVICE_RELEASE_KEYS=parseReleaseKeySet(release_key_default),verifyReleaseSignature=async(releaseKeys,signature,checksums)=>{if(releaseKeys.length===0||!releaseKeys.every((key)=>strictEd25519Key(key)))return{ok:!1,refusal:"malformed"};let verdict={ok:!1,refusal:"signature"};for(let key of releaseKeys)if(verdict=await strictEd25519Verify(key,signature,checksums),verdict.ok||verdict.refusal==="malformed")return verdict;return verdict},releaseKeySetBytes=(hexes)=>{if(hexes.length===0||new Set(hexes).size!==hexes.length||!hexes.every((hex)=>HEX_KEY.test(hex)))return;let keys=hexes.map((hex)=>new Uint8Array(Buffer.from(hex,"hex")));return keys.every((key)=>strictEd25519Key(key))?keys:void 0},DEVICE_SERVICE_SIGNING_IDENTITY={identifier:"ai.omo.device-service",team:"523JNR86LZ"},codeSignaturePasses=(path)=>{let{identifier,team}=DEVICE_SERVICE_SIGNING_IDENTITY,requirement=`identifier "${identifier}" and anchor apple generic and certificate leaf[subject.OU] = "${team}" and certificate 1[field.1.2.840.113635.100.6.2.6] exists and certificate leaf[field.1.2.840.113635.100.6.1.13] exists`,result=spawnSync2("/usr/bin/codesign",["--verify","--strict",`-R=${requirement}`,path],{stdio:"ignore",timeout:1e4});return result.error===void 0&&result.status===0};var DEVICE_SERVICE_ORIGIN="https://get.omo.dev",VERIFY_FAILED="The downloaded OmO device service failed verification and was not installed. Try again later; if it keeps failing, report it with /bug.",refuse=(refusal,action=VERIFY_FAILED)=>({ok:!1,refusal,action}),sha256=(bytes)=>createHash9("sha256").update(bytes).digest("hex"),platformSecure=process.platform==="win32"?async(path,kind)=>windowsSecureFile2(await currentUserSid())(path,kind):posixSecureFile,downloader=(fetchRelease,base)=>async(name,maxBytes)=>{let response;try{response=await fetchRelease(`${base}${name}`,{signal:AbortSignal.timeout(120000)})}catch{return"missing"}if(response.status===404)return"not_found";if(!response.ok)return"missing";if(Number(response.headers.get("content-length")??"0")>maxBytes)return"too_large";let bytes=new Uint8Array(await response.arrayBuffer());return bytes.length>maxBytes?"too_large":bytes},downloadRefusal=(download)=>download!=="too_large"?refuse("download_failed","Could not download the OmO device service. Check the connection and try again."):refuse("malformed"),install=async(options,files,binaryName)=>{let secure=options.secure??platformSecure,bin=join21(options.stateDir,"bin");for(let dir of[options.stateDir,bin])mkdirSync4(dir,{recursive:!0,mode:448}),await secure(dir,"dir");let staging=mkdtempSync(join21(bin,".staging-")),releaseDir=join21(bin,options.version);try{for(let[name,bytes]of files)writeFileSync4(join21(staging,name),bytes,{mode:384});if(chmodSync3(join21(staging,binaryName),493),options.host.startsWith("darwin-")&&!(options.verifyCodeSignature??codeSignaturePasses)(join21(staging,binaryName)))return refuse("code_signature");let previous=existsSync7(releaseDir)?`${staging}.previous`:void 0;if(previous!==void 0)renameSync4(releaseDir,previous);if(renameSync4(staging,releaseDir),previous!==void 0)rmSync4(previous,{recursive:!0,force:!0})}finally{rmSync4(staging,{recursive:!0,force:!0})}return{ok:!0,version:options.version,releaseDir,binary:join21(releaseDir,binaryName)}},acquireDeviceService=async(options)=>{refuseIfLocalOnly("device-service-core/release/acquire.ts acquireDeviceService");let keys=releaseKeySetBytes(options.releaseKeys??DEVICE_SERVICE_RELEASE_KEYS);if(keys===void 0)return refuse("release_key_invalid","This omo build carries no usable device service release key, so it cannot verify device service releases. That is a defect in this build: report it with /bug.");let get=downloader(options.fetch??globalThis.fetch,`${options.origin??DEVICE_SERVICE_ORIGIN}/${options.channel??"stable"}/device-service/${options.version}/`),[checksums,signature]=await Promise.all([get(CHECKSUMS,CHECKSUMS_MAX_BYTES),get(SIGNATURE,SIGNATURE_BYTES)]);if(checksums==="not_found"&&signature==="not_found")return refuse("not_published",`Remote devices are not available in this omo build yet: OmO device service ${options.version} has not been published.`);if(typeof checksums==="string")return downloadRefusal(checksums);if(typeof signature==="string")return downloadRefusal(signature);let verdict=await verifyReleaseSignature(keys,signature,checksums);if(!verdict.ok)return refuse(verdict.refusal);let digests=parseChecksums(checksums),binaryName=deviceServiceAssetName(options.host),manifestDigest=digests?.get(MANIFEST),binaryDigest=digests?.get(binaryName);if(manifestDigest===void 0||binaryDigest===void 0)return refuse("malformed");let[manifestBytes,binary]=await Promise.all([get(MANIFEST,MANIFEST_MAX_BYTES),get(binaryName,BINARY_MAX_BYTES)]);if(typeof manifestBytes==="string")return downloadRefusal(manifestBytes);if(typeof binary==="string")return downloadRefusal(binary);if(sha256(manifestBytes)!==manifestDigest||sha256(binary)!==binaryDigest)return refuse("checksum");let manifest=parseManifest(manifestBytes);if(manifest===void 0)return refuse("malformed");if(manifest.version!==options.version)return refuse("version_mismatch");if(compareVersions(manifest.min_engine_version,options.engineVersion)>0)return refuse("update_required",`This OmO device service needs engine ${manifest.min_engine_version} or later. Update OmO, then try again.`);return install(options,new Map([[CHECKSUMS,checksums],[SIGNATURE,signature],[MANIFEST,manifestBytes],[binaryName,binary]]),binaryName)};var INSTALL_TIMEOUT_MS=120000,runCommand=([command,...args])=>new Promise((resolve)=>{if(command===void 0)return resolve({exitCode:1,output:"no command"});let child=spawn5(command,args,{stdio:["ignore","pipe","pipe"],timeout:INSTALL_TIMEOUT_MS,windowsHide:!0}),chunks=[];child.stdout.on("data",(chunk)=>chunks.push(chunk)),child.stderr.on("data",(chunk)=>chunks.push(chunk)),child.on("error",(error)=>resolve({exitCode:1,output:error.message})),child.on("close",(code)=>resolve({exitCode:code??1,output:Buffer.concat(chunks).toString("utf8")}))}),firstLine2=(text)=>text.trim().split(/\r?\n/)[0]??"",SUPPRESSED=/"kind"\s*:\s*"install_failed".*"reason"\s*:\s*"suppress_failed"/,installDeviceService=async(options)=>{let acquired=await acquireDeviceService(options);if(!acquired.ok)return{ok:!1,state:acquired.refusal==="not_published"?"not_published":acquired.refusal==="update_required"||acquired.refusal==="release_key_invalid"?"update_required":"service_degraded",action:acquired.action};let result=await(options.run??runCommand)([acquired.binary,"install-service","--from",acquired.releaseDir]);if(result.exitCode===0)return{ok:!0};return{ok:!1,...SUPPRESSED.test(firstLine2(result.output))?{suppressed:!0}:{},state:"service_degraded",action:`The OmO device service could not be installed (${firstLine2(result.output)||`exit ${result.exitCode}`}). Try again; if it keeps failing, report it with /bug.`}};var DEVICE_SERVICE_VERSION="0.1.39";var NONE2=Symbol("none registered");var package_default={name:"omo-ai",version:"5.1.74",type:"module",description:"OmO Native - the standalone omo command with the OMO extension built in: bun add -g omo-ai",bin:{omo:"bin/omo.js"},files:["bin","plugin"],engines:{node:">=24.0.0"},scripts:{postinstall:"node bin/senpi-patch.mjs"},dependencies:{"@code-yeongyu/senpi":"2026.11.15-2"},repository:{type:"git",url:"git+https://github.com/code-yeongyu/oh-my-openagent.git"}};var isRecord5=(value)=>typeof value==="object"&&value!==null;async function accountOf(api,credentials,doFetch){if(credentials.accountId!==void 0)return credentials.accountId;refuseIfLocalOnly("omo-native/device-service-handoff.ts accountOf");let response=await doFetch(`${api}/v1/me`,{headers:{authorization:`Bearer ${credentials.accessToken}`}});if(!response.ok)throw Error(`the account read failed (${response.status})`);let body=await response.json(),id=isRecord5(body)&&isRecord5(body.account)?body.account.id:void 0;if(typeof id!=="string"||id==="")throw Error("the account read named no account");return id}function cliDeviceServiceHandoff(options){let stateDir=options.stateDir??deviceServiceStateDir(),connect=options.connect??(()=>connectDeviceService({version:package_default.version,stateDir})),doFetch=options.fetch??fetch,report=(what)=>(error)=>{options.log(`OmO device service: ${what} did not complete (${error instanceof Error?error.message:String(error)}).`)};return{adopt:async(credentials)=>{if(!existsSync8(deviceServiceEndpointPath(stateDir)))return;try{let account=await accountOf(options.api,credentials,doFetch);await handDeviceKeys({stateDir,connect,when:"always",log:options.log,credential:{device:{id:credentials.device.id,name:credentials.device.name},signingPrivateKey:credentials.signingPrivateKey,sealingPrivateKey:credentials.sealingPrivateKey,account}})}catch(error){report("handing this sign-in to it")(error)}},machineDevice:async()=>{if(!existsSync8(deviceServiceEndpointPath(stateDir)))return{kind:"absent"};let failure,service=await connectOrNotRunning(connect,(line)=>{failure=line});if(service==="not_running")return{kind:"unknown",reason:failure??"the device service endpoint is present but nothing answered",endpoint:deviceServiceEndpointPath(stateDir)};try{let status=await service.status();return status.device===null?{kind:"absent"}:{kind:"held",device:status.device}}catch(error){return{kind:"unknown",reason:error instanceof Error?error.message:String(error)}}finally{service.close()}},forget:async()=>{try{await forgetDeviceService({stateDir,connect,log:options.log})}catch(error){report("forgetting this device")(error)}}}}import{homedir as homedir7}from"node:os";import{randomBytes as randomBytes6}from"node:crypto";import{join as join22}from"node:path";function errorCode3(error){if(!(error instanceof Error)||!("code"in error))return;return typeof error.code==="string"?error.code:void 0}var SKIPPABLE_SYNC_CODES=new Set(["ENOENT","EISDIR","EPERM","EACCES","EINVAL"]);async function syncHandle(path){let handle;try{handle=await open4(path,"r")}catch(error){if(SKIPPABLE_SYNC_CODES.has(errorCode3(error)??""))return;throw error}try{await handle.sync()}catch(error){if(!SKIPPABLE_SYNC_CODES.has(errorCode3(error)??""))throw error}finally{await handle.close()}}async function syncJournalFile(path){await syncHandle(path)}async function syncJournalDirectory(dir){await syncHandle(dir)}class SyncFormatError extends Error{reason;constructor(reason,message){super(message);this.name="SyncFormatError",this.reason=reason}}var canonicalNumber=(value)=>{if(!Number.isSafeInteger(value))throw new SyncFormatError("bad_integer",`not a bounded integer: ${String(value)}`);return JSON.stringify(value)},jcsCanonical=(value)=>{if(value===null)return"null";if(typeof value==="boolean")return value?"true":"false";if(typeof value==="number")return canonicalNumber(value);if(typeof value==="string")return JSON.stringify(value);if(Array.isArray(value))return jcsArray(value);return jcsRecord(value)},jcsArray=(items)=>`[${items.map((item)=>jcsCanonical(item)).join(",")}]`,jcsRecord=(value)=>`{${Object.keys(value).sort().map((key)=>{let item=Reflect.get(value,key);return`${JSON.stringify(key)}:${jcsCanonical(item)}`}).join(",")}}`,jcsBytes=(value)=>new Uint8Array(new TextEncoder().encode(jcsCanonical(value))),B64_ALPHABET="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_",b64urlEncode=(bytes)=>{let out="";for(let i=0;i<bytes.length;i+=3){let a=bytes[i]??0,b=bytes[i+1],c=bytes[i+2];if(out+=B64_ALPHABET[a>>2]??"",out+=B64_ALPHABET[(a&3)<<4|(b??0)>>4]??"",b!==void 0)out+=B64_ALPHABET[(b&15)<<2|(c??0)>>6]??"";if(c!==void 0)out+=B64_ALPHABET[c&63]??""}return out},b64urlDecode=(text)=>{if(text.length===0||text.includes("=")||text.length%4===1)throw new SyncFormatError("bad_base64url","expected nonempty unpadded base64url");let bytes=[],acc=0,bits=0;for(let ch of text){let value=B64_ALPHABET.indexOf(ch);if(value===-1)throw new SyncFormatError("bad_base64url",`foreign character: ${ch}`);if(acc=acc<<6|value,bits+=6,bits>=8)bits-=8,bytes.push(acc>>bits&255)}if(bits>0&&(acc&(1<<bits)-1)!==0)throw new SyncFormatError("bad_base64url","nonzero trailing bits: not canonical");return new Uint8Array(bytes)},sha2562=async(bytes)=>new Uint8Array(await crypto.subtle.digest("SHA-256",bytes)),sha256B64=async(bytes)=>b64urlEncode(await sha2562(bytes)),concatBytes=(parts)=>{let total=parts.reduce((sum,part)=>sum+part.length,0),out=new Uint8Array(total),offset=0;for(let part of parts)out.set(part,offset),offset+=part.length;return out},asciiBytes=(text)=>new Uint8Array([...text].map((ch)=>ch.charCodeAt(0)&127));var hexBytes=(hex)=>{let pairs=hex.match(/../g);return Uint8Array.from((pairs??[]).map((pair)=>Number.parseInt(pair,16)))},ED25519_PKCS8_PREFIX=hexBytes("302e020100300506032b657004220420"),ED25519_SPKI_PREFIX=hexBytes("302a300506032b6570032100");var importVerifyKey=(publicKey)=>crypto.subtle.importKey("spki",concatBytes([ED25519_SPKI_PREFIX,publicKey]),"Ed25519",!1,["verify"]);var frameBytes=(context,payload)=>concatBytes([asciiBytes(context),Uint8Array.from([0]),payload]),framedPreimage=(context,payload)=>frameBytes(context,jcsBytes(payload));var verifyFramed=async(context,payload,publicKey,signature)=>{if(publicKey.length!==32||signature.length!==64)return!1;try{let key=await importVerifyKey(publicKey);return await crypto.subtle.verify("Ed25519",key,signature,framedPreimage(context,payload))}catch{return!1}},verifyFramedBytes=async(context,payload,publicKey,signature)=>{if(publicKey.length!==32||signature.length!==64)return!1;try{let key=await importVerifyKey(publicKey);return await crypto.subtle.verify("Ed25519",key,signature,frameBytes(context,payload))}catch{return!1}};var PHRASE_RECOVERY_RP_ID="omo-sync/v1/recovery-phrase",recordPreimage=(entry)=>{let link=entry.keyring_link;if(entry.kind==="keyring"&&(link===null||link===void 0))throw new SyncFormatError("missing_keyring_link","a keyring entry signs its keyring_link");return{t:"omo-sync/v1/record",account:entry.account,base_seq:entry.base_seq,digest:entry.digest,epoch:entry.epoch,link:entry.link,...entry.kind==="keyring"&&typeof link==="string"?{keyring_link:link}:{}}},entryAuthorKey=(fold,author)=>{let b64=author.kind==="recovery"?fold.registry.get(author.credential_id)?.signing_public_key:fold.members.get(author.id)?.signing_public_key;if(b64===void 0)return{ok:!1,reason:"not_member"};try{let keyBytes=b64urlDecode(b64);return keyBytes.length===32?{ok:!0,signingPublicKey:keyBytes}:{ok:!1,reason:"bad_base64url"}}catch{return{ok:!1,reason:"bad_base64url"}}},verifyEntrySignature=async(fold,entry)=>{let key=entryAuthorKey(fold,entry.author);if(!key.ok)return!1;try{return await verifyFramed("omo-sync/v1/record",recordPreimage(entry),key.signingPublicKey,b64urlDecode(entry.record_sig))}catch(error){if(error instanceof SyncFormatError)return!1;throw error}},linkDigestPair=(priorLink,digest)=>{let prior=b64urlDecode(priorLink),current=b64urlDecode(digest);return new Uint8Array([...prior,...current])};var RESERVED_RP_PREFIX="omo-sync/",PHRASE_CREDENTIAL_BYTES=16,decodesTo=(text,length)=>{try{return b64urlDecode(text).length===length}catch{return!1}},recoveryKindOf=(survivable,rpId,credentialId)=>{if(survivable==="phrase")return rpId===PHRASE_RECOVERY_RP_ID&&decodesTo(credentialId,PHRASE_CREDENTIAL_BYTES)?"phrase":null;if(survivable!=="synced"&&survivable!=="roaming")return null;return rpId.startsWith(RESERVED_RP_PREFIX)?null:survivable};var isObject3=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value),hasExactly=(value,keys)=>{let own=Object.keys(value).sort(),want=[...keys].sort();return own.length===want.length&&own.every((key,index)=>key===want[index])},text3=(value,key)=>{let field=value[key];return typeof field==="string"&&field.length>0?field:null},COMMON=["kind","account","epoch"],PRINCIPAL_KEYS=["kind","id","sealing_public_key","signing_public_key"],RECOVERY_KEYS=["credential_id","rp_id","enrollment_nonce","sealing_public_key","signing_public_key","survivable"],parsePrincipal=(value)=>{if(!isObject3(value)||!hasExactly(value,PRINCIPAL_KEYS)||value.kind!=="device")return null;let id=text3(value,"id"),sealing=text3(value,"sealing_public_key"),signing=text3(value,"signing_public_key");if(id===null||sealing===null||signing===null)return null;return{kind:"device",id,sealing_public_key:sealing,signing_public_key:signing}},readRecoveryKey=(value)=>{let credentialId=text3(value,"credential_id"),rpId=text3(value,"rp_id"),nonce=text3(value,"enrollment_nonce"),sealing=text3(value,"sealing_public_key"),signing=text3(value,"signing_public_key");if(credentialId===null||rpId===null||nonce===null||sealing===null||signing===null)return null;let kind=recoveryKindOf(value.survivable,rpId,credentialId);if(kind===null)return null;let ordered=(rp_id)=>({credential_id:credentialId,rp_id,enrollment_nonce:nonce,sealing_public_key:sealing,signing_public_key:signing});return kind==="phrase"?{...ordered(PHRASE_RECOVERY_RP_ID),survivable:kind}:{...ordered(rpId),survivable:kind}},parseGenesis=(body)=>{if(!hasExactly(body,[...COMMON,"bootstrap","custody_root","countersign","wraps_digest"]))return null;let bootstrap=body.bootstrap;if(!isObject3(bootstrap))return null;if(!hasExactly(bootstrap,["account","custody_nonce","first_device","recovery_key"]))return null;if(bootstrap.account!==body.account||text3(bootstrap,"custody_nonce")===null)return null;let firstDevice=parsePrincipal(bootstrap.first_device),recoveryValue=bootstrap.recovery_key;if(!isObject3(recoveryValue)||!hasExactly(recoveryValue,RECOVERY_KEYS))return null;let recoveryKey=readRecoveryKey(recoveryValue),custodyRoot=text3(body,"custody_root"),countersign=text3(body,"countersign"),wrapsDigest=text3(body,"wraps_digest");if(firstDevice===null||recoveryKey===null)return null;if(custodyRoot===null||countersign===null||wrapsDigest===null)return null;return{kind:"genesis",firstDevice,recoveryKey,bootstrap,custodyRoot,countersign,wrapsDigest}},parseRecoveryKeyRecord=(body)=>{if(!hasExactly(body,[...COMMON,...RECOVERY_KEYS,"countersign","wraps_digest"]))return null;let key=readRecoveryKey(body),countersign=text3(body,"countersign"),wrapsDigest=text3(body,"wraps_digest");if(key===null||countersign===null||wrapsDigest===null)return null;return{kind:"recovery-key",key,countersign,wrapsDigest}},parseApproval=(body)=>{if(!hasExactly(body,[...COMMON,"principal","wraps_digest","pairing"]))return null;let pairing=body.pairing;if(!isObject3(pairing))return null;if(!hasExactly(pairing,["commitment","joining_nonce","approver_nonce"]))return null;let principal=parsePrincipal(body.principal),wrapsDigest=text3(body,"wraps_digest"),commitment=text3(pairing,"commitment"),joiningNonce=text3(pairing,"joining_nonce");if(principal===null||wrapsDigest===null||commitment===null||joiningNonce===null)return null;if(text3(pairing,"approver_nonce")===null)return null;return{kind:"approval",principal,wrapsDigest,commitment,joiningNonce}},parseRotation=(body)=>{if(!hasExactly(body,[...COMMON,"members","wraps_digest","fork_resolution"]))return null;let fork=body.fork_resolution,forkResolution=fork===null?null:typeof fork==="number"&&Number.isSafeInteger(fork)&&fork>=1?fork:void 0;if(forkResolution===void 0)return null;let membersValue=body.members,wrapsDigest=text3(body,"wraps_digest");if(!Array.isArray(membersValue)||wrapsDigest===null)return null;let members=membersValue.map((member)=>parsePrincipal(member)),parsed=members.filter((member)=>member!==null);if(parsed.length!==members.length||parsed.length===0)return null;return{kind:"rotation",members:parsed,wrapsDigest,forkResolution}},parseJoin=(body)=>{if(!hasExactly(body,[...COMMON,"keyring_head","principal","credential_id"]))return null;let principal=parsePrincipal(body.principal),keyringHead=text3(body,"keyring_head"),credentialId=text3(body,"credential_id");if(principal===null||keyringHead===null||credentialId===null)return null;return{kind:"recovery-join",keyringHead,principal,credentialId}},parseForkResolution=(body)=>{let keys=["fork_set","evidence","continuation","state","merged_digest"],state=body.state;if(!hasExactly(body,[...COMMON,...keys])||!isObject3(state))return null;if(!hasExactly(state,["members","recovery_keys","epoch"]))return null;let{members:membersValue,recovery_keys:keysValue,epoch}=state;if(!Array.isArray(membersValue)||!Array.isArray(keysValue))return null;if(typeof epoch!=="number"||!Number.isSafeInteger(epoch)||epoch<1)return null;let members=membersValue.map((member)=>parsePrincipal(member)),recoveryKeys=keysValue.map((key)=>isObject3(key)&&hasExactly(key,RECOVERY_KEYS)?readRecoveryKey(key):null),parsedMembers=members.filter((member)=>member!==null),parsedKeys=recoveryKeys.filter((key)=>key!==null);if(parsedMembers.length!==members.length||parsedKeys.length!==recoveryKeys.length)return null;return{kind:"fork-resolution",members:parsedMembers,recoveryKeys:parsedKeys,epoch}},parseBody=(body)=>{if(typeof body.account!=="string"||!Number.isSafeInteger(body.epoch)||body.epoch<1)return null;switch(body.kind){case"genesis":return parseGenesis(body);case"recovery-key":return parseRecoveryKeyRecord(body);case"recovery-key-removed":{let credentialId=text3(body,"credential_id");if(!hasExactly(body,[...COMMON,"credential_id"])||credentialId===null)return null;return{kind:"recovery-key-removed",credentialId}}case"approval":return parseApproval(body);case"rotation":return parseRotation(body);case"recovery-join":return parseJoin(body);case"recovery-join-vetoed":{let joinDigest=text3(body,"join_digest");if(!hasExactly(body,[...COMMON,"join_digest"])||joinDigest===null)return null;return{kind:"recovery-join-vetoed",joinDigest}}case"fork-resolution":return parseForkResolution(body);default:return null}};var ANCHOR_NEXT_STEP="re-pair or recover",anchors=new WeakSet,candidates=new WeakSet,bootstraps=new WeakSet,isBootstrapAnchor=(value)=>typeof value==="object"&&value!==null&&bootstraps.has(value),isBootstrap=(value)=>bootstraps.has(value),mintBootstrap=(value)=>{let frozen=Object.freeze(value);if(bootstraps.add(frozen),!isBootstrap(frozen))throw Error("unreachable: a fresh bootstrap anchor is always registered");return frozen},principalOf=(keyring)=>({kind:"device",id:keyring.principal().id,sealing_public_key:keyring.publicKeys().sealing,signing_public_key:keyring.publicKeys().signing}),creatorAnchor=(account,keyring)=>mintBootstrap({kind:"creator",account,selfId:keyring.principal().id}),pairingAnchor=(input)=>{let approver=Object.freeze({sealing_public_key:input.approver.sealing_public_key,signing_public_key:input.approver.signing_public_key}),transcript=Object.freeze({joining_nonce:input.joiningNonce,approver_nonce:input.approverNonce});return mintBootstrap({kind:"pairing",account:input.account,self:Object.freeze(principalOf(input.keyring)),approver,transcript})};var isTrustAnchor=(value)=>typeof value==="object"&&value!==null&&anchors.has(value),isPinCandidate=(value)=>typeof value==="object"&&value!==null&&candidates.has(value),isAnchor=(value)=>anchors.has(value),isCandidate=(value)=>candidates.has(value),mintTrustAnchor=(account,genesisDigest)=>{let anchor=Object.freeze({kind:"pinned",account,genesisDigest});if(anchors.add(anchor),!isAnchor(anchor))throw Error("unreachable: a fresh trust anchor is always registered");return anchor},mintCandidate=(account,genesisDigest,pinnedBy,entry)=>{let candidate=Object.freeze({account,genesisDigest,pinnedBy,at:Object.freeze({seq:entry.seq,keyring_link:entry.keyring_link})});if(candidates.add(candidate),!isCandidate(candidate))throw Error("unreachable: a fresh pin candidate is always registered");return candidate},sameKeys=(a,b)=>a!==void 0&&a.sealing_public_key===b.sealing_public_key&&a.signing_public_key===b.signing_public_key,anchorStep=(anchor,entry,body,before,genesisDigest)=>{if(anchor.kind==="pinned"){if(body.kind!=="genesis")return{ok:!0,anchored:!1,candidate:null};if(!isTrustAnchor(anchor))return{ok:!1,reason:"untrusted_root"};if(entry.digest!==anchor.genesisDigest)return{ok:!1,reason:"untrusted_root"};return{ok:!0,anchored:!0,candidate:null}}if(!isBootstrapAnchor(anchor))return{ok:!1,reason:"untrusted_root"};if(anchor.kind==="creator"){if(body.kind!=="genesis")return{ok:!0,anchored:!1,candidate:null};return body.firstDevice.id===anchor.selfId?{ok:!0,anchored:!0,candidate:mintCandidate(anchor.account,entry.digest,"creator",entry)}:{ok:!1,reason:"anchor_mismatch"}}if(anchor.kind==="pairing"){if(body.kind!=="approval"||body.principal.id!==anchor.self.id)return{ok:!0,anchored:!1,candidate:null};let pairing=entry.body.pairing,transcript=isObject3(pairing)?pairing:{},signer=entry.author.kind==="device"?before?.members.get(entry.author.id):void 0;return sameKeys(body.principal,anchor.self)&&sameKeys(signer,anchor.approver)&&transcript.joining_nonce===anchor.transcript.joining_nonce&&transcript.approver_nonce===anchor.transcript.approver_nonce?{ok:!0,anchored:!0,candidate:mintCandidate(anchor.account,genesisDigest,"pairing",entry)}:{ok:!1,reason:"anchor_mismatch"}}let enrolled=body.kind==="genesis"?body.recoveryKey:body.kind==="recovery-key"?body.key:null;if(enrolled===null||enrolled.credential_id!==anchor.credentialId)return{ok:!0,anchored:!1,candidate:null};return sameKeys(enrolled,anchor)?{ok:!0,anchored:!0,candidate:mintCandidate(anchor.account,genesisDigest,"recovery",entry)}:{ok:!1,reason:"anchor_mismatch"}};var P2=(1n<<255n)-19n,L2=(1n<<252n)+27742317777372353535851937790883648493n,mod2=(n)=>{let r=n%P2;return r<0n?r+P2:r},power2=(base,exponent)=>{let result=1n,b=mod2(base);for(let n=exponent;n>0n;n>>=1n){if(n&1n)result=mod2(result*b);b=mod2(b*b)}return result},D2=mod2(-121665n*power2(121666n,P2-2n)),SQRT_MINUS_ONE2=power2(2n,(P2-1n)/4n),squareN2=(x,n)=>{for(let i=0;i<n;i++)x=mod2(x*x);return x},sqrtPower2=(z)=>{let z2=mod2(z*z),z9=mod2(squareN2(z2,2)*z),a=mod2(squareN2(mod2(z2*z9),1)*z9);a=mod2(squareN2(a,5)*a);let b=mod2(squareN2(a,10)*a);return b=mod2(squareN2(b,20)*b),a=mod2(squareN2(b,10)*a),b=mod2(squareN2(a,50)*a),b=mod2(squareN2(b,100)*b),a=mod2(squareN2(b,50)*a),mod2(squareN2(a,2)*z)},IDENTITY2={x:0n,y:1n,z:1n,t:0n},add2=(p,q)=>{let a=mod2((p.y-p.x)*(q.y-q.x)),b=mod2((p.y+p.x)*(q.y+q.x)),c=mod2(2n*D2*p.t*q.t),d=mod2(2n*p.z*q.z),e=b-a,f=d-c,g=d+c,h=b+a;return{x:mod2(e*f),y:mod2(g*h),z:mod2(f*g),t:mod2(e*h)}},multiply2=(point,scalar)=>{let result=IDENTITY2,p=point;for(let n=scalar;n>0n;n>>=1n){if(n&1n)result=add2(result,p);p=add2(p,p)}return result},equal2=(p,q)=>mod2(p.x*q.z-q.x*p.z)===0n&&mod2(p.y*q.z-q.y*p.z)===0n,littleEndian2=(bytes)=>{let n=0n;for(let b of Array.from(bytes).reverse())n=n<<8n|BigInt(b);return n},decodePoint2=(bytes)=>{if(bytes.length!==32)return;let encoded=littleEndian2(bytes),sign=encoded>>255n,y=encoded&(1n<<255n)-1n;if(y>=P2)return;let y2=mod2(y*y),u=mod2(y2-1n),v=mod2(D2*y2+1n),v3=mod2(v*v*v),v7=mod2(v3*v3*v),x=mod2(u*v3*sqrtPower2(mod2(u*v7)));if(mod2(v*x*x)===mod2(-u))x=mod2(x*SQRT_MINUS_ONE2);if(mod2(v*x*x)!==u)return;if(x===0n&&sign===1n)return;if((x&1n)!==sign)x=mod2(-x);let point={x,y,z:1n,t:mod2(x*y)};if(equal2(multiply2(point,8n),IDENTITY2))return;return point};var keyCache2=new Map,cachedPublicKey2=(key)=>{let encoded=Array.from(key,(b)=>b.toString(16).padStart(2,"0")).join(""),cached=keyCache2.get(encoded);if(cached!==void 0)return keyCache2.delete(encoded),keyCache2.set(encoded,cached),cached;let point=decodePublicKeyUncached2(key);if(keyCache2.size===1024){let oldest=keyCache2.keys().next().value;if(oldest!==void 0)keyCache2.delete(oldest)}let entry={point:point??!1};return keyCache2.set(encoded,entry),entry},decodePublicKey2=(key)=>{if(key.length!==32)return;let point=cachedPublicKey2(key).point;return point===!1?void 0:point},decodePublicKeyUncached2=(key)=>{let point=decodePoint2(key);if(point===void 0||!equal2(multiply2(point,L2),IDENTITY2))return;return point},strictEd25519Key2=(key)=>decodePublicKey2(key)!==void 0,strictEd25519Precheck2=(key,sig)=>{if(key.length!==32||sig.length!==64)return{ok:!1,refusal:"malformed"};if(decodePublicKey2(key)===void 0||decodePoint2(sig.subarray(0,32))===void 0||littleEndian2(sig.subarray(32))>=L2)return{ok:!1,refusal:"malformed"};return{ok:!0}};var decodeB64=(value,length)=>{if(typeof value!=="string")return null;try{let bytes=b64urlDecode(value);return length===void 0||bytes.length===length?bytes:null}catch{return null}},verifyTagged=async(context,payload,publicKey,signature)=>{let key=decodeB64(publicKey,32),sig=decodeB64(signature,64);if(key===null||sig===null||!strictEd25519Precheck2(key,sig).ok)return!1;return verifyFramedBytes(context,jcsBytes(payload),key,sig)},isStrongKeyText=(publicKey)=>{let key=decodeB64(publicKey,32);return key!==null&&strictEd25519Key2(key)},taggedHash=(context,payload)=>sha256B64(concatBytes([asciiBytes(context),Uint8Array.from([0]),jcsBytes(payload)])),deviceIdOf=async(signingPublicKey)=>{let key=decodeB64(signingPublicKey,32);if(key===null)return null;let prefix=concatBytes([asciiBytes("omo-sync/v1/device-id"),Uint8Array.from([0]),key]);return b64urlEncode((await sha2562(prefix)).subarray(0,16))},recordPayload=(fields)=>({t:"omo-sync/v1/record",account:fields.account,base_seq:fields.base_seq,digest:fields.digest,epoch:fields.epoch,link:fields.link,...fields.keyring_link===null?{}:{keyring_link:fields.keyring_link}}),authorSigningKey=(authority,author)=>author.kind==="recovery"?authority.registry.get(author.credential_id)?.signing_public_key??null:authority.members.get(author.id)?.signing_public_key??null,verifyRecordSig=(signingPublicKey,fields)=>verifyTagged("omo-sync/v1/record",recordPayload(fields),signingPublicKey,fields.record_sig);function admitSyncOperation(options,dispatch){options.signal?.throwIfAborted();let authority=options.authority;if(authority===void 0)return dispatch();return authority.signal.throwIfAborted(),authority.admit(dispatch)}function checkSyncOperation(options){admitSyncOperation(options,()=>{return})}function syncOperationSignal(options){let signals=[options.signal,options.authority?.signal].filter((signal)=>signal!==void 0);return signals.length===0?void 0:AbortSignal.any(signals)}function isSyncOperationCancelled(options,error){return options.signal?.aborted===!0||options.authority?.signal.aborted===!0||error instanceof Error&&error.name==="AbortError"}function waitSyncOperation(options,pending){let signal=syncOperationSignal(options);if(signal===void 0)return pending;return new Promise((resolve,reject)=>{let onAbort=()=>{cleanup(),reject(signal.reason)},cleanup=()=>signal.removeEventListener("abort",onAbort);if(signal.addEventListener("abort",onAbort,{once:!0}),signal.aborted)onAbort();pending.then((value)=>{cleanup();try{resolve(admitSyncOperation(options,()=>value))}catch(error){reject(error)}},(error)=>{cleanup(),reject(error)})})}var publishSyncRename=async(source,target,options)=>{let authority=options.authority;if(authority?.boundary===void 0)return rename2(source,target,(begin)=>admitSyncOperation(options,begin));let boundary=authority.boundary.bind(authority);await renameSyncWithContentionRetry(source,target,(begin)=>boundary(()=>admitSyncOperation(options,begin)))};class TrustPinError extends Error{problem;name="TrustPinError";next=ANCHOR_NEXT_STEP;constructor(problem){super(`trust pin refused: ${problem}; ${ANCHOR_NEXT_STEP}`);this.problem=problem}}var PIN_FILE="pin.json",SOURCES=new Set(["pairing","recovery","creator"]),accountKey=trustAnchorKey,rootDir=trustAnchorRoot,pinDir=trustAnchorDir,isMissing2=(error)=>error instanceof Error&&("code"in error)&&error.code==="ENOENT",alive=(pid)=>{try{return process.kill(pid,0),!0}catch(error){return error instanceof Error&&"code"in error&&error.code==="EPERM"}},cleanStaleCandidates=async(stateDir,account)=>{let prefix=`${accountKey(account)}.`,names;try{names=await readdir(rootDir(stateDir))}catch(error){if(error instanceof Error&&"code"in error&&error.code==="ENOENT")return;throw error}for(let name of names){let pid=Number(name.slice(prefix.length).split(".")[0]);if(name.startsWith(prefix)&&name.endsWith(".tmp")&&Number.isSafeInteger(pid)&&!alive(pid))await rm(join22(rootDir(stateDir),name),{recursive:!0,force:!0})}},hasExactly2=(value,keys)=>Object.keys(value).sort().join(",")===[...keys].sort().join(","),isRecord6=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value),parsePin=(raw,account)=>{let value;try{value=JSON.parse(raw)}catch{return null}if(!isRecord6(value)||!hasExactly2(value,["version","account","genesis_digest","pinned_by","pinned_at"]))return null;let at=value.pinned_at,digest=value.genesis_digest;if(value.version!==1||value.account!==account||typeof digest!=="string"||decodeB64(digest,32)===null)return null;if(typeof value.pinned_by!=="string"||!SOURCES.has(value.pinned_by))return null;if(!isRecord6(at)||!hasExactly2(at,["seq","keyring_link"])||!Number.isSafeInteger(at.seq)||Number(at.seq)<1)return null;if(typeof at.keyring_link!=="string"||decodeB64(at.keyring_link,32)===null)return null;return mintTrustAnchor(account,digest)},loadTrustAnchor=async(stateDir,account)=>{await cleanStaleCandidates(stateDir,account);let raw;try{raw=await readFile(join22(pinDir(stateDir,account),PIN_FILE),"utf8")}catch(error){if(!isMissing2(error))throw error;try{await stat(pinDir(stateDir,account))}catch(dirError){if(isMissing2(dirError))return{ok:!1,reason:"no_pin",next:ANCHOR_NEXT_STEP};throw dirError}return{ok:!1,reason:"corrupt_pin",next:ANCHOR_NEXT_STEP}}let anchor=parsePin(raw,account);return anchor===null?{ok:!1,reason:"corrupt_pin",next:ANCHOR_NEXT_STEP}:{ok:!0,anchor}},pinTrustAnchor=async(stateDir,account,candidate,operation={})=>{if(!isPinCandidate(candidate)||candidate.account!==account)throw new TrustPinError("not_verified");let existing=await loadTrustAnchor(stateDir,account);if(existing.ok){if(existing.anchor.genesisDigest===candidate.genesisDigest)return checkSyncOperation(operation),existing.anchor;throw new TrustPinError("pin_conflict")}if(existing.reason==="corrupt_pin")throw new TrustPinError("corrupt_pin");let target=pinDir(stateDir,account);await mkdir(rootDir(stateDir),{recursive:!0,mode:448});let staging=`${target}.${process.pid}.${randomBytes6(6).toString("hex")}.tmp`;await mkdir(staging,{mode:448});let pin={version:1,account,genesis_digest:candidate.genesisDigest,pinned_by:candidate.pinnedBy,pinned_at:{...candidate.at}};try{await writeFile2(join22(staging,PIN_FILE),`${JSON.stringify(pin)}
|
|
244
|
+
`)){let match=CHECKSUM_LINE.exec(line),digest=match?.[1],name=match?.[2];if(digest===void 0||name===void 0||!RELEASE_FILES.has(name)||digests.has(name))return;digests.set(name,digest)}return digests},parseManifest=(bytes)=>{let text=strictUtf8(bytes);if(text===void 0)return;let value;try{value=JSON.parse(text)}catch{return}if(typeof value!=="object"||value===null||Array.isArray(value))return;if(Object.keys(value).toSorted().join(",")!=="min_engine_version,version")return;let version=Reflect.get(value,"version"),engine=Reflect.get(value,"min_engine_version");if(typeof version!=="string"||typeof engine!=="string"||!isSemver(version)||!isSemver(engine))return;return{version,min_engine_version:engine}};import{spawnSync as spawnSync2}from"node:child_process";var P=(1n<<255n)-19n,L=(1n<<252n)+27742317777372353535851937790883648493n,mod=(n)=>{let r=n%P;return r<0n?r+P:r},power=(base,exponent)=>{let result=1n,b=mod(base);for(let n=exponent;n>0n;n>>=1n){if(n&1n)result=mod(result*b);b=mod(b*b)}return result},D=mod(-121665n*power(121666n,P-2n)),SQRT_MINUS_ONE=power(2n,(P-1n)/4n),squareN=(x,n)=>{for(let i=0;i<n;i++)x=mod(x*x);return x},sqrtPower=(z)=>{let z2=mod(z*z),z9=mod(squareN(z2,2)*z),a=mod(squareN(mod(z2*z9),1)*z9);a=mod(squareN(a,5)*a);let b=mod(squareN(a,10)*a);return b=mod(squareN(b,20)*b),a=mod(squareN(b,10)*a),b=mod(squareN(a,50)*a),b=mod(squareN(b,100)*b),a=mod(squareN(b,50)*a),mod(squareN(a,2)*z)},IDENTITY={x:0n,y:1n,z:1n,t:0n},add=(p,q)=>{let a=mod((p.y-p.x)*(q.y-q.x)),b=mod((p.y+p.x)*(q.y+q.x)),c=mod(2n*D*p.t*q.t),d=mod(2n*p.z*q.z),e=b-a,f=d-c,g=d+c,h=b+a;return{x:mod(e*f),y:mod(g*h),z:mod(f*g),t:mod(e*h)}},multiply=(point,scalar)=>{let result=IDENTITY,p=point;for(let n=scalar;n>0n;n>>=1n){if(n&1n)result=add(result,p);p=add(p,p)}return result},equal=(p,q)=>mod(p.x*q.z-q.x*p.z)===0n&&mod(p.y*q.z-q.y*p.z)===0n,littleEndian=(bytes)=>{let n=0n;for(let b of Array.from(bytes).reverse())n=n<<8n|BigInt(b);return n},decodePoint=(bytes)=>{if(bytes.length!==32)return;let encoded=littleEndian(bytes),sign=encoded>>255n,y=encoded&(1n<<255n)-1n;if(y>=P)return;let y2=mod(y*y),u=mod(y2-1n),v=mod(D*y2+1n),v3=mod(v*v*v),v7=mod(v3*v3*v),x=mod(u*v3*sqrtPower(mod(u*v7)));if(mod(v*x*x)===mod(-u))x=mod(x*SQRT_MINUS_ONE);if(mod(v*x*x)!==u)return;if(x===0n&&sign===1n)return;if((x&1n)!==sign)x=mod(-x);let point={x,y,z:1n,t:mod(x*y)};if(equal(multiply(point,8n),IDENTITY))return;return point};var keyCache=new Map,cachedPublicKey=(key)=>{let encoded=Array.from(key,(b)=>b.toString(16).padStart(2,"0")).join(""),cached=keyCache.get(encoded);if(cached!==void 0)return keyCache.delete(encoded),keyCache.set(encoded,cached),cached;let point=decodePublicKeyUncached(key);if(keyCache.size===1024){let oldest=keyCache.keys().next().value;if(oldest!==void 0)keyCache.delete(oldest)}let entry={point:point??!1};return keyCache.set(encoded,entry),entry},decodePublicKey=(key)=>{if(key.length!==32)return;let point=cachedPublicKey(key).point;return point===!1?void 0:point},decodePublicKeyUncached=(key)=>{let point=decodePoint(key);if(point===void 0||!equal(multiply(point,L),IDENTITY))return;return point},strictEd25519Key=(key)=>decodePublicKey(key)!==void 0,strictEd25519Precheck=(key,sig)=>{if(key.length!==32||sig.length!==64)return{ok:!1,refusal:"malformed"};if(decodePublicKey(key)===void 0||decodePoint(sig.subarray(0,32))===void 0||littleEndian(sig.subarray(32))>=L)return{ok:!1,refusal:"malformed"};return{ok:!0}},strictEd25519Verify=async(key,sig,msg)=>{let checked=strictEd25519Precheck(key,sig);if(!checked.ok)return checked;let aBytes=Uint8Array.from(key),signature=Uint8Array.from(sig),message=Uint8Array.from(msg),cached=cachedPublicKey(aBytes);if(cached.point===!1)throw Error("prechecked Ed25519 key lost its validated point");cached.native??=crypto.subtle.importKey("raw",aBytes,"Ed25519",!1,["verify"]).catch((error)=>{throw delete cached.native,error});let nativeKey=await cached.native;return await crypto.subtle.verify("Ed25519",nativeKey,signature,message)?{ok:!0}:{ok:!1,refusal:"signature"}};var release_key_default={alg:"Ed25519",public_keys_hex:["6c6781a91888e3e5be10d1b27466319a7d5adf2a7d2b254f4118eda9cbcb4465","ca9407b484a30ac7f09cb152455176f1e03fc6ca3446ff930bc7587215759016"]};var HEX_KEY=/^[0-9a-f]{64}$/,parseReleaseKeySet=(value)=>{if(typeof value!=="object"||value===null||Array.isArray(value))throw Error("release key: not an object");if(Object.keys(value).toSorted().join(",")!=="alg,public_keys_hex")throw Error("release key: fields must be exactly alg and public_keys_hex");let alg=Reflect.get(value,"alg"),hexes=Reflect.get(value,"public_keys_hex");if(alg!=="Ed25519")throw Error("release key: alg must be Ed25519");if(!Array.isArray(hexes))throw Error("release key: public_keys_hex must be an array");if(new Set(hexes).size!==hexes.length)throw Error("release key: public_keys_hex must not repeat a key");return hexes.map((hex)=>{if(typeof hex!=="string"||!HEX_KEY.test(hex))throw Error("release key: each public_keys_hex entry must be 64 lowercase hex characters");return hex})},DEVICE_SERVICE_RELEASE_KEYS=parseReleaseKeySet(release_key_default),verifyReleaseSignature=async(releaseKeys,signature,checksums)=>{if(releaseKeys.length===0||!releaseKeys.every((key)=>strictEd25519Key(key)))return{ok:!1,refusal:"malformed"};let verdict={ok:!1,refusal:"signature"};for(let key of releaseKeys)if(verdict=await strictEd25519Verify(key,signature,checksums),verdict.ok||verdict.refusal==="malformed")return verdict;return verdict},releaseKeySetBytes=(hexes)=>{if(hexes.length===0||new Set(hexes).size!==hexes.length||!hexes.every((hex)=>HEX_KEY.test(hex)))return;let keys=hexes.map((hex)=>new Uint8Array(Buffer.from(hex,"hex")));return keys.every((key)=>strictEd25519Key(key))?keys:void 0},DEVICE_SERVICE_SIGNING_IDENTITY={identifier:"ai.omo.device-service",team:"523JNR86LZ"},codeSignaturePasses=(path)=>{let{identifier,team}=DEVICE_SERVICE_SIGNING_IDENTITY,requirement=`identifier "${identifier}" and anchor apple generic and certificate leaf[subject.OU] = "${team}" and certificate 1[field.1.2.840.113635.100.6.2.6] exists and certificate leaf[field.1.2.840.113635.100.6.1.13] exists`,result=spawnSync2("/usr/bin/codesign",["--verify","--strict",`-R=${requirement}`,path],{stdio:"ignore",timeout:1e4});return result.error===void 0&&result.status===0};var DEVICE_SERVICE_ORIGIN="https://get.omo.dev",VERIFY_FAILED="The downloaded OmO device service failed verification and was not installed. Try again later; if it keeps failing, report it with /bug.",refuse=(refusal,action=VERIFY_FAILED)=>({ok:!1,refusal,action}),sha256=(bytes)=>createHash9("sha256").update(bytes).digest("hex"),platformSecure=process.platform==="win32"?async(path,kind)=>windowsSecureFile2(await currentUserSid())(path,kind):posixSecureFile,downloader=(fetchRelease,base)=>async(name,maxBytes)=>{let response;try{response=await fetchRelease(`${base}${name}`,{signal:AbortSignal.timeout(120000)})}catch{return"missing"}if(response.status===404)return"not_found";if(!response.ok)return"missing";if(Number(response.headers.get("content-length")??"0")>maxBytes)return"too_large";let bytes=new Uint8Array(await response.arrayBuffer());return bytes.length>maxBytes?"too_large":bytes},downloadRefusal=(download)=>download!=="too_large"?refuse("download_failed","Could not download the OmO device service. Check the connection and try again."):refuse("malformed"),install=async(options,files,binaryName)=>{let secure=options.secure??platformSecure,bin=join21(options.stateDir,"bin");for(let dir of[options.stateDir,bin])mkdirSync4(dir,{recursive:!0,mode:448}),await secure(dir,"dir");let staging=mkdtempSync(join21(bin,".staging-")),releaseDir=join21(bin,options.version);try{for(let[name,bytes]of files)writeFileSync4(join21(staging,name),bytes,{mode:384});if(chmodSync3(join21(staging,binaryName),493),options.host.startsWith("darwin-")&&!(options.verifyCodeSignature??codeSignaturePasses)(join21(staging,binaryName)))return refuse("code_signature");let previous=existsSync7(releaseDir)?`${staging}.previous`:void 0;if(previous!==void 0)renameSync4(releaseDir,previous);if(renameSync4(staging,releaseDir),previous!==void 0)rmSync4(previous,{recursive:!0,force:!0})}finally{rmSync4(staging,{recursive:!0,force:!0})}return{ok:!0,version:options.version,releaseDir,binary:join21(releaseDir,binaryName)}},acquireDeviceService=async(options)=>{refuseIfLocalOnly("device-service-core/release/acquire.ts acquireDeviceService");let keys=releaseKeySetBytes(options.releaseKeys??DEVICE_SERVICE_RELEASE_KEYS);if(keys===void 0)return refuse("release_key_invalid","This omo build carries no usable device service release key, so it cannot verify device service releases. That is a defect in this build: report it with /bug.");let get=downloader(options.fetch??globalThis.fetch,`${options.origin??DEVICE_SERVICE_ORIGIN}/${options.channel??"stable"}/device-service/${options.version}/`),[checksums,signature]=await Promise.all([get(CHECKSUMS,CHECKSUMS_MAX_BYTES),get(SIGNATURE,SIGNATURE_BYTES)]);if(checksums==="not_found"&&signature==="not_found")return refuse("not_published",`Remote devices are not available in this omo build yet: OmO device service ${options.version} has not been published.`);if(typeof checksums==="string")return downloadRefusal(checksums);if(typeof signature==="string")return downloadRefusal(signature);let verdict=await verifyReleaseSignature(keys,signature,checksums);if(!verdict.ok)return refuse(verdict.refusal);let digests=parseChecksums(checksums),binaryName=deviceServiceAssetName(options.host),manifestDigest=digests?.get(MANIFEST),binaryDigest=digests?.get(binaryName);if(manifestDigest===void 0||binaryDigest===void 0)return refuse("malformed");let[manifestBytes,binary]=await Promise.all([get(MANIFEST,MANIFEST_MAX_BYTES),get(binaryName,BINARY_MAX_BYTES)]);if(typeof manifestBytes==="string")return downloadRefusal(manifestBytes);if(typeof binary==="string")return downloadRefusal(binary);if(sha256(manifestBytes)!==manifestDigest||sha256(binary)!==binaryDigest)return refuse("checksum");let manifest=parseManifest(manifestBytes);if(manifest===void 0)return refuse("malformed");if(manifest.version!==options.version)return refuse("version_mismatch");if(compareVersions(manifest.min_engine_version,options.engineVersion)>0)return refuse("update_required",`This OmO device service needs engine ${manifest.min_engine_version} or later. Update OmO, then try again.`);return install(options,new Map([[CHECKSUMS,checksums],[SIGNATURE,signature],[MANIFEST,manifestBytes],[binaryName,binary]]),binaryName)};var INSTALL_TIMEOUT_MS=120000,runCommand=([command,...args])=>new Promise((resolve)=>{if(command===void 0)return resolve({exitCode:1,output:"no command"});let child=spawn5(command,args,{stdio:["ignore","pipe","pipe"],timeout:INSTALL_TIMEOUT_MS,windowsHide:!0}),chunks=[];child.stdout.on("data",(chunk)=>chunks.push(chunk)),child.stderr.on("data",(chunk)=>chunks.push(chunk)),child.on("error",(error)=>resolve({exitCode:1,output:error.message})),child.on("close",(code)=>resolve({exitCode:code??1,output:Buffer.concat(chunks).toString("utf8")}))}),firstLine2=(text)=>text.trim().split(/\r?\n/)[0]??"",SUPPRESSED=/"kind"\s*:\s*"install_failed".*"reason"\s*:\s*"suppress_failed"/,installDeviceService=async(options)=>{let acquired=await acquireDeviceService(options);if(!acquired.ok)return{ok:!1,state:acquired.refusal==="not_published"?"not_published":acquired.refusal==="update_required"||acquired.refusal==="release_key_invalid"?"update_required":"service_degraded",action:acquired.action};let result=await(options.run??runCommand)([acquired.binary,"install-service","--from",acquired.releaseDir]);if(result.exitCode===0)return{ok:!0};return{ok:!1,...SUPPRESSED.test(firstLine2(result.output))?{suppressed:!0}:{},state:"service_degraded",action:`The OmO device service could not be installed (${firstLine2(result.output)||`exit ${result.exitCode}`}). Try again; if it keeps failing, report it with /bug.`}};var DEVICE_SERVICE_VERSION="0.1.39";var NONE2=Symbol("none registered");var package_default={name:"omo-ai",version:"5.1.75",type:"module",description:"OmO Native - the standalone omo command with the OMO extension built in: bun add -g omo-ai",bin:{omo:"bin/omo.js"},files:["bin","plugin"],engines:{node:">=24.0.0"},scripts:{postinstall:"node bin/senpi-patch.mjs"},dependencies:{"@code-yeongyu/senpi":"2026.11.15-2"},repository:{type:"git",url:"git+https://github.com/code-yeongyu/oh-my-openagent.git"}};var isRecord5=(value)=>typeof value==="object"&&value!==null;async function accountOf(api,credentials,doFetch){if(credentials.accountId!==void 0)return credentials.accountId;refuseIfLocalOnly("omo-native/device-service-handoff.ts accountOf");let response=await doFetch(`${api}/v1/me`,{headers:{authorization:`Bearer ${credentials.accessToken}`}});if(!response.ok)throw Error(`the account read failed (${response.status})`);let body=await response.json(),id=isRecord5(body)&&isRecord5(body.account)?body.account.id:void 0;if(typeof id!=="string"||id==="")throw Error("the account read named no account");return id}function cliDeviceServiceHandoff(options){let stateDir=options.stateDir??deviceServiceStateDir(),connect=options.connect??(()=>connectDeviceService({version:package_default.version,stateDir})),doFetch=options.fetch??fetch,report=(what)=>(error)=>{options.log(`OmO device service: ${what} did not complete (${error instanceof Error?error.message:String(error)}).`)};return{adopt:async(credentials)=>{if(!existsSync8(deviceServiceEndpointPath(stateDir)))return;try{let account=await accountOf(options.api,credentials,doFetch);await handDeviceKeys({stateDir,connect,when:"always",log:options.log,credential:{device:{id:credentials.device.id,name:credentials.device.name},signingPrivateKey:credentials.signingPrivateKey,sealingPrivateKey:credentials.sealingPrivateKey,account}})}catch(error){report("handing this sign-in to it")(error)}},machineDevice:async()=>{if(!existsSync8(deviceServiceEndpointPath(stateDir)))return{kind:"absent"};let failure,service=await connectOrNotRunning(connect,(line)=>{failure=line});if(service==="not_running")return{kind:"unknown",reason:failure??"the device service endpoint is present but nothing answered",endpoint:deviceServiceEndpointPath(stateDir)};try{let status=await service.status();return status.device===null?{kind:"absent"}:{kind:"held",device:status.device}}catch(error){return{kind:"unknown",reason:error instanceof Error?error.message:String(error)}}finally{service.close()}},forget:async()=>{try{await forgetDeviceService({stateDir,connect,log:options.log})}catch(error){report("forgetting this device")(error)}}}}import{homedir as homedir7}from"node:os";import{randomBytes as randomBytes6}from"node:crypto";import{join as join22}from"node:path";function errorCode3(error){if(!(error instanceof Error)||!("code"in error))return;return typeof error.code==="string"?error.code:void 0}var SKIPPABLE_SYNC_CODES=new Set(["ENOENT","EISDIR","EPERM","EACCES","EINVAL"]);async function syncHandle(path){let handle;try{handle=await open4(path,"r")}catch(error){if(SKIPPABLE_SYNC_CODES.has(errorCode3(error)??""))return;throw error}try{await handle.sync()}catch(error){if(!SKIPPABLE_SYNC_CODES.has(errorCode3(error)??""))throw error}finally{await handle.close()}}async function syncJournalFile(path){await syncHandle(path)}async function syncJournalDirectory(dir){await syncHandle(dir)}class SyncFormatError extends Error{reason;constructor(reason,message){super(message);this.name="SyncFormatError",this.reason=reason}}var canonicalNumber=(value)=>{if(!Number.isSafeInteger(value))throw new SyncFormatError("bad_integer",`not a bounded integer: ${String(value)}`);return JSON.stringify(value)},jcsCanonical=(value)=>{if(value===null)return"null";if(typeof value==="boolean")return value?"true":"false";if(typeof value==="number")return canonicalNumber(value);if(typeof value==="string")return JSON.stringify(value);if(Array.isArray(value))return jcsArray(value);return jcsRecord(value)},jcsArray=(items)=>`[${items.map((item)=>jcsCanonical(item)).join(",")}]`,jcsRecord=(value)=>`{${Object.keys(value).sort().map((key)=>{let item=Reflect.get(value,key);return`${JSON.stringify(key)}:${jcsCanonical(item)}`}).join(",")}}`,jcsBytes=(value)=>new Uint8Array(new TextEncoder().encode(jcsCanonical(value))),B64_ALPHABET="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_",b64urlEncode=(bytes)=>{let out="";for(let i=0;i<bytes.length;i+=3){let a=bytes[i]??0,b=bytes[i+1],c=bytes[i+2];if(out+=B64_ALPHABET[a>>2]??"",out+=B64_ALPHABET[(a&3)<<4|(b??0)>>4]??"",b!==void 0)out+=B64_ALPHABET[(b&15)<<2|(c??0)>>6]??"";if(c!==void 0)out+=B64_ALPHABET[c&63]??""}return out},b64urlDecode=(text)=>{if(text.length===0||text.includes("=")||text.length%4===1)throw new SyncFormatError("bad_base64url","expected nonempty unpadded base64url");let bytes=[],acc=0,bits=0;for(let ch of text){let value=B64_ALPHABET.indexOf(ch);if(value===-1)throw new SyncFormatError("bad_base64url",`foreign character: ${ch}`);if(acc=acc<<6|value,bits+=6,bits>=8)bits-=8,bytes.push(acc>>bits&255)}if(bits>0&&(acc&(1<<bits)-1)!==0)throw new SyncFormatError("bad_base64url","nonzero trailing bits: not canonical");return new Uint8Array(bytes)},sha2562=async(bytes)=>new Uint8Array(await crypto.subtle.digest("SHA-256",bytes)),sha256B64=async(bytes)=>b64urlEncode(await sha2562(bytes)),concatBytes=(parts)=>{let total=parts.reduce((sum,part)=>sum+part.length,0),out=new Uint8Array(total),offset=0;for(let part of parts)out.set(part,offset),offset+=part.length;return out},asciiBytes=(text)=>new Uint8Array([...text].map((ch)=>ch.charCodeAt(0)&127));var hexBytes=(hex)=>{let pairs=hex.match(/../g);return Uint8Array.from((pairs??[]).map((pair)=>Number.parseInt(pair,16)))},ED25519_PKCS8_PREFIX=hexBytes("302e020100300506032b657004220420"),ED25519_SPKI_PREFIX=hexBytes("302a300506032b6570032100");var importVerifyKey=(publicKey)=>crypto.subtle.importKey("spki",concatBytes([ED25519_SPKI_PREFIX,publicKey]),"Ed25519",!1,["verify"]);var frameBytes=(context,payload)=>concatBytes([asciiBytes(context),Uint8Array.from([0]),payload]),framedPreimage=(context,payload)=>frameBytes(context,jcsBytes(payload));var verifyFramed=async(context,payload,publicKey,signature)=>{if(publicKey.length!==32||signature.length!==64)return!1;try{let key=await importVerifyKey(publicKey);return await crypto.subtle.verify("Ed25519",key,signature,framedPreimage(context,payload))}catch{return!1}},verifyFramedBytes=async(context,payload,publicKey,signature)=>{if(publicKey.length!==32||signature.length!==64)return!1;try{let key=await importVerifyKey(publicKey);return await crypto.subtle.verify("Ed25519",key,signature,frameBytes(context,payload))}catch{return!1}};var PHRASE_RECOVERY_RP_ID="omo-sync/v1/recovery-phrase",recordPreimage=(entry)=>{let link=entry.keyring_link;if(entry.kind==="keyring"&&(link===null||link===void 0))throw new SyncFormatError("missing_keyring_link","a keyring entry signs its keyring_link");return{t:"omo-sync/v1/record",account:entry.account,base_seq:entry.base_seq,digest:entry.digest,epoch:entry.epoch,link:entry.link,...entry.kind==="keyring"&&typeof link==="string"?{keyring_link:link}:{}}},entryAuthorKey=(fold,author)=>{let b64=author.kind==="recovery"?fold.registry.get(author.credential_id)?.signing_public_key:fold.members.get(author.id)?.signing_public_key;if(b64===void 0)return{ok:!1,reason:"not_member"};try{let keyBytes=b64urlDecode(b64);return keyBytes.length===32?{ok:!0,signingPublicKey:keyBytes}:{ok:!1,reason:"bad_base64url"}}catch{return{ok:!1,reason:"bad_base64url"}}},verifyEntrySignature=async(fold,entry)=>{let key=entryAuthorKey(fold,entry.author);if(!key.ok)return!1;try{return await verifyFramed("omo-sync/v1/record",recordPreimage(entry),key.signingPublicKey,b64urlDecode(entry.record_sig))}catch(error){if(error instanceof SyncFormatError)return!1;throw error}},linkDigestPair=(priorLink,digest)=>{let prior=b64urlDecode(priorLink),current=b64urlDecode(digest);return new Uint8Array([...prior,...current])};var RESERVED_RP_PREFIX="omo-sync/",PHRASE_CREDENTIAL_BYTES=16,decodesTo=(text,length)=>{try{return b64urlDecode(text).length===length}catch{return!1}},recoveryKindOf=(survivable,rpId,credentialId)=>{if(survivable==="phrase")return rpId===PHRASE_RECOVERY_RP_ID&&decodesTo(credentialId,PHRASE_CREDENTIAL_BYTES)?"phrase":null;if(survivable!=="synced"&&survivable!=="roaming")return null;return rpId.startsWith(RESERVED_RP_PREFIX)?null:survivable};var isObject3=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value),hasExactly=(value,keys)=>{let own=Object.keys(value).sort(),want=[...keys].sort();return own.length===want.length&&own.every((key,index)=>key===want[index])},text3=(value,key)=>{let field=value[key];return typeof field==="string"&&field.length>0?field:null},COMMON=["kind","account","epoch"],PRINCIPAL_KEYS=["kind","id","sealing_public_key","signing_public_key"],RECOVERY_KEYS=["credential_id","rp_id","enrollment_nonce","sealing_public_key","signing_public_key","survivable"],parsePrincipal=(value)=>{if(!isObject3(value)||!hasExactly(value,PRINCIPAL_KEYS)||value.kind!=="device")return null;let id=text3(value,"id"),sealing=text3(value,"sealing_public_key"),signing=text3(value,"signing_public_key");if(id===null||sealing===null||signing===null)return null;return{kind:"device",id,sealing_public_key:sealing,signing_public_key:signing}},readRecoveryKey=(value)=>{let credentialId=text3(value,"credential_id"),rpId=text3(value,"rp_id"),nonce=text3(value,"enrollment_nonce"),sealing=text3(value,"sealing_public_key"),signing=text3(value,"signing_public_key");if(credentialId===null||rpId===null||nonce===null||sealing===null||signing===null)return null;let kind=recoveryKindOf(value.survivable,rpId,credentialId);if(kind===null)return null;let ordered=(rp_id)=>({credential_id:credentialId,rp_id,enrollment_nonce:nonce,sealing_public_key:sealing,signing_public_key:signing});return kind==="phrase"?{...ordered(PHRASE_RECOVERY_RP_ID),survivable:kind}:{...ordered(rpId),survivable:kind}},parseGenesis=(body)=>{if(!hasExactly(body,[...COMMON,"bootstrap","custody_root","countersign","wraps_digest"]))return null;let bootstrap=body.bootstrap;if(!isObject3(bootstrap))return null;if(!hasExactly(bootstrap,["account","custody_nonce","first_device","recovery_key"]))return null;if(bootstrap.account!==body.account||text3(bootstrap,"custody_nonce")===null)return null;let firstDevice=parsePrincipal(bootstrap.first_device),recoveryValue=bootstrap.recovery_key;if(!isObject3(recoveryValue)||!hasExactly(recoveryValue,RECOVERY_KEYS))return null;let recoveryKey=readRecoveryKey(recoveryValue),custodyRoot=text3(body,"custody_root"),countersign=text3(body,"countersign"),wrapsDigest=text3(body,"wraps_digest");if(firstDevice===null||recoveryKey===null)return null;if(custodyRoot===null||countersign===null||wrapsDigest===null)return null;return{kind:"genesis",firstDevice,recoveryKey,bootstrap,custodyRoot,countersign,wrapsDigest}},parseRecoveryKeyRecord=(body)=>{if(!hasExactly(body,[...COMMON,...RECOVERY_KEYS,"countersign","wraps_digest"]))return null;let key=readRecoveryKey(body),countersign=text3(body,"countersign"),wrapsDigest=text3(body,"wraps_digest");if(key===null||countersign===null||wrapsDigest===null)return null;return{kind:"recovery-key",key,countersign,wrapsDigest}},parseApproval=(body)=>{if(!hasExactly(body,[...COMMON,"principal","wraps_digest","pairing"]))return null;let pairing=body.pairing;if(!isObject3(pairing))return null;if(!hasExactly(pairing,["commitment","joining_nonce","approver_nonce"]))return null;let principal=parsePrincipal(body.principal),wrapsDigest=text3(body,"wraps_digest"),commitment=text3(pairing,"commitment"),joiningNonce=text3(pairing,"joining_nonce");if(principal===null||wrapsDigest===null||commitment===null||joiningNonce===null)return null;if(text3(pairing,"approver_nonce")===null)return null;return{kind:"approval",principal,wrapsDigest,commitment,joiningNonce}},parseRotation=(body)=>{if(!hasExactly(body,[...COMMON,"members","wraps_digest","fork_resolution"]))return null;let fork=body.fork_resolution,forkResolution=fork===null?null:typeof fork==="number"&&Number.isSafeInteger(fork)&&fork>=1?fork:void 0;if(forkResolution===void 0)return null;let membersValue=body.members,wrapsDigest=text3(body,"wraps_digest");if(!Array.isArray(membersValue)||wrapsDigest===null)return null;let members=membersValue.map((member)=>parsePrincipal(member)),parsed=members.filter((member)=>member!==null);if(parsed.length!==members.length||parsed.length===0)return null;return{kind:"rotation",members:parsed,wrapsDigest,forkResolution}},parseJoin=(body)=>{if(!hasExactly(body,[...COMMON,"keyring_head","principal","credential_id"]))return null;let principal=parsePrincipal(body.principal),keyringHead=text3(body,"keyring_head"),credentialId=text3(body,"credential_id");if(principal===null||keyringHead===null||credentialId===null)return null;return{kind:"recovery-join",keyringHead,principal,credentialId}},parseForkResolution=(body)=>{let keys=["fork_set","evidence","continuation","state","merged_digest"],state=body.state;if(!hasExactly(body,[...COMMON,...keys])||!isObject3(state))return null;if(!hasExactly(state,["members","recovery_keys","epoch"]))return null;let{members:membersValue,recovery_keys:keysValue,epoch}=state;if(!Array.isArray(membersValue)||!Array.isArray(keysValue))return null;if(typeof epoch!=="number"||!Number.isSafeInteger(epoch)||epoch<1)return null;let members=membersValue.map((member)=>parsePrincipal(member)),recoveryKeys=keysValue.map((key)=>isObject3(key)&&hasExactly(key,RECOVERY_KEYS)?readRecoveryKey(key):null),parsedMembers=members.filter((member)=>member!==null),parsedKeys=recoveryKeys.filter((key)=>key!==null);if(parsedMembers.length!==members.length||parsedKeys.length!==recoveryKeys.length)return null;return{kind:"fork-resolution",members:parsedMembers,recoveryKeys:parsedKeys,epoch}},parseBody=(body)=>{if(typeof body.account!=="string"||!Number.isSafeInteger(body.epoch)||body.epoch<1)return null;switch(body.kind){case"genesis":return parseGenesis(body);case"recovery-key":return parseRecoveryKeyRecord(body);case"recovery-key-removed":{let credentialId=text3(body,"credential_id");if(!hasExactly(body,[...COMMON,"credential_id"])||credentialId===null)return null;return{kind:"recovery-key-removed",credentialId}}case"approval":return parseApproval(body);case"rotation":return parseRotation(body);case"recovery-join":return parseJoin(body);case"recovery-join-vetoed":{let joinDigest=text3(body,"join_digest");if(!hasExactly(body,[...COMMON,"join_digest"])||joinDigest===null)return null;return{kind:"recovery-join-vetoed",joinDigest}}case"fork-resolution":return parseForkResolution(body);default:return null}};var ANCHOR_NEXT_STEP="re-pair or recover",anchors=new WeakSet,candidates=new WeakSet,bootstraps=new WeakSet,isBootstrapAnchor=(value)=>typeof value==="object"&&value!==null&&bootstraps.has(value),isBootstrap=(value)=>bootstraps.has(value),mintBootstrap=(value)=>{let frozen=Object.freeze(value);if(bootstraps.add(frozen),!isBootstrap(frozen))throw Error("unreachable: a fresh bootstrap anchor is always registered");return frozen},principalOf=(keyring)=>({kind:"device",id:keyring.principal().id,sealing_public_key:keyring.publicKeys().sealing,signing_public_key:keyring.publicKeys().signing}),creatorAnchor=(account,keyring)=>mintBootstrap({kind:"creator",account,selfId:keyring.principal().id}),pairingAnchor=(input)=>{let approver=Object.freeze({sealing_public_key:input.approver.sealing_public_key,signing_public_key:input.approver.signing_public_key}),transcript=Object.freeze({joining_nonce:input.joiningNonce,approver_nonce:input.approverNonce});return mintBootstrap({kind:"pairing",account:input.account,self:Object.freeze(principalOf(input.keyring)),approver,transcript})};var isTrustAnchor=(value)=>typeof value==="object"&&value!==null&&anchors.has(value),isPinCandidate=(value)=>typeof value==="object"&&value!==null&&candidates.has(value),isAnchor=(value)=>anchors.has(value),isCandidate=(value)=>candidates.has(value),mintTrustAnchor=(account,genesisDigest)=>{let anchor=Object.freeze({kind:"pinned",account,genesisDigest});if(anchors.add(anchor),!isAnchor(anchor))throw Error("unreachable: a fresh trust anchor is always registered");return anchor},mintCandidate=(account,genesisDigest,pinnedBy,entry)=>{let candidate=Object.freeze({account,genesisDigest,pinnedBy,at:Object.freeze({seq:entry.seq,keyring_link:entry.keyring_link})});if(candidates.add(candidate),!isCandidate(candidate))throw Error("unreachable: a fresh pin candidate is always registered");return candidate},sameKeys=(a,b)=>a!==void 0&&a.sealing_public_key===b.sealing_public_key&&a.signing_public_key===b.signing_public_key,anchorStep=(anchor,entry,body,before,genesisDigest)=>{if(anchor.kind==="pinned"){if(body.kind!=="genesis")return{ok:!0,anchored:!1,candidate:null};if(!isTrustAnchor(anchor))return{ok:!1,reason:"untrusted_root"};if(entry.digest!==anchor.genesisDigest)return{ok:!1,reason:"untrusted_root"};return{ok:!0,anchored:!0,candidate:null}}if(!isBootstrapAnchor(anchor))return{ok:!1,reason:"untrusted_root"};if(anchor.kind==="creator"){if(body.kind!=="genesis")return{ok:!0,anchored:!1,candidate:null};return body.firstDevice.id===anchor.selfId?{ok:!0,anchored:!0,candidate:mintCandidate(anchor.account,entry.digest,"creator",entry)}:{ok:!1,reason:"anchor_mismatch"}}if(anchor.kind==="pairing"){if(body.kind!=="approval"||body.principal.id!==anchor.self.id)return{ok:!0,anchored:!1,candidate:null};let pairing=entry.body.pairing,transcript=isObject3(pairing)?pairing:{},signer=entry.author.kind==="device"?before?.members.get(entry.author.id):void 0;return sameKeys(body.principal,anchor.self)&&sameKeys(signer,anchor.approver)&&transcript.joining_nonce===anchor.transcript.joining_nonce&&transcript.approver_nonce===anchor.transcript.approver_nonce?{ok:!0,anchored:!0,candidate:mintCandidate(anchor.account,genesisDigest,"pairing",entry)}:{ok:!1,reason:"anchor_mismatch"}}let enrolled=body.kind==="genesis"?body.recoveryKey:body.kind==="recovery-key"?body.key:null;if(enrolled===null||enrolled.credential_id!==anchor.credentialId)return{ok:!0,anchored:!1,candidate:null};return sameKeys(enrolled,anchor)?{ok:!0,anchored:!0,candidate:mintCandidate(anchor.account,genesisDigest,"recovery",entry)}:{ok:!1,reason:"anchor_mismatch"}};var P2=(1n<<255n)-19n,L2=(1n<<252n)+27742317777372353535851937790883648493n,mod2=(n)=>{let r=n%P2;return r<0n?r+P2:r},power2=(base,exponent)=>{let result=1n,b=mod2(base);for(let n=exponent;n>0n;n>>=1n){if(n&1n)result=mod2(result*b);b=mod2(b*b)}return result},D2=mod2(-121665n*power2(121666n,P2-2n)),SQRT_MINUS_ONE2=power2(2n,(P2-1n)/4n),squareN2=(x,n)=>{for(let i=0;i<n;i++)x=mod2(x*x);return x},sqrtPower2=(z)=>{let z2=mod2(z*z),z9=mod2(squareN2(z2,2)*z),a=mod2(squareN2(mod2(z2*z9),1)*z9);a=mod2(squareN2(a,5)*a);let b=mod2(squareN2(a,10)*a);return b=mod2(squareN2(b,20)*b),a=mod2(squareN2(b,10)*a),b=mod2(squareN2(a,50)*a),b=mod2(squareN2(b,100)*b),a=mod2(squareN2(b,50)*a),mod2(squareN2(a,2)*z)},IDENTITY2={x:0n,y:1n,z:1n,t:0n},add2=(p,q)=>{let a=mod2((p.y-p.x)*(q.y-q.x)),b=mod2((p.y+p.x)*(q.y+q.x)),c=mod2(2n*D2*p.t*q.t),d=mod2(2n*p.z*q.z),e=b-a,f=d-c,g=d+c,h=b+a;return{x:mod2(e*f),y:mod2(g*h),z:mod2(f*g),t:mod2(e*h)}},multiply2=(point,scalar)=>{let result=IDENTITY2,p=point;for(let n=scalar;n>0n;n>>=1n){if(n&1n)result=add2(result,p);p=add2(p,p)}return result},equal2=(p,q)=>mod2(p.x*q.z-q.x*p.z)===0n&&mod2(p.y*q.z-q.y*p.z)===0n,littleEndian2=(bytes)=>{let n=0n;for(let b of Array.from(bytes).reverse())n=n<<8n|BigInt(b);return n},decodePoint2=(bytes)=>{if(bytes.length!==32)return;let encoded=littleEndian2(bytes),sign=encoded>>255n,y=encoded&(1n<<255n)-1n;if(y>=P2)return;let y2=mod2(y*y),u=mod2(y2-1n),v=mod2(D2*y2+1n),v3=mod2(v*v*v),v7=mod2(v3*v3*v),x=mod2(u*v3*sqrtPower2(mod2(u*v7)));if(mod2(v*x*x)===mod2(-u))x=mod2(x*SQRT_MINUS_ONE2);if(mod2(v*x*x)!==u)return;if(x===0n&&sign===1n)return;if((x&1n)!==sign)x=mod2(-x);let point={x,y,z:1n,t:mod2(x*y)};if(equal2(multiply2(point,8n),IDENTITY2))return;return point};var keyCache2=new Map,cachedPublicKey2=(key)=>{let encoded=Array.from(key,(b)=>b.toString(16).padStart(2,"0")).join(""),cached=keyCache2.get(encoded);if(cached!==void 0)return keyCache2.delete(encoded),keyCache2.set(encoded,cached),cached;let point=decodePublicKeyUncached2(key);if(keyCache2.size===1024){let oldest=keyCache2.keys().next().value;if(oldest!==void 0)keyCache2.delete(oldest)}let entry={point:point??!1};return keyCache2.set(encoded,entry),entry},decodePublicKey2=(key)=>{if(key.length!==32)return;let point=cachedPublicKey2(key).point;return point===!1?void 0:point},decodePublicKeyUncached2=(key)=>{let point=decodePoint2(key);if(point===void 0||!equal2(multiply2(point,L2),IDENTITY2))return;return point},strictEd25519Key2=(key)=>decodePublicKey2(key)!==void 0,strictEd25519Precheck2=(key,sig)=>{if(key.length!==32||sig.length!==64)return{ok:!1,refusal:"malformed"};if(decodePublicKey2(key)===void 0||decodePoint2(sig.subarray(0,32))===void 0||littleEndian2(sig.subarray(32))>=L2)return{ok:!1,refusal:"malformed"};return{ok:!0}};var decodeB64=(value,length)=>{if(typeof value!=="string")return null;try{let bytes=b64urlDecode(value);return length===void 0||bytes.length===length?bytes:null}catch{return null}},verifyTagged=async(context,payload,publicKey,signature)=>{let key=decodeB64(publicKey,32),sig=decodeB64(signature,64);if(key===null||sig===null||!strictEd25519Precheck2(key,sig).ok)return!1;return verifyFramedBytes(context,jcsBytes(payload),key,sig)},isStrongKeyText=(publicKey)=>{let key=decodeB64(publicKey,32);return key!==null&&strictEd25519Key2(key)},taggedHash=(context,payload)=>sha256B64(concatBytes([asciiBytes(context),Uint8Array.from([0]),jcsBytes(payload)])),deviceIdOf=async(signingPublicKey)=>{let key=decodeB64(signingPublicKey,32);if(key===null)return null;let prefix=concatBytes([asciiBytes("omo-sync/v1/device-id"),Uint8Array.from([0]),key]);return b64urlEncode((await sha2562(prefix)).subarray(0,16))},recordPayload=(fields)=>({t:"omo-sync/v1/record",account:fields.account,base_seq:fields.base_seq,digest:fields.digest,epoch:fields.epoch,link:fields.link,...fields.keyring_link===null?{}:{keyring_link:fields.keyring_link}}),authorSigningKey=(authority,author)=>author.kind==="recovery"?authority.registry.get(author.credential_id)?.signing_public_key??null:authority.members.get(author.id)?.signing_public_key??null,verifyRecordSig=(signingPublicKey,fields)=>verifyTagged("omo-sync/v1/record",recordPayload(fields),signingPublicKey,fields.record_sig);function admitSyncOperation(options,dispatch){options.signal?.throwIfAborted();let authority=options.authority;if(authority===void 0)return dispatch();return authority.signal.throwIfAborted(),authority.admit(dispatch)}function checkSyncOperation(options){admitSyncOperation(options,()=>{return})}function syncOperationSignal(options){let signals=[options.signal,options.authority?.signal].filter((signal)=>signal!==void 0);return signals.length===0?void 0:AbortSignal.any(signals)}function isSyncOperationCancelled(options,error){return options.signal?.aborted===!0||options.authority?.signal.aborted===!0||error instanceof Error&&error.name==="AbortError"}function waitSyncOperation(options,pending){let signal=syncOperationSignal(options);if(signal===void 0)return pending;return new Promise((resolve,reject)=>{let onAbort=()=>{cleanup(),reject(signal.reason)},cleanup=()=>signal.removeEventListener("abort",onAbort);if(signal.addEventListener("abort",onAbort,{once:!0}),signal.aborted)onAbort();pending.then((value)=>{cleanup();try{resolve(admitSyncOperation(options,()=>value))}catch(error){reject(error)}},(error)=>{cleanup(),reject(error)})})}var publishSyncRename=async(source,target,options)=>{let authority=options.authority;if(authority?.boundary===void 0)return rename2(source,target,(begin)=>admitSyncOperation(options,begin));let boundary=authority.boundary.bind(authority);await renameSyncWithContentionRetry(source,target,(begin)=>boundary(()=>admitSyncOperation(options,begin)))};class TrustPinError extends Error{problem;name="TrustPinError";next=ANCHOR_NEXT_STEP;constructor(problem){super(`trust pin refused: ${problem}; ${ANCHOR_NEXT_STEP}`);this.problem=problem}}var PIN_FILE="pin.json",SOURCES=new Set(["pairing","recovery","creator"]),accountKey=trustAnchorKey,rootDir=trustAnchorRoot,pinDir=trustAnchorDir,isMissing2=(error)=>error instanceof Error&&("code"in error)&&error.code==="ENOENT",alive=(pid)=>{try{return process.kill(pid,0),!0}catch(error){return error instanceof Error&&"code"in error&&error.code==="EPERM"}},cleanStaleCandidates=async(stateDir,account)=>{let prefix=`${accountKey(account)}.`,names;try{names=await readdir(rootDir(stateDir))}catch(error){if(error instanceof Error&&"code"in error&&error.code==="ENOENT")return;throw error}for(let name of names){let pid=Number(name.slice(prefix.length).split(".")[0]);if(name.startsWith(prefix)&&name.endsWith(".tmp")&&Number.isSafeInteger(pid)&&!alive(pid))await rm(join22(rootDir(stateDir),name),{recursive:!0,force:!0})}},hasExactly2=(value,keys)=>Object.keys(value).sort().join(",")===[...keys].sort().join(","),isRecord6=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value),parsePin=(raw,account)=>{let value;try{value=JSON.parse(raw)}catch{return null}if(!isRecord6(value)||!hasExactly2(value,["version","account","genesis_digest","pinned_by","pinned_at"]))return null;let at=value.pinned_at,digest=value.genesis_digest;if(value.version!==1||value.account!==account||typeof digest!=="string"||decodeB64(digest,32)===null)return null;if(typeof value.pinned_by!=="string"||!SOURCES.has(value.pinned_by))return null;if(!isRecord6(at)||!hasExactly2(at,["seq","keyring_link"])||!Number.isSafeInteger(at.seq)||Number(at.seq)<1)return null;if(typeof at.keyring_link!=="string"||decodeB64(at.keyring_link,32)===null)return null;return mintTrustAnchor(account,digest)},loadTrustAnchor=async(stateDir,account)=>{await cleanStaleCandidates(stateDir,account);let raw;try{raw=await readFile(join22(pinDir(stateDir,account),PIN_FILE),"utf8")}catch(error){if(!isMissing2(error))throw error;try{await stat(pinDir(stateDir,account))}catch(dirError){if(isMissing2(dirError))return{ok:!1,reason:"no_pin",next:ANCHOR_NEXT_STEP};throw dirError}return{ok:!1,reason:"corrupt_pin",next:ANCHOR_NEXT_STEP}}let anchor=parsePin(raw,account);return anchor===null?{ok:!1,reason:"corrupt_pin",next:ANCHOR_NEXT_STEP}:{ok:!0,anchor}},pinTrustAnchor=async(stateDir,account,candidate,operation={})=>{if(!isPinCandidate(candidate)||candidate.account!==account)throw new TrustPinError("not_verified");let existing=await loadTrustAnchor(stateDir,account);if(existing.ok){if(existing.anchor.genesisDigest===candidate.genesisDigest)return checkSyncOperation(operation),existing.anchor;throw new TrustPinError("pin_conflict")}if(existing.reason==="corrupt_pin")throw new TrustPinError("corrupt_pin");let target=pinDir(stateDir,account);await mkdir(rootDir(stateDir),{recursive:!0,mode:448});let staging=`${target}.${process.pid}.${randomBytes6(6).toString("hex")}.tmp`;await mkdir(staging,{mode:448});let pin={version:1,account,genesis_digest:candidate.genesisDigest,pinned_by:candidate.pinnedBy,pinned_at:{...candidate.at}};try{await writeFile2(join22(staging,PIN_FILE),`${JSON.stringify(pin)}
|
|
245
245
|
`,{flag:"wx",mode:384}),await syncJournalFile(join22(staging,PIN_FILE)),await syncJournalDirectory(staging);try{await publishSyncRename(staging,target,operation)}catch(error){if(isSyncOperationCancelled(operation,error))throw error;if(checkSyncOperation(operation),!(await loadTrustAnchor(stateDir,account)).ok)throw error}}finally{await rm(staging,{recursive:!0,force:!0})}await syncJournalDirectory(rootDir(stateDir));let written=await loadTrustAnchor(stateDir,account);if(!written.ok||written.anchor.genesisDigest!==candidate.genesisDigest)throw new TrustPinError("pin_conflict");return checkSyncOperation(operation),written.anchor};var newestRetiredRoot=async(stateDir,account)=>{let prefix=`${accountKey(account)}.retired-`,names;try{names=await readdir(rootDir(stateDir))}catch(error){if(isMissing2(error))return null;throw error}let stamp=(name)=>Number(name.slice(prefix.length).split("-")[0]),retired=names.filter((name)=>name.startsWith(prefix)&&Number.isSafeInteger(stamp(name))).sort((a,b)=>stamp(b)-stamp(a));for(let name of retired){let raw=await readFile(join22(rootDir(stateDir),name,PIN_FILE),"utf8").catch(()=>null),anchor=raw===null?null:parsePin(raw,account);if(anchor!==null)return anchor.genesisDigest}return null},rootChangedSinceRetired=async(stateDir,account,genesisDigest)=>{let retired=await newestRetiredRoot(stateDir,account);return retired!==null&&retired!==genesisDigest};var ACCOUNT_EXIT={ok:0,failed:1,invalid:2,conflict:3,signedOut:4,ended:5,uncertain:6,keychainLocked:7,keychainUnavailable:8,storeUnavailable:9,loggedOut:10},deviceOf=(credentials)=>({id:credentials.device.id,name:credentials.device.name}),reply=(dependencies,value,code=ACCOUNT_EXIT.ok)=>(dependencies.output(JSON.stringify(value)),code);async function syncStateOf(pinDir,account){let pin=await loadTrustAnchor(pinDir,account);if(pin.ok)return"joined";return pin.reason==="corrupt_pin"?"corrupt_pin":"not_joined"}var accountSignedOutMarker=(dependencies)=>readSignedOutMarker(signedOutMarkerPath(dependencies.home??homedir7(),credentialId(dependencies.api)));async function showAccount(dependencies,flags){let current=await dependencies.store.read(),accountAt=flags.indexOf("--account"),account=accountAt===-1?void 0:flags[accountAt+1];if(accountAt!==-1&&(account===void 0||account===""))return dependencies.error("omo account show: --account needs an account id"),ACCOUNT_EXIT.invalid;let sync=account===void 0?{}:{sync:await syncStateOf(dependencies.pinDir(),account)},marker=current===null?await accountSignedOutMarker(dependencies):null;return reply(dependencies,current===null?{signedIn:!1,...marker===null?{}:{signedOut:marker},...sync}:{signedIn:!0,device:deviceOf(current),refreshState:current.refreshState??"ok",...sync})}function accountStoreFailure(dependencies,error){if(error instanceof KeychainLockedError)return dependencies.error(error.message),reply(dependencies,{keychain:"locked"},ACCOUNT_EXIT.keychainLocked);if(error instanceof SecretServiceUnavailableError)return dependencies.error(error.message),reply(dependencies,{keychain:"unavailable"},ACCOUNT_EXIT.keychainUnavailable);if(error instanceof CredentialStoreError)return dependencies.error(error.message),reply(dependencies,{error:"store-unavailable"},ACCOUNT_EXIT.storeUnavailable);return dependencies.error(error instanceof SignInError||error instanceof Error?error.message:"omo account: the operation failed"),ACCOUNT_EXIT.failed}async function runAccountShow(dependencies,flags){try{return await showAccount(dependencies,flags)}catch(error){return accountStoreFailure(dependencies,error)}}var accountServiceApi=()=>serviceOrigin(process.env.OMO_SERVICE_API_URL??"https://api.omo.dev");async function readAccountInProcess(error,openStore=(api)=>createCredentialStore(api,{wait:SESSION_READ_WAIT})){let api=accountServiceApi(),lines=[],store;return{exitCode:await runAccountShow({api,get store(){return store??=openStore(api),store},pinDir:()=>syncPinDir(resolveMemoryRoot(process.env,process.cwd())),output:(line)=>lines.push(line),error},[]),stdout:lines.join(`
|
|
246
246
|
`)}}import{homedir as homedir8}from"node:os";import{join as join23,resolve as resolve2}from"node:path";var AGENT_DIR_ENV_NAMES=["OMO_CODING_AGENT_DIR","SENPI_CODING_AGENT_DIR","PI_CODING_AGENT_DIR"];function runtimeHome(env=process.env){return env.HOME||env.USERPROFILE||homedir8()}function canonicalAgentDir(env=process.env,home=runtimeHome(env)){for(let name of AGENT_DIR_ENV_NAMES){let configured=env[name]?.trim();if(configured)return resolve2(configured)}return defaultAgentDir(home)}function defaultAgentDir(home){return join23(home,".omo","agent")}import{isAbsolute as isAbsolute2,resolve as resolve3}from"node:path";import{homedir as homedir9}from"node:os";var UNSUPPORTED={kind:"unsupported"},pause=(milliseconds)=>new Promise((resolve)=>setTimeout(resolve,milliseconds));function coldWakeSetup(options){let platform=options.platform??process.platform,uid=typeof process.getuid==="function"?process.getuid():void 0;if(platform!=="linux"&&platform!=="darwin"||uid===void 0)return{install:async()=>UNSUPPORTED,uninstall:async()=>UNSUPPORTED,status:async()=>{return}};let host={platform,home:homedir9(),uid,run:runCommand,pause},launchOf=()=>{try{return SessionHostLaunch.from({omoBin:options.binaryPath,execPath:process.execPath,agentDir:options.agentDir,path:(options.env??process.env).PATH})}catch(error){if(error instanceof ColdWakeUnitError)return{kind:"failed",step:"unit",detail:error.message};throw error}},withLaunch=async(apply)=>{let launch=launchOf();return launch instanceof SessionHostLaunch?apply(launch):launch};return{install:()=>withLaunch((launch)=>installColdWake(host,launch)),uninstall:()=>withLaunch((launch)=>uninstallColdWake(host,launch)),status:async()=>{let launch=launchOf();if(!(launch instanceof SessionHostLaunch))return;let read=await readColdWake(host,launch);return{session_host:{...read.sessionHost,pinned:read.pinnedHost},device_service:read.deviceService,cold_wake_entry:read.coldWakeEntry,agent_dir:options.agentDir}}}}function coldWakeNotice(outcome){switch(outcome.kind){case"installed":case"removed":case"unsupported":return;case"service_not_installed":return"Cold wake is not set up: the OmO device service is not installed as a user service on this device.";case"table_invalid":return`Cold wake is not set up: the device service's OMO_RELAYD_SERVICES table cannot be read (${outcome.reason}). Fix or remove it, then run omo remote bootstrap.`;case"failed":return`Cold wake could not be set up (${outcome.step}: ${outcome.detail}). Messages to this device's sessions need a running omo until it is.`}}async function applyColdWake(coldWake,enabled,error){let outcome=await(enabled?coldWake.install():coldWake.uninstall()),notice=!enabled&&outcome.kind==="service_not_installed"?void 0:coldWakeNotice(outcome);if(notice!==void 0)error(notice);return outcome}var REMOTE_EXIT={ok:0,failed:1,usage:2,unavailable:3};class UsageError extends Error{}var STATE_LABELS={not_configured:"Not set up",disabled:"Off",sign_in_required:"Sign-in required",plan_required:"Plan required",keychain_locked:"Keychain locked",connecting:"Connecting",activation_pending:"Waiting for activation",connected:"Connected",offline:"Offline",authorization_stale:"Reconnecting",service_degraded:"Needs attention",update_required:"Update required",signed_out:"Signed out",fail_closed:"Needs repair"};function renderTable(header,rows){let widths=header.map((title,column)=>Math.max(title.length,...rows.map((row)=>(row[column]??"").length))),line=(cells)=>cells.map((cell,column)=>cell.padEnd(widths[column]??0)).join(" ").trimEnd();return[line(header),...rows.map(line)]}function ago(ms,now){if(ms===null)return"never";let seconds=Math.max(0,Math.round((now-ms)/1000));if(seconds<60)return"just now";let minutes=Math.round(seconds/60);if(minutes<60)return`${minutes}m ago`;let hours=Math.round(minutes/60);if(hours<48)return`${hours}h ago`;return`${Math.round(hours/24)}d ago`}function statusLines(status,serviceVersion,local=[]){let rows=[["State",STATE_LABELS[status.state]],["Remote sessions",status.enabled?"on":"off"],["This device",status.device===null?"not set up":status.device.name],["Service",serviceVersion]];if(status.detail?.action)rows.push(["Action",status.detail.action]);rows.push(...local);let width=Math.max(...rows.map(([label])=>label.length));return rows.map(([label,value])=>`${label.padEnd(width)} ${value}`)}var UNIT_STATE_LABELS={running:"running",stopped:"stopped",not_installed:"not installed",unknown:"unknown"},yesNoUnknown=(value,yes,no)=>value==="unknown"?"unknown":value?yes:no;function localRows(local){let host=local.session_host;return[["Session host",`${host.state==="not_installed"?UNIT_STATE_LABELS[host.state]:[UNIT_STATE_LABELS[host.state],host.enabled?"enabled":"not enabled",yesNoUnknown(host.pinned,"pinned","not pinned")].join(", ")} (${host.unit})`],["Service unit",`${UNIT_STATE_LABELS[local.device_service.state]} (${local.device_service.unit})`],["Cold wake",yesNoUnknown(local.cold_wake_entry,"on","off")],["Agent dir",`${local.agent_dir} (registered at every omo start)`]]}function deviceLines(devices,now){if(devices.length===0)return["No devices on this account yet."];return renderTable(["DEVICE","NAME","KIND","PLATFORM","SEEN"],devices.map((device)=>[device.device,device.label,device.kind??"this device",device.platform,device.online?"online":ago(device.last_seen_ms,now)]))}function sessionLines(result,labels,now){let lines=result.rows.length===0?["No sessions found."]:renderTable(["SESSION","TITLE","STATE","PROJECT","DEVICE","UPDATED"],result.rows.map((row)=>[`${row.device}/${row.session_id}`,row.title,row.source==="cache"?`${row.state} (cached)`:row.state,row.project,labels.get(row.device)??row.device,ago(row.updated_ms,now)])),missing=[...new Set([...result.incomplete,...Object.entries(result.devices).filter(([,state])=>state!=="answered").map(([device])=>device)])];if(missing.length>0)lines.push("",`Not answered, rows may be missing or cached: ${missing.map((device)=>labels.get(device)??device).join(", ")}`);return lines}var queuedLine=(label,delivery)=>{let waitingOn="waiting_on"in delivery?delivery.waiting_on:void 0;if(waitingOn?.kind==="approval")return`Queued on ${label} at position ${delivery.queue_position}, waiting for an approval on ${waitingOn.device??"that device"}.`;return`Queued on ${label} at position ${delivery.queue_position}.`};function sessionVerbLines(verb,label,result){if(result.kind!=="ok")return[];if(verb==="open"&&"thread"in result)return[`${result.thread.device??""}/${result.thread.thread_id}`];if(verb==="send"&&"delivery"in result){let{delivery}=result;if(delivery.kind==="queued"||delivery.kind==="queued_offline")return[queuedLine(label,delivery)];if(delivery.kind==="steered")return[`Steered turn ${delivery.turn_id} on ${label}.`];return[`Sent to ${label}: turn ${delivery.turn_id} started.`]}if(verb==="model"&&"model"in result)return[`${label} now uses ${result.model.provider}/${result.model.id}.`];if(verb==="interrupt"&&"interrupted"in result){if(!result.interrupted)return[`Nothing was running on ${label}.`];let{background}=result;if(background.status==="not_supported")return[`Interrupted ${label}.`,`Background jobs that turn started were left running: the engine on ${label} cannot stop them.`];let jobName=(job)=>job.description??job.id,count=background.stopped.length;return[`Interrupted ${label}.`,...count===0?[]:[`Stopped ${count} background job${count===1?"":"s"}: ${background.stopped.map(jobName).join(", ")}.`],...background.failed.map((job)=>`Could not stop background job ${jobName(job)}: ${job.reason}.`)]}if(verb==="close"&&"closed"in result)return[result.closed?`Closed ${label}.`:`${label} was not open.`];return[]}function sendWaitNotice(label,result){if(result.kind!=="ok"||!("delivery"in result))return null;let{delivery}=result;return delivery.kind==="queued"||delivery.kind==="queued_offline"?queuedLine(label,delivery):null}function wakeLines(state){let line=state.enabled?"Waking is on: sessions on this device that are not running may be started by a message from your other signed-in devices.":"Waking is off: a message from another device waits until this session is opened here.",source=state.stored===null?"Nothing is stored for this device, so it follows this build's default.":state.stored==="unreadable"?"The stored value could not be read; set it again to repair it.":`Stored on this device: ${state.stored?"on":"off"}.`,lines=[line,source];if(state.overridden)lines.push("This run of the device service cannot wake sessions for other devices whatever the switch says.");return lines}function controlLines(state,now){let line=state.attached?"Remote control is on: your other signed-in devices can view and command sessions on this device.":"Remote control is off: your other devices cannot view or command sessions on this device.";return state.changedAt===""?[line]:[line,`Changed ${ago(Date.parse(state.changedAt),now)}.`]}var UNSUPPORTED_HOST="The OmO device service does not run on this platform yet.";function deviceServiceBootstrapSetup(options){let host=deviceServiceHost(options.platform??process.platform,options.arch??process.arch);return{pinVersion:DEVICE_SERVICE_VERSION,install:async()=>host===void 0?{ok:!1,state:"service_degraded",action:UNSUPPORTED_HOST}:installDeviceService({...options.release,version:DEVICE_SERVICE_VERSION,host,stateDir:options.stateDir,engineVersion:package_default.dependencies["@code-yeongyu/senpi"]}),refresher:{binaryPath:options.binaryPath,version:package_default.version},agentDir:options.agentDir}}function omoBinaryPath(env=process.env){let declared=env.OMO_BIN;if(declared!==void 0&&isAbsolute2(declared))return declared;let bun=Reflect.get(globalThis,"Bun"),embedded=typeof bun==="object"&&bun!==null?Reflect.get(bun,"embeddedFiles"):void 0;if(Array.isArray(embedded)&&embedded.length>0)return process.execPath;return resolve3(process.argv[1]??process.execPath)}var bootstrap=async(io,setup,json,quietSuppressed=!1)=>{let outcome=await bootstrapDeviceService({accountShow:io.accountShow,stateDir:io.stateDir,connect:io.connect,...setup});if(outcome.kind==="stopped"&&!(quietSuppressed&&outcome.suppressed===!0))if(json)io.output(JSON.stringify({state:outcome.state,notice:outcome.notice}));else io.error(outcome.notice);return outcome},NOT_LINKED="This device is not linked to the OmO device service yet. Run omo login to link it.";async function runEnableVerb(io,setup,remote,json){return await enableRemote(io,setup,remote,json,(on)=>io.output(json?JSON.stringify({enabled:on}):`Remote sessions are ${on?"on":"off"} for this device.`))==="stopped"?REMOTE_EXIT.unavailable:REMOTE_EXIT.ok}async function enableRemote(io,setup,remote,json,report,quietSuppressed=!1){let outcome=await bootstrap(io,setup,json,quietSuppressed);if(outcome.kind==="stopped")return"stopped";let enabled;try{enabled=await outcome.service.setEnabled(!0)}finally{outcome.service.close()}if(enabled)remote.optOut.clear();if(report(enabled),outcome.status.device===null&&await remote.linkDevice()==="signed_out")io.error(NOT_LINKED);return await applyColdWake(remote.coldWake,enabled,io.error),enabled}var REMOTE_ON_AFTER_SIGN_IN="Remote is on for this device: other signed-in devices can reach it. Turn off: omo remote disable",REMOTE_KEPT_OFF_AFTER_SIGN_IN="Remote is off for this device, as you set it with omo remote disable. Turn on: omo remote enable";async function runLoginSetup(io,setup,remote){if(remote.optOut.read()){let outcome=await bootstrap(io,setup,!1,!0);if(outcome.kind==="connected"){try{if(outcome.status.enabled)await outcome.service.setEnabled(!1)}finally{outcome.service.close()}await applyColdWake(remote.coldWake,!1,io.error)}return io.output(REMOTE_KEPT_OFF_AFTER_SIGN_IN),"kept_off"}if(await enableRemote(io,setup,remote,!1,()=>{},!0)!==!0)return"not_on";return io.output(REMOTE_ON_AFTER_SIGN_IN),"on"}async function runBootstrapVerb(io,setup,remote,json){let outcome=await bootstrap(io,setup,json);if(outcome.kind==="stopped")return"stopped";let optedOut=remote.optOut.read(),status=outcome.status;try{if(optedOut&&status.enabled)await outcome.service.setEnabled(!1);if(!optedOut&&status.enabled&&status.device===null)await remote.linkDevice();if(optedOut||status.device===null)status=await outcome.service.status();if(json)io.output(JSON.stringify({state:"connected",status}));else for(let line of statusLines(status,outcome.service.serviceVersion))io.output(line)}finally{outcome.service.close()}return await applyColdWake(remote.coldWake,!optedOut&&status.state!=="disabled",io.error),"connected"}import{existsSync as existsSync16}from"node:fs";import{createHash as createHash10,randomBytes as randomBytes7,timingSafeEqual as timingSafeEqual3}from"node:crypto";import{chmodSync as chmodSync4,mkdtempSync as mkdtempSync2,rmSync as rmSync5,writeFileSync as writeFileSync5}from"node:fs";import{createServer as createServer3}from"node:net";import{tmpdir as tmpdir2}from"node:os";import{join as join24,win32 as win324}from"node:path";import{randomUUID as randomUUID5}from"node:crypto";var THREAD_ERROR_CODES=["invalid_arguments","caller_context_missing","not_found","reply_target_mismatch","ambiguous_target","scope_denied","name_conflict","not_resumable","orphaned","foreign_live_owner","no_active_turn","turn_conflict","not_steerable","message_too_large","queue_full","cursor_invalid","cursor_stale","idempotency_conflict","idempotency_in_progress","idempotency_uncertain","approval_unavailable","approval_route_locked","partial_commit","unsupported","overloaded","transport_closed","host_unavailable","internal_error","model_not_found","model_ambiguous","thinking_level_unsupported","loop_detected","binding_conflict","binding_mismatch","binding_inactive","stale_revision","stale_token","already_answered","answer_in_progress","device_offline","relay_requires_paid_plan","alias_taken"],CODE_SET=new Set(THREAD_ERROR_CODES);function isThreadErrorCode(value){return typeof value==="string"&&CODE_SET.has(value)}function threadToolFailure(code,message,nextAction,details){if(!isThreadErrorCode(code))throw Error(`unknown thread error code: ${String(code)}`);return{code,message,next_action:nextAction,...details===void 0?{}:{details}}}var fail2=(code,message,next,details)=>({kind:"error",error:threadToolFailure(code,message,next,details)});function outcomeOf(result){let{outcome}=result;if(outcome.state==="engine_refused"){let detail=outcome.receipt?.reason;return typeof detail==="string"&&detail!==""?{kind:"refused",reason:outcome.reason,detail}:{kind:"refused",reason:outcome.reason}}if(outcome.state==="uncertain")return{kind:"uncertain",reason:outcome.reason};if(outcome.state==="engine_stale")return{kind:"uncertain",reason:"engine_stale"};let response=result.response??{};if(response.success===!1){let{errorCode:code,error}=response;return{kind:"refused",reason:typeof code==="string"&&code.length>0?code:typeof error==="string"&&error.length>0?error:"engine_failed"}}return result.located===void 0?{kind:"ok",response}:{kind:"ok",response,located:result.located.key}}var READ_UNCERTAIN={request_gone:"retry",no_receipt:"retry",engine_restarted:"retry",recipient_revoked:"retry",transport_expired:"retry",unconfirmed:"retry",lease_expired:"retry",cancelled:"retry",hand_restarted:"retry",result_expired:"retry",record_too_large:"too_large",result_undecodable:"retry"},UNANSWERED=new Set(["closed","protocol_violation","internal","read_failed","request_timeout","handshake_timeout","attach_failed","reply_lost","host_not_answering","peer_not_found","engine_stale",...Object.entries(READ_UNCERTAIN).filter(([,answer])=>answer==="retry").map(([reason])=>reason)]);function outcomeFailure(outcome,device){if(outcome.kind==="uncertain")return fail2("idempotency_uncertain",`The command to device ${device} may or may not have run (${outcome.reason}).`,"Read the thread before deciding whether to retry.",{device,reason:outcome.reason});if(outcome.reason==="capability_missing")return fail2("scope_denied",`Device ${device} does not grant this command.`,"Allow commands from this device on the other device, then retry.",{device,reason:outcome.reason});if(outcome.reason==="host_detached")return fail2("host_unavailable",`Device ${device} is not attached to the relay.`,"Retry when that device is signed in and online.",{device,reason:outcome.reason});if(UNANSWERED.has(outcome.reason))return fail2("host_unavailable",`Device ${device} did not answer (${outcome.reason}); this call changed nothing there.`,"Retry; nothing needs to be checked first.",{device,reason:outcome.reason});if(outcome.reason==="record_too_large")return fail2("unsupported",`The thread on device ${device} is too large to send back in one relay record (record_too_large).`,"Read it on that device, or ask that thread for a summary with thread_send.",{device,reason:outcome.reason});return fail2("unsupported",`Device ${device} refused the command (${outcome.reason}).`,"Update omo on that device, or address a thread on this device.",{device,reason:outcome.reason})}var raiserOnly=(request)=>request.secret===!0||request.grantSelect===!0;var isObject4=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value),SHOWN_KEPT=1024,remember=(known,uiRequestId)=>{known.add(uiRequestId);for(let oldest of known)if(known.size>SHOWN_KEPT)known.delete(oldest)},pendingIds=(...lists)=>new Set(lists.flatMap((list)=>Array.isArray(list)?list.flatMap((request)=>isObject4(request)&&typeof request.id==="string"?[request.id]:[]):[]));class MirroredDialogs{#shown=new Set;#raiserOnly=new Set;present(record,sessionId){let uiRequestId=record.uiRequestId;if(typeof uiRequestId!=="string"||uiRequestId==="")return;if(record.type==="ui_request_settled")return this.#shown.delete(uiRequestId),this.#raiserOnly.delete(uiRequestId),{type:"question_resolved",id:uiRequestId,outcome:record.disposition==="answered"?"answered":"cancelled",sessionId};if(record.type!=="ui_request_pending")return;let request=record.request;if(!isObject4(request))return null;if(raiserOnly(request))return remember(this.#raiserOnly,uiRequestId),null;return remember(this.#shown,uiRequestId),{...request,type:"extension_ui_request",id:uiRequestId,sessionId}}pending(requests,sessionId){if(!Array.isArray(requests))return[];return requests.flatMap((request)=>{if(!isObject4(request)||typeof request.id!=="string"||request.id==="")return[];if(raiserOnly(request))return remember(this.#raiserOnly,request.id),[];return remember(this.#shown,request.id),[{...request,type:"extension_ui_request",sessionId}]})}settledAway(still,sessionId){return[this.#shown,this.#raiserOnly].flatMap((known)=>[...known].flatMap((uiRequestId)=>{if(still.has(uiRequestId))return[];return known.delete(uiRequestId),[{type:"question_resolved",id:uiRequestId,outcome:"cancelled",sessionId}]}))}answer(record){let id=record.id;if(record.type!=="extension_ui_response"||typeof id!=="string"||record.uiRequestId!==void 0||!this.#shown.has(id))return record;return{...record,uiRequestId:id}}}var LOCAL_SESSION_ID="remote",isRecord7=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value),outcomeText=(outcome,device)=>{let mapped=outcomeOf({outcome});return mapped.kind==="ok"?outcome.state:outcomeFailure(mapped,device).error.message};function stateOf(snapshot){let state=isRecord7(snapshot.state)?snapshot.state:{};return{...state,sessionId:LOCAL_SESSION_ID,isStreaming:state.isStreaming===!0}}class Presentation{snapshot;streaming=!1;stopStream;dialogs=new MirroredDialogs;attach;label;socket;constructor(attach,label,socket){this.attach=attach,this.label=label,this.socket=socket}startStream(){if(this.streaming)return;this.streaming=!0,this.notify(`Attached to ${this.label}`,"info");let stopEvents=this.attach.onEvent((event)=>this.event(event)),stopFrames=this.attach.onFrame((frame)=>this.send("sessionId"in frame?{...frame,sessionId:LOCAL_SESSION_ID}:frame)),stopLosses=this.attach.onChannelLoss((reason)=>this.notify(`Lost a reply or event from the remote device: ${reason}`,"warning"));this.stopStream=()=>{stopEvents(),stopFrames(),stopLosses()}}stop(){this.stopStream?.()}send(value){if(this.socket.writable&&!this.socket.destroyed)this.socket.write(`${JSON.stringify(value)}
|
|
247
247
|
`)}event(event){switch(event.kind){case"snapshot":this.presentPending(event.snapshot),this.snapshot=event.snapshot;return;case"records":for(let record of event.records){let dialog=this.dialogs.present(record,LOCAL_SESSION_ID);if(dialog!==null)this.send(dialog??{...record,sessionId:LOCAL_SESSION_ID})}return;case"pending":this.notify("Waiting for the remote device to share this session","info");return;case"detached":this.notify(`The remote session ended (${event.reason})`,"warning"),this.socket.end();return}}pendingOf(snapshot){let state=isRecord7(snapshot.state)?snapshot.state:{};return{pendingDialogs:this.dialogs.pending(state.pendingDialogs,LOCAL_SESSION_ID),pendingQuestions:this.dialogs.pending(state.pendingQuestions,LOCAL_SESSION_ID)}}presentPending(snapshot){let{pendingDialogs,pendingQuestions}=this.pendingOf(snapshot),pending=[...pendingDialogs,...pendingQuestions],state=isRecord7(snapshot.state)?snapshot.state:{},still=pendingIds(state.pendingDialogs,state.pendingQuestions);for(let resolved of this.dialogs.settledAway(still,LOCAL_SESSION_ID))this.send(resolved);for(let dialog of pending)this.send(dialog)}notify(message,notifyType){this.send({type:"extension_ui_request",id:randomUUID5(),method:"notify",message,notifyType,sessionId:LOCAL_SESSION_ID})}async answer(request){let type=String(request.type),reply=(data={})=>this.send({type:"response",id:request.id,command:type,success:!0,data}),refuse=(error)=>this.send({type:"response",id:request.id,command:type,success:!1,error});try{switch(type){case"set_client_info":case"attach_session":case"release_attachment":return reply();case"list_sessions":return reply({sessions:[{sessionId:LOCAL_SESSION_ID,durableSessionId:this.attach.sessionId,retain_on_disconnect:!0,sessionName:this.label}]});case"subscribe_sessions":return reply({subscriptionId:randomUUID5(),snapshot:[]}),this.startStream();case"get_state":{let snapshot=this.snapshot??await this.attach.snapshot;return this.snapshot=snapshot,reply({...stateOf(snapshot),...this.pendingOf(snapshot)})}case"get_entries":return reply(await this.entries(request));default:return await this.forward(request,type)}}catch(error){refuse(error instanceof Error?error.message:String(error))}}async forward(request,type){let named=this.dialogs.answer(request),rpc=named.sessionId===LOCAL_SESSION_ID?{...named,sessionId:this.attach.sessionId}:named,{outcome,response}=await this.attach.command(rpc);if(response!==void 0){this.send({...response,id:request.id});return}if(outcome.state==="engine_applied"){this.send({type:"response",id:request.id,command:type,success:!0});return}this.send({type:"response",id:request.id,command:type,success:!1,error:outcomeText(outcome,this.attach.device)})}async entries(request){let before=typeof request.before==="string"?request.before:void 0,tail=typeof request.tail==="number"?Math.min(Math.max(Math.trunc(request.tail),1),200):void 0;if(before===void 0){let snapshot=this.snapshot??await this.attach.snapshot;this.snapshot=snapshot;let next=snapshot.history_truncated&&snapshot.oldest_entry_id!==null?{next_before:snapshot.oldest_entry_id}:{};return{entries:snapshot.entries,leafId:null,...next}}let page=await this.attach.read({before,...tail===void 0?{}:{tail}}),shown=page.entries.flatMap((entry)=>("entry"in entry)?[entry.entry]:[]),skipped=page.entries.length-shown.length;if(skipped>0)this.notify(`${skipped} older ${skipped===1?"entry is":"entries are"} too large to show`,"info");return{entries:shown,leafId:null,...page.next_before===null?{}:{next_before:page.next_before}}}}var SECRET_BYTES=32,HANDSHAKE_TIMEOUT_MS2=2000,MAX_LINE_CHARS=67108864,PIPE_PREFIX="\\\\.\\pipe\\senpi-rpc-";function pipeAddress(socketPath,secret){let canonical=win324.normalize(socketPath).toLowerCase(),identity=Buffer.concat([Buffer.from(canonical,"utf8"),Buffer.from(secret)]);return`${PIPE_PREFIX}${createHash10("sha256").update(identity).digest("hex").slice(0,32)}`}var isParsedRecord=(value)=>isRecord7(value);function authenticate(socket,secret,onAuthenticated){let received=Buffer.alloc(0),timer=setTimeout(()=>socket.destroy(),HANDSHAKE_TIMEOUT_MS2),onData=(chunk)=>{if(received=Buffer.concat([received,chunk]),received.length<secret.length)return;if(clearTimeout(timer),socket.off("data",onData),!timingSafeEqual3(received.subarray(0,secret.length),secret)){socket.destroy();return}let rest=received.subarray(secret.length);if(rest.length>0)socket.unshift(rest);onAuthenticated()};socket.on("data",onData),socket.once("close",()=>clearTimeout(timer))}function serveLines(socket,onLine){let buffer="";socket.setEncoding("utf8"),socket.on("data",(chunk)=>{if(buffer+=chunk,buffer.length>MAX_LINE_CHARS){socket.destroy();return}let newline=buffer.indexOf(`
|
package/package.json
CHANGED
package/plugin/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [5.1.75] - 2026-11-16
|
|
11
|
+
|
|
12
|
+
### Fixed
|
|
13
|
+
|
|
14
|
+
- `omo remote devices` shows this device offline while its device service is not connected, and `omo remote sessions --device` naming a device the account does not have reports it instead of listing nothing. ([#13916](https://github.com/code-yeongyu/oh-my-openagent/pull/13916))
|
|
15
|
+
- Memory sync's own test suite no longer fails a later, unrelated test when one test times out while a sync cycle is still running: device teardown in the tests now stops the engine and waits for that cycle before removing its files, and the push-bounded test waits on the cycle instead of a fixed 30 s budget. ([#13887](https://github.com/code-yeongyu/oh-my-openagent/pull/13887), fixes [#13680](https://github.com/code-yeongyu/oh-my-openagent/issues/13680))
|
|
16
|
+
- The first memory sync cycle after signing in no longer fails with "the device's sign-in token could not be read or refreshed" when the system keychain briefly reads nothing. That one empty read is now checked again before sync treats the sign-in as gone; signing out still stops sync at once. ([#13879](https://github.com/code-yeongyu/oh-my-openagent/pull/13879), fixes [#13739](https://github.com/code-yeongyu/oh-my-openagent/issues/13739))
|
|
17
|
+
- Regenerating the computer-use prelude (`bun run generate` in `senpi-desktop-prelude`) now runs its generated method tables through `bun fmt`, so `prelude.js`, its `index.ts` allowlist and the desktop protocol tier tables stay formatter-clean instead of reverting to unformatted output at every release regeneration. The published prelude JavaScript is the formatted copy again. ([#13855](https://github.com/code-yeongyu/oh-my-openagent/pull/13855))
|
|
18
|
+
|
|
19
|
+
### Changed
|
|
20
|
+
|
|
21
|
+
- A memory sync capture that receives files from other devices no longer scans every known file once per received file, so a large memory catching up on many incoming files stays fast. ([#13862](https://github.com/code-yeongyu/oh-my-openagent/pull/13862))
|
|
22
|
+
|
|
10
23
|
## [5.1.74] - 2026-11-16
|
|
11
24
|
|
|
12
25
|
**A secret input or grant approval that settled while the relay link was down is now dismissed on the terminal that raised it after `omo remote attach` reconnects**, instead of staying open with an answer the session would refuse. ([#13773](https://github.com/code-yeongyu/oh-my-openagent/pull/13773))
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
|
-
"COMPUTER_PRELUDE_JAVASCRIPT": "// Eval-kernel `computer` global: sugar over the ordinary registered tool call `tool.computer(...)`.\n// Each helper is one tool call, so lazy activation and the permission-system preflight apply to it; `verify` alone\n// repeats read calls until its deadline. The method lists in the generated region come from facade-manifest.json.\n{\n // Children a cell starts inherit the marker, so an SDK inside them refuses to spawn a second engine. It is written\n // only to an environment the kernel owns: a worker thread's own process.env view, or a process-mode kernel's own\n // process. On a host's main thread the write would reach every later child of the host (the bash tool, subagent\n // processes, the desktop service), so it is skipped there. The Python kernel is always its own process.\n const kernelProcess = globalThis.process\n const ownsEnvironment =\n kernelProcess?.getBuiltinModule?.(\"node:worker_threads\")?.isMainThread === false ||\n globalThis[Symbol.for(\"senpi.kernel.processMode\")] === true\n if (kernelProcess?.env && ownsEnvironment) kernelProcess.env.SENPI_DESKTOP_HOST = \"1\"\n const validateOptions = (label, options) => {\n if (options === undefined) return {}\n if (options === null || typeof options !== \"object\" || Array.isArray(options)) {\n throw new TypeError(`${label}() expects an options object`)\n }\n return options\n }\n const serializeFunction = (label, fn) => {\n const source = String(fn)\n if (source.includes(\"[native code]\")) {\n throw new TypeError(`${label} cannot serialize a native or bound function; pass an arrow or function expression`)\n }\n return source\n }\n // Direct helpers cross the tool boundary as JSON, where functions and RegExp values would vanish silently.\n const plainArg = (value) => {\n if (typeof value === \"function\" || value instanceof RegExp) {\n throw new TypeError(\n \"computer helpers take plain data; pass functions and RegExp values through computer.run(fn, { args })\",\n )\n }\n return value\n }\n const trimArgs = (args) => {\n const trimmed = [...args]\n while (trimmed.length > 0 && trimmed[trimmed.length - 1] === undefined) trimmed.pop()\n return trimmed\n }\n // `computer.run(fn)` ships source text, so each argument becomes a JavaScript expression.\n const runArgSource = (value) => {\n if (typeof value === \"function\") return `(${serializeFunction(\"computer.run() argument\", value)})`\n if (value instanceof RegExp) return String(value)\n return JSON.stringify(value) ?? \"undefined\"\n }\n // The tool result is `{ text, details?, images?, hasError? }`: images display, `details.value` is the return value.\n // A failed call's `details.value.code` (COMPUTER_*) rides on the thrown error as `error.code`.\n const invoke = async (args) => {\n const result = await globalThis.tool.computer(args)\n if (result.hasError) {\n const error = new Error(result.text)\n const code = result.details?.value?.code\n if (typeof code === \"string\") error.code = code\n throw error\n }\n for (const image of result.images ?? []) globalThis.display(image)\n return result.details?.value\n }\n const callValue = (chain) => invoke({ action: \"call\", chain })\n const step = (method, args) => ({ method, args: trimArgs(args).map(plainArg) })\n // Methods stay non-enumerable so handles display and serialize as their identity fields only.\n const defineMethod = (target, name, fn) => Object.defineProperty(target, name, { value: fn })\n const defineValueMethods = (target, methods, chain) => {\n for (const method of methods) {\n defineMethod(target, method, (...args) => callValue(chain(step(method, args))))\n }\n }\n\n\t// <generated:facade> from facade-manifest.json by scripts/generate-assets.ts; edit CHAIN_BINDINGS there, then `bun run generate`\n\tconst desktopValueMethods = [\"displays\", \"windows\", \"screenshot\", \"zoom\", \"click\", \"doubleClick\", \"move\", \"drag\", \"scroll\", \"type\", \"press\", \"holdKeys\", \"holdMouse\"];\n\tconst displayValueMethods = [\"screenshot\", \"zoom\", \"click\", \"doubleClick\", \"move\", \"drag\", \"scroll\", \"type\", \"press\", \"holdKeys\", \"holdMouse\"];\n\tconst windowValueMethods = [\"screenshot\", \"observe\", \"zoom\", \"click\", \"doubleClick\", \"move\", \"drag\", \"scroll\", \"type\", \"press\", \"holdKeys\", \"holdMouse\", \"raise\", \"ax\"];\n\tconst elementValueMethods = [\"value\", \"setValue\", \"bounds\", \"attributes\", \"actions\", \"perform\", \"press\", \"click\", \"type\", \"focus\"];\n\t// </generated:facade>\n const windowFields = [\"id\", \"app\", \"title\", \"pid\", \"bounds\", \"focused\"]\n const elementFields = [\"ref\", \"role\", \"nativeRole\", \"title\", \"description\", \"enabled\", \"focused\", \"childCount\"]\n\n const copyFields = (target, fields, snapshot) => {\n for (const field of fields) {\n if (snapshot[field] !== undefined)\n Object.defineProperty(target, field, { value: snapshot[field], enumerable: true })\n }\n }\n const makeElement = (snapshot) => {\n const element = {}\n copyFields(element, elementFields, snapshot)\n defineMethod(element, \"toString\", () => `<element ${snapshot.ref} ${snapshot.role}>`)\n const via = (next) => [step(\"ref\", [snapshot.ref]), next]\n defineValueMethods(element, elementValueMethods, via)\n defineMethod(element, \"parent\", async () => {\n const parent = await callValue(via(step(\"parent\", [])))\n return parent ? makeElement(parent) : null\n })\n defineMethod(element, \"children\", async () => (await callValue(via(step(\"children\", [])))).map(makeElement))\n return Object.freeze(element)\n }\n const resolveElement = async (chain) => {\n const snapshot = await callValue(chain)\n return snapshot ? makeElement(snapshot) : null\n }\n const makeWindow = (snapshot) => {\n const win = {}\n copyFields(win, windowFields, snapshot)\n defineMethod(win, \"toString\", () => `<window ${snapshot.id} ${snapshot.app}>`)\n const via = (next) => [step(\"window\", [snapshot.id]), next]\n defineValueMethods(win, windowValueMethods, via)\n defineMethod(win, \"find\", async (query) => (await callValue(via(step(\"find\", [query])))).map(makeElement))\n defineMethod(win, \"ref\", (ref) => resolveElement([step(\"ref\", [ref])]))\n // The tree under one element of this window (`ax.snapshot` with a root); the parent snapshot's refs stay valid.\n defineMethod(win, \"drill\", (ref, options) =>\n callValue(via(step(\"ax\", [{ ...validateOptions(\"win.drill\", options), root: ref }]))),\n )\n defineMethod(\n win,\n \"menu\",\n Object.freeze({\n items: (path) => callValue(via(step(\"menu.items\", [path]))),\n select: (path, options) =>\n callValue(via(step(\"menu.select\", options === undefined ? [path] : [path, options]))),\n }),\n )\n return Object.freeze(win)\n }\n const resolveWindow = async (chain) => {\n const snapshot = await callValue(chain)\n return snapshot ? makeWindow(snapshot) : null\n }\n\n const computer = {}\n defineValueMethods(computer, desktopValueMethods, (next) => [next])\n computer.window = (selector) => resolveWindow([step(\"window\", [selector])])\n computer.display = async (selector) => {\n const snapshot = await callValue([step(\"display\", [selector])])\n const target = {}\n copyFields(target, [\"id\"], snapshot)\n defineValueMethods(target, displayValueMethods, (next) => [step(\"display\", [snapshot.id]), next])\n return Object.freeze(target)\n }\n computer.focusedWindow = () => resolveWindow([step(\"focusedWindow\", [])])\n computer.elementAt = (x, y) => resolveElement([step(\"elementAt\", [x, y])])\n computer.focusedElement = () => resolveElement([step(\"focusedElement\", [])])\n computer.ref = (ref) => resolveElement([step(\"ref\", [ref])])\n computer.clipboard = Object.freeze({\n read: () => callValue([step(\"clipboard.read\", [])]),\n write: (text) => callValue([step(\"clipboard.write\", [text])]),\n })\n computer.control = Object.freeze({\n acquire: (options) => callValue([step(\"control.acquire\", [options])]),\n release: () => callValue([step(\"control.release\", [])]),\n state: () => callValue([step(\"control.state\", [])]),\n })\n computer.run = async (fnOrCode, options) => {\n if (typeof fnOrCode !== \"function\" && typeof fnOrCode !== \"string\") {\n throw new TypeError(\"computer.run() expects a function or code string\")\n }\n const opts = validateOptions(\"computer.run\", options)\n let code = fnOrCode\n if (typeof fnOrCode === \"function\") {\n const args = trimArgs(Array.isArray(opts.args) ? opts.args : []).map((value) => `, ${runArgSource(value)}`)\n code = `return await (${serializeFunction(\"computer.run()\", fnOrCode)})({ desktop, wait, assert }${args.join(\"\")});`\n }\n const parameters = { action: \"run\", code }\n if (opts.read_only !== undefined) parameters.read_only = opts.read_only\n if (opts.timeout !== undefined) parameters.timeout = opts.timeout\n return invoke(parameters)\n }\n const EXPECTATION_KINDS = new Set([\n \"elementExists\",\n \"elementValue\",\n \"elementEnabled\",\n \"elementSelected\",\n \"windowExists\",\n \"windowGone\",\n \"windowBounds\",\n ])\n const TRUE_ATTRIBUTE = new Set([\"1\", \"true\", \"yes\"])\n const includesText = (value, part) =>\n part === undefined || String(value).toLocaleLowerCase().includes(String(part).toLocaleLowerCase())\n const matchesWindow = (win, selector) =>\n typeof selector === \"string\"\n ? win.id === selector\n : (selector.id === undefined || win.id === selector.id) &&\n includesText(win.app, selector.app) &&\n includesText(win.title, selector.title)\n const windowsMatching = async (selector) =>\n (await callValue([step(\"windows\", [])])).filter((win) => matchesWindow(win, selector))\n const readElement = (ref, method) =>\n callValue(method === undefined ? [step(\"ref\", [ref])] : [step(\"ref\", [ref]), step(method, [])])\n // One read of the state an expectation names; throws when the read fails.\n const holds = async (expectation) => {\n switch (expectation.kind) {\n case \"elementExists\":\n try {\n await readElement(expectation.ref)\n return expectation.exists ?? true\n } catch (error) {\n // A ref that no longer resolves answers the question (the element is gone); other failures do not.\n if (error?.code === \"COMPUTER_STALE_REF\") return !(expectation.exists ?? true)\n throw error\n }\n case \"elementValue\":\n return (await readElement(expectation.ref, \"value\")) === expectation.value\n case \"elementEnabled\":\n return (await readElement(expectation.ref)).enabled === (expectation.enabled ?? true)\n case \"elementSelected\": {\n const attributes = await readElement(expectation.ref, \"attributes\")\n return TRUE_ATTRIBUTE.has(String(attributes?.AXSelected ?? \"\").toLowerCase()) === (expectation.selected ?? true)\n }\n case \"windowExists\":\n return (await windowsMatching(expectation.window)).length > 0\n case \"windowGone\":\n return (await windowsMatching(expectation.window)).length === 0\n case \"windowBounds\": {\n const found = await windowsMatching(expectation.window)\n if (found.length > 1) throw new Error(`InvalidTarget: verify windowBounds matches ${found.length} windows`)\n const box = found[0]?.bounds ?? found[0]\n const tolerance = expectation.tolerance ?? 0\n return (\n box !== undefined &&\n [\"x\", \"y\", \"width\", \"height\"].every(\n (field) =>\n expectation.bounds[field] === undefined || Math.abs(box[field] - expectation.bounds[field]) <= tolerance,\n )\n )\n }\n }\n }\n // Deadline-bounded poll of read calls: never sends input and never waits past the deadline.\n computer.verify = async (expectation, options) => {\n if (expectation === null || typeof expectation !== \"object\" || !EXPECTATION_KINDS.has(expectation.kind)) {\n throw new TypeError(\n `computer.verify() expects an expectation whose kind is one of ${[...EXPECTATION_KINDS].join(\", \")}`,\n )\n }\n const opts = validateOptions(\"computer.verify\", options)\n const timeoutMs = opts.timeoutMs ?? 2000\n if (typeof timeoutMs !== \"number\" || !Number.isFinite(timeoutMs) || timeoutMs < 0) {\n throw new TypeError(\"computer.verify() timeoutMs must be a finite, non-negative number\")\n }\n const intervalMs = opts.intervalMs ?? 100\n if (typeof intervalMs !== \"number\" || !Number.isFinite(intervalMs) || intervalMs < 0) {\n throw new TypeError(\"computer.verify() intervalMs must be a finite, non-negative number\")\n }\n const interval = Math.max(intervalMs, 10)\n const started = Date.now()\n const deadline = started + timeoutMs\n let reads = 0\n for (;;) {\n let satisfied\n try {\n reads += 1\n satisfied = await holds(expectation)\n } catch (error) {\n return { status: \"unknown\", reads, elapsedMs: Date.now() - started, cause: String(error?.message ?? error) }\n }\n const now = Date.now()\n if (satisfied) return { status: \"satisfied\", reads, elapsedMs: now - started }\n if (now >= deadline) return { status: \"unsatisfied\", reads, elapsedMs: now - started }\n await new Promise((resolve) => setTimeout(resolve, Math.min(interval, deadline - now)))\n }\n }\n computer.capabilities = () => invoke({ action: \"capabilities\" })\n computer.close = async () => {\n await invoke({ action: \"close\" })\n }\n globalThis.computer = Object.freeze(computer)\n}\n",
|
|
2
|
+
"COMPUTER_PRELUDE_JAVASCRIPT": "// Eval-kernel `computer` global: sugar over the ordinary registered tool call `tool.computer(...)`.\n// Each helper is one tool call, so lazy activation and the permission-system preflight apply to it; `verify` alone\n// repeats read calls until its deadline. The method lists in the generated region come from facade-manifest.json.\n{\n // Children a cell starts inherit the marker, so an SDK inside them refuses to spawn a second engine. It is written\n // only to an environment the kernel owns: a worker thread's own process.env view, or a process-mode kernel's own\n // process. On a host's main thread the write would reach every later child of the host (the bash tool, subagent\n // processes, the desktop service), so it is skipped there. The Python kernel is always its own process.\n const kernelProcess = globalThis.process\n const ownsEnvironment =\n kernelProcess?.getBuiltinModule?.(\"node:worker_threads\")?.isMainThread === false ||\n globalThis[Symbol.for(\"senpi.kernel.processMode\")] === true\n if (kernelProcess?.env && ownsEnvironment) kernelProcess.env.SENPI_DESKTOP_HOST = \"1\"\n const validateOptions = (label, options) => {\n if (options === undefined) return {}\n if (options === null || typeof options !== \"object\" || Array.isArray(options)) {\n throw new TypeError(`${label}() expects an options object`)\n }\n return options\n }\n const serializeFunction = (label, fn) => {\n const source = String(fn)\n if (source.includes(\"[native code]\")) {\n throw new TypeError(`${label} cannot serialize a native or bound function; pass an arrow or function expression`)\n }\n return source\n }\n // Direct helpers cross the tool boundary as JSON, where functions and RegExp values would vanish silently.\n const plainArg = (value) => {\n if (typeof value === \"function\" || value instanceof RegExp) {\n throw new TypeError(\n \"computer helpers take plain data; pass functions and RegExp values through computer.run(fn, { args })\",\n )\n }\n return value\n }\n const trimArgs = (args) => {\n const trimmed = [...args]\n while (trimmed.length > 0 && trimmed[trimmed.length - 1] === undefined) trimmed.pop()\n return trimmed\n }\n // `computer.run(fn)` ships source text, so each argument becomes a JavaScript expression.\n const runArgSource = (value) => {\n if (typeof value === \"function\") return `(${serializeFunction(\"computer.run() argument\", value)})`\n if (value instanceof RegExp) return String(value)\n return JSON.stringify(value) ?? \"undefined\"\n }\n // The tool result is `{ text, details?, images?, hasError? }`: images display, `details.value` is the return value.\n // A failed call's `details.value.code` (COMPUTER_*) rides on the thrown error as `error.code`.\n const invoke = async (args) => {\n const result = await globalThis.tool.computer(args)\n if (result.hasError) {\n const error = new Error(result.text)\n const code = result.details?.value?.code\n if (typeof code === \"string\") error.code = code\n throw error\n }\n for (const image of result.images ?? []) globalThis.display(image)\n return result.details?.value\n }\n const callValue = (chain) => invoke({ action: \"call\", chain })\n const step = (method, args) => ({ method, args: trimArgs(args).map(plainArg) })\n // Methods stay non-enumerable so handles display and serialize as their identity fields only.\n const defineMethod = (target, name, fn) => Object.defineProperty(target, name, { value: fn })\n const defineValueMethods = (target, methods, chain) => {\n for (const method of methods) {\n defineMethod(target, method, (...args) => callValue(chain(step(method, args))))\n }\n }\n\n // <generated:facade> from facade-manifest.json by scripts/generate-assets.ts; edit CHAIN_BINDINGS there, then `bun run generate`\n const desktopValueMethods = [\n \"displays\",\n \"windows\",\n \"screenshot\",\n \"zoom\",\n \"click\",\n \"doubleClick\",\n \"move\",\n \"drag\",\n \"scroll\",\n \"type\",\n \"press\",\n \"holdKeys\",\n \"holdMouse\",\n ]\n const displayValueMethods = [\n \"screenshot\",\n \"zoom\",\n \"click\",\n \"doubleClick\",\n \"move\",\n \"drag\",\n \"scroll\",\n \"type\",\n \"press\",\n \"holdKeys\",\n \"holdMouse\",\n ]\n const windowValueMethods = [\n \"screenshot\",\n \"observe\",\n \"zoom\",\n \"click\",\n \"doubleClick\",\n \"move\",\n \"drag\",\n \"scroll\",\n \"type\",\n \"press\",\n \"holdKeys\",\n \"holdMouse\",\n \"raise\",\n \"ax\",\n ]\n const elementValueMethods = [\n \"value\",\n \"setValue\",\n \"bounds\",\n \"attributes\",\n \"actions\",\n \"perform\",\n \"press\",\n \"click\",\n \"type\",\n \"focus\",\n ]\n // </generated:facade>\n const windowFields = [\"id\", \"app\", \"title\", \"pid\", \"bounds\", \"focused\"]\n const elementFields = [\"ref\", \"role\", \"nativeRole\", \"title\", \"description\", \"enabled\", \"focused\", \"childCount\"]\n\n const copyFields = (target, fields, snapshot) => {\n for (const field of fields) {\n if (snapshot[field] !== undefined)\n Object.defineProperty(target, field, { value: snapshot[field], enumerable: true })\n }\n }\n const makeElement = (snapshot) => {\n const element = {}\n copyFields(element, elementFields, snapshot)\n defineMethod(element, \"toString\", () => `<element ${snapshot.ref} ${snapshot.role}>`)\n const via = (next) => [step(\"ref\", [snapshot.ref]), next]\n defineValueMethods(element, elementValueMethods, via)\n defineMethod(element, \"parent\", async () => {\n const parent = await callValue(via(step(\"parent\", [])))\n return parent ? makeElement(parent) : null\n })\n defineMethod(element, \"children\", async () => (await callValue(via(step(\"children\", [])))).map(makeElement))\n return Object.freeze(element)\n }\n const resolveElement = async (chain) => {\n const snapshot = await callValue(chain)\n return snapshot ? makeElement(snapshot) : null\n }\n const makeWindow = (snapshot) => {\n const win = {}\n copyFields(win, windowFields, snapshot)\n defineMethod(win, \"toString\", () => `<window ${snapshot.id} ${snapshot.app}>`)\n const via = (next) => [step(\"window\", [snapshot.id]), next]\n defineValueMethods(win, windowValueMethods, via)\n defineMethod(win, \"find\", async (query) => (await callValue(via(step(\"find\", [query])))).map(makeElement))\n defineMethod(win, \"ref\", (ref) => resolveElement([step(\"ref\", [ref])]))\n // The tree under one element of this window (`ax.snapshot` with a root); the parent snapshot's refs stay valid.\n defineMethod(win, \"drill\", (ref, options) =>\n callValue(via(step(\"ax\", [{ ...validateOptions(\"win.drill\", options), root: ref }]))),\n )\n defineMethod(\n win,\n \"menu\",\n Object.freeze({\n items: (path) => callValue(via(step(\"menu.items\", [path]))),\n select: (path, options) =>\n callValue(via(step(\"menu.select\", options === undefined ? [path] : [path, options]))),\n }),\n )\n return Object.freeze(win)\n }\n const resolveWindow = async (chain) => {\n const snapshot = await callValue(chain)\n return snapshot ? makeWindow(snapshot) : null\n }\n\n const computer = {}\n defineValueMethods(computer, desktopValueMethods, (next) => [next])\n computer.window = (selector) => resolveWindow([step(\"window\", [selector])])\n computer.display = async (selector) => {\n const snapshot = await callValue([step(\"display\", [selector])])\n const target = {}\n copyFields(target, [\"id\"], snapshot)\n defineValueMethods(target, displayValueMethods, (next) => [step(\"display\", [snapshot.id]), next])\n return Object.freeze(target)\n }\n computer.focusedWindow = () => resolveWindow([step(\"focusedWindow\", [])])\n computer.elementAt = (x, y) => resolveElement([step(\"elementAt\", [x, y])])\n computer.focusedElement = () => resolveElement([step(\"focusedElement\", [])])\n computer.ref = (ref) => resolveElement([step(\"ref\", [ref])])\n computer.clipboard = Object.freeze({\n read: () => callValue([step(\"clipboard.read\", [])]),\n write: (text) => callValue([step(\"clipboard.write\", [text])]),\n })\n computer.control = Object.freeze({\n acquire: (options) => callValue([step(\"control.acquire\", [options])]),\n release: () => callValue([step(\"control.release\", [])]),\n state: () => callValue([step(\"control.state\", [])]),\n })\n computer.run = async (fnOrCode, options) => {\n if (typeof fnOrCode !== \"function\" && typeof fnOrCode !== \"string\") {\n throw new TypeError(\"computer.run() expects a function or code string\")\n }\n const opts = validateOptions(\"computer.run\", options)\n let code = fnOrCode\n if (typeof fnOrCode === \"function\") {\n const args = trimArgs(Array.isArray(opts.args) ? opts.args : []).map((value) => `, ${runArgSource(value)}`)\n code = `return await (${serializeFunction(\"computer.run()\", fnOrCode)})({ desktop, wait, assert }${args.join(\"\")});`\n }\n const parameters = { action: \"run\", code }\n if (opts.read_only !== undefined) parameters.read_only = opts.read_only\n if (opts.timeout !== undefined) parameters.timeout = opts.timeout\n return invoke(parameters)\n }\n const EXPECTATION_KINDS = new Set([\n \"elementExists\",\n \"elementValue\",\n \"elementEnabled\",\n \"elementSelected\",\n \"windowExists\",\n \"windowGone\",\n \"windowBounds\",\n ])\n const TRUE_ATTRIBUTE = new Set([\"1\", \"true\", \"yes\"])\n const includesText = (value, part) =>\n part === undefined || String(value).toLocaleLowerCase().includes(String(part).toLocaleLowerCase())\n const matchesWindow = (win, selector) =>\n typeof selector === \"string\"\n ? win.id === selector\n : (selector.id === undefined || win.id === selector.id) &&\n includesText(win.app, selector.app) &&\n includesText(win.title, selector.title)\n const windowsMatching = async (selector) =>\n (await callValue([step(\"windows\", [])])).filter((win) => matchesWindow(win, selector))\n const readElement = (ref, method) =>\n callValue(method === undefined ? [step(\"ref\", [ref])] : [step(\"ref\", [ref]), step(method, [])])\n // One read of the state an expectation names; throws when the read fails.\n const holds = async (expectation) => {\n switch (expectation.kind) {\n case \"elementExists\":\n try {\n await readElement(expectation.ref)\n return expectation.exists ?? true\n } catch (error) {\n // A ref that no longer resolves answers the question (the element is gone); other failures do not.\n if (error?.code === \"COMPUTER_STALE_REF\") return !(expectation.exists ?? true)\n throw error\n }\n case \"elementValue\":\n return (await readElement(expectation.ref, \"value\")) === expectation.value\n case \"elementEnabled\":\n return (await readElement(expectation.ref)).enabled === (expectation.enabled ?? true)\n case \"elementSelected\": {\n const attributes = await readElement(expectation.ref, \"attributes\")\n return TRUE_ATTRIBUTE.has(String(attributes?.AXSelected ?? \"\").toLowerCase()) === (expectation.selected ?? true)\n }\n case \"windowExists\":\n return (await windowsMatching(expectation.window)).length > 0\n case \"windowGone\":\n return (await windowsMatching(expectation.window)).length === 0\n case \"windowBounds\": {\n const found = await windowsMatching(expectation.window)\n if (found.length > 1) throw new Error(`InvalidTarget: verify windowBounds matches ${found.length} windows`)\n const box = found[0]?.bounds ?? found[0]\n const tolerance = expectation.tolerance ?? 0\n return (\n box !== undefined &&\n [\"x\", \"y\", \"width\", \"height\"].every(\n (field) =>\n expectation.bounds[field] === undefined || Math.abs(box[field] - expectation.bounds[field]) <= tolerance,\n )\n )\n }\n }\n }\n // Deadline-bounded poll of read calls: never sends input and never waits past the deadline.\n computer.verify = async (expectation, options) => {\n if (expectation === null || typeof expectation !== \"object\" || !EXPECTATION_KINDS.has(expectation.kind)) {\n throw new TypeError(\n `computer.verify() expects an expectation whose kind is one of ${[...EXPECTATION_KINDS].join(\", \")}`,\n )\n }\n const opts = validateOptions(\"computer.verify\", options)\n const timeoutMs = opts.timeoutMs ?? 2000\n if (typeof timeoutMs !== \"number\" || !Number.isFinite(timeoutMs) || timeoutMs < 0) {\n throw new TypeError(\"computer.verify() timeoutMs must be a finite, non-negative number\")\n }\n const intervalMs = opts.intervalMs ?? 100\n if (typeof intervalMs !== \"number\" || !Number.isFinite(intervalMs) || intervalMs < 0) {\n throw new TypeError(\"computer.verify() intervalMs must be a finite, non-negative number\")\n }\n const interval = Math.max(intervalMs, 10)\n const started = Date.now()\n const deadline = started + timeoutMs\n let reads = 0\n for (;;) {\n let satisfied\n try {\n reads += 1\n satisfied = await holds(expectation)\n } catch (error) {\n return { status: \"unknown\", reads, elapsedMs: Date.now() - started, cause: String(error?.message ?? error) }\n }\n const now = Date.now()\n if (satisfied) return { status: \"satisfied\", reads, elapsedMs: now - started }\n if (now >= deadline) return { status: \"unsatisfied\", reads, elapsedMs: now - started }\n await new Promise((resolve) => setTimeout(resolve, Math.min(interval, deadline - now)))\n }\n }\n computer.capabilities = () => invoke({ action: \"capabilities\" })\n computer.close = async () => {\n await invoke({ action: \"close\" })\n }\n globalThis.computer = Object.freeze(computer)\n}\n",
|
|
3
3
|
"COMPUTER_PRELUDE_PYTHON": "# Eval-kernel `computer` global: sugar over the ordinary registered tool call `tool.computer(...)`.\n# senpi's Python kernel is synchronous, so every helper returns its value directly; `verify` alone repeats read\n# calls until its deadline. The method tuples in the generated region come from facade-manifest.json.\ndef _make_computer():\n import os\n import time\n\n # Children a cell starts inherit the marker, so an SDK inside them refuses to spawn a second engine.\n os.environ[\"SENPI_DESKTOP_HOST\"] = \"1\"\n\n # <generated:facade> from facade-manifest.json by scripts/generate-assets.ts; edit CHAIN_BINDINGS there, then `bun run generate`\n _DESKTOP_METHODS = (\"displays\", \"windows\", \"screenshot\", \"zoom\", \"click\", \"doubleClick\", \"move\", \"drag\", \"scroll\", \"type\", \"press\", \"holdKeys\", \"holdMouse\")\n _DISPLAY_METHODS = (\"screenshot\", \"zoom\", \"click\", \"doubleClick\", \"move\", \"drag\", \"scroll\", \"type\", \"press\", \"holdKeys\", \"holdMouse\")\n _WINDOW_METHODS = (\"screenshot\", \"observe\", \"zoom\", \"click\", \"doubleClick\", \"move\", \"drag\", \"scroll\", \"type\", \"press\", \"holdKeys\", \"holdMouse\", \"raise\", \"ax\")\n _ELEMENT_METHODS = (\"value\", \"setValue\", \"bounds\", \"attributes\", \"actions\", \"perform\", \"press\", \"click\", \"type\", \"focus\")\n # </generated:facade>\n\n def _arguments(args, kwargs):\n \"\"\"Positional args with trailing Nones dropped; keyword args become one trailing options dict.\"\"\"\n values = list(args)\n while values and values[-1] is None:\n values.pop()\n options = {key: value for key, value in kwargs.items() if value is not None}\n if options:\n values.append(options)\n return values\n\n def _invoke(arguments):\n # The tool result is {text, details?, images?, hasError?}: images display, details.value is the return value.\n # A failed call's details.value.code (COMPUTER_*) rides on the raised RuntimeError as `error.code`.\n result = tool.computer(**arguments)\n if result.get(\"hasError\"):\n details = result.get(\"details\")\n value = details.get(\"value\") if isinstance(details, dict) else None\n code = value.get(\"code\") if isinstance(value, dict) else None\n error = RuntimeError(result[\"text\"])\n error.code = code if isinstance(code, str) else None\n raise error\n for image in result.get(\"images\") or []:\n display(image)\n details = result.get(\"details\")\n return details.get(\"value\") if isinstance(details, dict) else None\n\n def _call(chain):\n return _invoke({\"action\": \"call\", \"chain\": chain})\n\n def _step(method, args, kwargs):\n return {\"method\": method, \"args\": _arguments(args, kwargs)}\n\n def _chain_method(method):\n def call(self, *args, **kwargs):\n return self._method(method, args, kwargs)\n\n call.__name__ = method\n return call\n\n def _install(cls, methods):\n # Python attribute name -> chain method name; `raise_` stands in for the keyword `raise`.\n for attribute, method in methods.items():\n setattr(cls, attribute, _chain_method(method))\n\n def _element(snapshot):\n return _Element(snapshot) if isinstance(snapshot, dict) else None\n\n def _window(snapshot):\n return _Window(snapshot) if isinstance(snapshot, dict) else None\n\n class _Element:\n __slots__ = (\"ref\", \"role\", \"nativeRole\", \"title\", \"description\", \"enabled\", \"focused\", \"childCount\")\n\n def __init__(self, snapshot):\n for field in self.__slots__:\n setattr(self, field, snapshot.get(field))\n\n def __repr__(self):\n return f\"<computer.Element ref={self.ref!r} role={self.role!r}>\"\n\n def _method(self, method, args, kwargs):\n return _call([_step(\"ref\", (self.ref,), {}), _step(method, args, kwargs)])\n\n def parent(self):\n return _element(self._method(\"parent\", (), {}))\n\n def children(self):\n return [_Element(snapshot) for snapshot in self._method(\"children\", (), {})]\n\n _install(_Element, {name: name for name in _ELEMENT_METHODS})\n\n class _Window:\n __slots__ = (\"id\", \"app\", \"title\", \"pid\", \"bounds\", \"focused\", \"menu\")\n\n def __init__(self, snapshot):\n for field in (\"id\", \"app\", \"title\", \"pid\", \"bounds\", \"focused\"):\n setattr(self, field, snapshot.get(field))\n self.menu = _Menu(self._method)\n\n def __repr__(self):\n return f\"<computer.Window id={self.id!r} app={self.app!r}>\"\n\n def _method(self, method, args, kwargs):\n return _call([_step(\"window\", (self.id,), {}), _step(method, args, kwargs)])\n\n def find(self, *args, **kwargs):\n return [_Element(snapshot) for snapshot in self._method(\"find\", args, kwargs)]\n\n def ref(self, ref):\n \"\"\"Resolve a live accessibility element by its `[ref=eN]` tag.\"\"\"\n return _element(_call([_step(\"ref\", (ref,), {})]))\n\n def drill(self, ref, **kwargs):\n \"\"\"The tree under one element of this window; the parent snapshot's refs stay valid.\"\"\"\n return self._method(\"ax\", ({**{k: v for k, v in kwargs.items() if v is not None}, \"root\": ref},), {})\n\n # `raise_` stands in for the keyword `raise`.\n _install(_Window, {(\"raise_\" if name == \"raise\" else name): name for name in _WINDOW_METHODS})\n\n class _Display:\n __slots__ = (\"id\",)\n\n def __init__(self, snapshot):\n self.id = snapshot[\"id\"]\n\n def _method(self, method, args, kwargs):\n return _call([_step(\"display\", (self.id,), {}), _step(method, args, kwargs)])\n\n _install(_Display, {name: name for name in _DISPLAY_METHODS})\n\n class _Menu:\n __slots__ = (\"_call\",)\n\n def __init__(self, call):\n self._call = call\n\n def __repr__(self):\n return \"<computer.Window.menu>\"\n\n def items(self, path=None):\n return self._call(\"menu.items\", (path,), {})\n\n def select(self, path, delivery=None):\n args = (path,) if delivery is None else (path, {\"delivery\": delivery})\n return self._call(\"menu.select\", args, {})\n\n class _Clipboard:\n __slots__ = ()\n\n def __repr__(self):\n return \"<computer.clipboard>\"\n\n def read(self):\n return _call([_step(\"clipboard.read\", (), {})])\n\n def write(self, text):\n return _call([_step(\"clipboard.write\", (text,), {})])\n\n class _Control:\n __slots__ = ()\n\n def __repr__(self):\n return \"<computer.control>\"\n\n def acquire(self, *args, **kwargs):\n \"\"\"Ask the human for the foreground-control grant; returns { active }.\"\"\"\n return _call([_step(\"control.acquire\", args, kwargs)])\n\n def release(self):\n \"\"\"Release the foreground-control grant.\"\"\"\n return _call([_step(\"control.release\", (), {})])\n\n def state(self):\n \"\"\"Read the foreground-control grant state.\"\"\"\n return _call([_step(\"control.state\", (), {})])\n\n _EXPECTATION_KINDS = (\"elementExists\", \"elementValue\", \"elementEnabled\", \"elementSelected\", \"windowExists\", \"windowGone\", \"windowBounds\")\n\n def _elapsed(started):\n return round((time.monotonic() - started) * 1000)\n\n def _includes(value, part):\n return part is None or str(part).lower() in str(value).lower()\n\n def _windows_matching(selector):\n def matches(win):\n if isinstance(selector, str):\n return win.get(\"id\") == selector\n return (selector.get(\"id\") is None or win.get(\"id\") == selector[\"id\"]) and _includes(win.get(\"app\"), selector.get(\"app\")) and _includes(win.get(\"title\"), selector.get(\"title\"))\n\n return [win for win in _call([_step(\"windows\", (), {})]) or [] if matches(win)]\n\n def _read_element(ref, method=None):\n chain = [_step(\"ref\", (ref,), {})]\n if method is not None:\n chain.append(_step(method, (), {}))\n return _call(chain)\n\n def _holds(expectation):\n \"\"\"One read of the state an expectation names; raises when the read fails.\"\"\"\n kind = expectation[\"kind\"]\n if kind == \"elementExists\":\n wanted = expectation.get(\"exists\", True)\n try:\n _read_element(expectation[\"ref\"])\n return wanted\n except RuntimeError as error:\n # A ref that no longer resolves answers the question (the element is gone); other failures do not.\n if getattr(error, \"code\", None) == \"COMPUTER_STALE_REF\":\n return not wanted\n raise\n if kind == \"elementValue\":\n return _read_element(expectation[\"ref\"], \"value\") == expectation[\"value\"]\n if kind == \"elementEnabled\":\n return (_read_element(expectation[\"ref\"]) or {}).get(\"enabled\") == expectation.get(\"enabled\", True)\n if kind == \"elementSelected\":\n attributes = _read_element(expectation[\"ref\"], \"attributes\") or {}\n return (str(attributes.get(\"AXSelected\", \"\")).lower() in (\"1\", \"true\", \"yes\")) == expectation.get(\"selected\", True)\n found = _windows_matching(expectation[\"window\"])\n if kind == \"windowExists\":\n return len(found) > 0\n if kind == \"windowGone\":\n return len(found) == 0\n if len(found) > 1:\n raise RuntimeError(f\"InvalidTarget: verify windowBounds matches {len(found)} windows\")\n if not found:\n return False\n box = found[0].get(\"bounds\") or found[0]\n tolerance = expectation.get(\"tolerance\", 0)\n return all(value is None or abs(box[field] - value) <= tolerance for field, value in expectation[\"bounds\"].items())\n\n class _Computer:\n __slots__ = (\"clipboard\", \"control\")\n\n def __init__(self):\n self.clipboard = _Clipboard()\n self.control = _Control()\n\n def __repr__(self):\n return \"<computer>\"\n\n def _method(self, method, args, kwargs):\n return _call([_step(method, args, kwargs)])\n\n def window(self, *args, **kwargs):\n \"\"\"Resolve one window by opaque id or by `app`/`title` filter keywords.\"\"\"\n return _window(self._method(\"window\", args, kwargs))\n\n def display(self, selector):\n \"\"\"Resolve one display id, 'active', or 'all' without changing the session default.\"\"\"\n return _Display(self._method(\"display\", (selector,), {}))\n\n def focusedWindow(self):\n return _window(self._method(\"focusedWindow\", (), {}))\n\n def elementAt(self, x, y):\n return _element(self._method(\"elementAt\", (x, y), {}))\n\n def focusedElement(self):\n return _element(self._method(\"focusedElement\", (), {}))\n\n def ref(self, ref):\n \"\"\"Resolve a live accessibility element by its `[ref=eN]` tag.\"\"\"\n return _element(self._method(\"ref\", (ref,), {}))\n\n def run(self, code, *, read_only=None, timeout=None):\n \"\"\"Run a JavaScript function body in the persistent desktop session and return its value.\"\"\"\n if not isinstance(code, str):\n raise TypeError(\"computer.run() expects a JavaScript code string\")\n options = {\"read_only\": read_only, \"timeout\": timeout}\n return _invoke({\"action\": \"run\", \"code\": code, **{k: v for k, v in options.items() if v is not None}})\n\n def verify(self, expectation, *, timeoutMs=2000, intervalMs=100):\n \"\"\"Poll read calls until `expectation` holds or the deadline passes; never sends input.\"\"\"\n if not isinstance(expectation, dict) or expectation.get(\"kind\") not in _EXPECTATION_KINDS:\n raise TypeError(\"computer.verify() expects an expectation whose kind is one of \" + \", \".join(_EXPECTATION_KINDS))\n if not isinstance(timeoutMs, (int, float)) or timeoutMs != timeoutMs or timeoutMs < 0 or timeoutMs == float(\"inf\"):\n raise TypeError(\"computer.verify() timeoutMs must be a finite, non-negative number\")\n if not isinstance(intervalMs, (int, float)) or intervalMs != intervalMs or intervalMs < 0 or intervalMs == float(\"inf\"):\n raise TypeError(\"computer.verify() intervalMs must be a finite, non-negative number\")\n interval = max(intervalMs, 10) / 1000\n started = time.monotonic()\n deadline = started + timeoutMs / 1000\n reads = 0\n while True:\n reads += 1\n try:\n satisfied = _holds(expectation)\n except Exception as error:\n return {\"status\": \"unknown\", \"reads\": reads, \"elapsedMs\": _elapsed(started), \"cause\": str(error)}\n now = time.monotonic()\n if satisfied:\n return {\"status\": \"satisfied\", \"reads\": reads, \"elapsedMs\": _elapsed(started)}\n if now >= deadline:\n return {\"status\": \"unsatisfied\", \"reads\": reads, \"elapsedMs\": _elapsed(started)}\n time.sleep(min(interval, deadline - now))\n\n def capabilities(self):\n \"\"\"Native backend capabilities, permission state, stop path, and focus guard.\"\"\"\n return _invoke({\"action\": \"capabilities\"})\n\n def close(self):\n \"\"\"End the persistent desktop session; later calls fail.\"\"\"\n _invoke({\"action\": \"close\"})\n\n _install(_Computer, {name: name for name in _DESKTOP_METHODS})\n return _Computer()\n\n\ncomputer = _make_computer()\ndel _make_computer\n",
|
|
4
4
|
"COMPUTER_DECLARATIONS": "/** Input delivery: `background` targets the window without focusing it; `foreground` briefly activates it. */\ntype ComputerDelivery = \"background\" | \"foreground\"\n\n/** Options shared by every native input helper. */\ninterface ComputerDeliveryOptions {\n delivery?: ComputerDelivery\n}\n\n/** A bounded hold; input is always released before the call settles. */\ninterface ComputerHoldOptions extends ComputerDeliveryOptions {\n /** Finite seconds in 0..=100; cancellation or a safety stop may end it early. */\n readonly duration: number\n}\n\ninterface ComputerHoldMouseOptions extends ComputerHoldOptions {\n readonly button?: \"left\" | \"right\" | \"middle\"\n readonly keys?: readonly string[]\n readonly frameId?: string\n}\n\n/** Options for pointer clicks. */\ninterface ComputerClickOptions extends ComputerDeliveryOptions {\n button?: \"left\" | \"right\" | \"middle\"\n count?: number\n modifiers?: string[]\n}\n\n/** Options for pointer drags. */\ninterface ComputerDragOptions extends ComputerDeliveryOptions {\n modifiers?: string[]\n}\n\n/** Options for wheel scrolling at the pointer position; `dx`/`dy` are pixels, the same unit on every OS, and one mouse-wheel notch is about 40 px (so `dy: 120` scrolls about three notches). The direction is semantic and the same on every OS: a positive `dy` moves the view toward the end of the content (the content moves up) and a positive `dx` toward its right edge, regardless of the user's natural-scrolling setting. */\ninterface ComputerScrollOptions extends ComputerDeliveryOptions {\n dx?: number\n dy?: number\n}\n\n/** Options for capturing a screenshot; `silent` skips the auto-displayed image. */\ninterface ComputerScreenshotOptions {\n silent?: boolean\n /** Zoom rejects an id other than this target's latest full screenshot. */\n frameId?: string\n}\n\n/** Region in the last full screenshot's pixels; zoom pixels are not input coordinates. */\ninterface ComputerCaptureRegion {\n x: number\n y: number\n width: number\n height: number\n}\n\n/** Options for an accessibility-tree snapshot. */\ninterface ComputerAxOptions {\n /** Include nodes that are normally pruned as non-interactive. */\n all?: boolean\n maxDepth?: number\n maxNodes?: number\n /** Only nodes changed after this snapshot generation. */\n since?: number\n}\n\n/** A state `computer.verify` polls for with read calls. */\ntype ComputerExpectation =\n | { kind: \"elementExists\"; ref: string; exists?: boolean }\n | { kind: \"elementValue\"; ref: string; value: string }\n | { kind: \"elementEnabled\"; ref: string; enabled?: boolean }\n | { kind: \"elementSelected\"; ref: string; selected?: boolean }\n | { kind: \"windowExists\"; window: string | ComputerWindowFilter }\n | { kind: \"windowGone\"; window: string | ComputerWindowFilter }\n | { kind: \"windowBounds\"; window: string | ComputerWindowFilter; bounds: Partial<ComputerBounds>; tolerance?: number }\n\n/** `satisfied` before the deadline, `unsatisfied` at it, or `unknown` when a read failed. */\ninterface ComputerVerdict {\n status: \"satisfied\" | \"unsatisfied\" | \"unknown\"\n reads: number\n elapsedMs: number\n cause?: string\n}\n\n/** One window capture and AX snapshot, committed together. */\ninterface ComputerObserveOptions extends ComputerScreenshotOptions, ComputerAxOptions {}\n\ninterface ComputerObserveResult extends ComputerScreenshotResult {\n ax: string\n nodeCount: number\n truncated: boolean\n}\n\n/** Accessibility query matched against role, title, and value. */\ninterface ComputerAxQuery {\n role?: string\n title?: string\n value?: string\n limit?: number\n}\n\n/** Window filter matched case-insensitively against the owning app name and title. */\ninterface ComputerWindowFilter {\n app?: string\n title?: string\n}\n\n/** Rectangle in global logical desktop coordinates. */\ninterface ComputerBounds {\n x: number\n y: number\n width: number\n height: number\n}\n\n/** A native menu item snapshot; selection revalidates the command before dispatch. */\ninterface ComputerMenuItem {\n title: string\n path: string[]\n enabled: boolean\n checked: boolean\n hasSubmenu: boolean\n shortcut?: string | null\n}\n\n/** One capturable top-level window in global logical desktop coordinates. */\ninterface ComputerWindowInfo extends ComputerBounds {\n /** Opaque backend-defined id; never parse it. */\n id: string\n app: string\n title: string\n pid?: number | null\n focused: boolean\n /** Windows only: the window belongs to an elevated process, so input into it is refused. */\n elevated?: boolean | null\n}\n\n/** Monitor geometry in desktop coordinates and `display(\"all\")` composite pixels, not the active capture. */\ninterface ComputerDisplay extends ComputerBounds {\n id: string\n name: string\n scale: number\n pixelX: number\n pixelY: number\n pixelWidth: number\n pixelHeight: number\n isPrimary: boolean\n}\n\n/** One capture; later pointer `x`/`y` on the same target are pixels of this frame. */\ninterface ComputerScreenshotResult {\n target: string\n frameId: string\n /** Emitted image size. */\n width: number\n height: number\n /** Captured size before downscaling. */\n sourceWidth: number\n sourceHeight: number\n /** Input coordinates remain in the last full screenshot, including after zoom. */\n coordinateWidth: number\n coordinateHeight: number\n region?: ComputerCaptureRegion\n scale: number\n /** Full-resolution artifact, when the engine wrote one. */\n path?: string\n}\n\n/** Native desktop backend, permission state, and safety facts. */\ninterface ComputerCapabilities {\n /** Active native backend identifier. */\n backend: string\n /** Linux display-server kind when applicable. */\n displayServer?: string | null\n capture: boolean\n input: boolean\n /** Whether OS accessibility automation is available. */\n ax: boolean\n /** Whether input can target a background window. */\n backgroundWindowInput: boolean\n /** Whether the display-only virtual cursor is live now. */\n cursorOverlay: boolean\n deliveryModes: string[]\n capturePermission: string\n inputPermission: string\n axPermission: string\n displayCount: number\n /** Whether foreground delivery restores the previous front window and cursor. */\n focusGuard: boolean\n /** Live stop path: `global` (the user's stop chord), `host-relay`, or `none`; input is refused without one. */\n stopPath: string\n /** Why the stop path is not `global`, when it is not. */\n stopReason?: string | null\n /** Windows mandatory integrity level of the engine process. */\n integrityLevel?: string | null\n /** Input is refused while the screen is locked. */\n screenLocked: boolean\n /** Every display the session can capture is asleep (macOS); captures and input then fail with a note saying so. */\n displayAsleep?: boolean\n}\n\n/** Live accessibility element resolved from a snapshot ref; expired refs throw `StaleRef`. */\ninterface ComputerElement {\n /** Snapshot ref tag, e.g. `e5`. */\n readonly ref: string\n readonly role: string\n readonly nativeRole: string\n readonly title?: string\n readonly description?: string\n readonly enabled: boolean\n readonly focused: boolean\n readonly childCount: number\n value(): Promise<string | undefined>\n setValue(value: string): Promise<void>\n /** Bounds in global desktop coordinates, or null when the element has none. */\n bounds(): Promise<ComputerBounds | null>\n attributes(): Promise<Record<string, string>>\n actions(): Promise<string[]>\n perform(action: string): Promise<void>\n /** Perform the element's native press action; needs no screenshot. */\n press(): Promise<void>\n /** Click the element's center with native input. */\n click(options?: ComputerDeliveryOptions): Promise<void>\n /**\n * Type into this element without taking the user's focus (macOS): a native text field takes the text through its\n * own selection (`inserted`), any other element takes keys once it holds its app's keyboard focus (`keys`); an\n * element that never takes focus throws `BackgroundUnavailable` (`InputFailed` in the foreground) with nothing typed.\n */\n type(text: string, options?: ComputerDeliveryOptions): Promise<{ method: \"inserted\" | \"keys\" }>\n focus(): Promise<void>\n parent(): Promise<ComputerElement | null>\n children(): Promise<ComputerElement[]>\n}\n\n/** Native input helpers shared by desktop, display, and window targets; `x`/`y` are pixels of that target's latest screenshot. */\ninterface ComputerInputTarget {\n screenshot(options?: ComputerScreenshotOptions): Promise<ComputerScreenshotResult>\n /** Fresh native-detail crop; later clicks still use the last full screenshot's coordinates. */\n zoom(region: ComputerCaptureRegion, options?: ComputerScreenshotOptions): Promise<ComputerScreenshotResult>\n click(x: number, y: number, options?: ComputerClickOptions): Promise<void>\n doubleClick(x: number, y: number, options?: Omit<ComputerClickOptions, \"count\">): Promise<void>\n move(x: number, y: number): Promise<void>\n drag(points: Array<[number, number]>, options?: ComputerDragOptions): Promise<void>\n scroll(x: number, y: number, options?: ComputerScrollOptions): Promise<void>\n type(text: string, options?: ComputerDeliveryOptions): Promise<void>\n /** Key chord such as `\"cmd+shift+p\"` or `[\"cmd\", \"shift\", \"p\"]`. */\n press(chord: string | string[], options?: ComputerDeliveryOptions): Promise<void>\n /** Non-empty keys; press in order and release in reverse on every exit. */\n holdKeys(keys: readonly string[], options: ComputerHoldOptions): Promise<void>\n /** Uses the latest full frame. No pressed state escapes this call. */\n holdMouse(x: number, y: number, options: ComputerHoldMouseOptions): Promise<void>\n}\n\n/** A display target; `active` resolves focus again on each capture, `all` composites every display. */\ninterface ComputerDisplayTarget extends ComputerInputTarget {\n readonly id: string\n}\n\n/** Window handle resolved by `window`/`focusedWindow`; identity fields are a snapshot taken at resolution. */\ninterface ComputerWindow extends ComputerInputTarget {\n readonly id: string\n readonly app: string\n readonly title: string\n readonly pid?: number\n readonly bounds: ComputerBounds\n readonly focused: boolean\n raise(): Promise<void>\n readonly menu: {\n /** Inspect a menu path without activating the application (empty path = the menu bar). */\n items(path?: string[]): Promise<ComputerMenuItem[]>\n /**\n * Select one unambiguous enabled leaf command using the window's native menu context. Background (the\n * default) refuses an app with several windows; `delivery: \"foreground\"` raises and keys this window, so\n * multi-window apps work, and needs the human-confirmed grant (`computer.control.acquire`) first.\n */\n select(path: string[], options?: { delivery?: \"background\" | \"foreground\" }): Promise<void>\n }\n /** Formatted accessibility tree as one string, one node per line with `[ref=eN]` tags. */\n ax(options?: ComputerAxOptions): Promise<string>\n /** Atomic screenshot and AX text of this window; displays screenshot then AX unless silent. */\n observe(options?: ComputerObserveOptions): Promise<ComputerObserveResult>\n find(query: ComputerAxQuery): Promise<ComputerElement[]>\n ref(ref: string): Promise<ComputerElement | null>\n /** Formatted accessibility tree under one element of this window; the parent snapshot's refs stay valid. */\n drill(ref: string, options?: ComputerAxOptions): Promise<string>\n}\n\n/** Desktop helpers shared by the direct `computer` facade and the `desktop` object inside `computer.run`. */\ninterface ComputerDesktop extends ComputerInputTarget {\n displays(): Promise<ComputerDisplay[]>\n /** Resolve a display id, `\"active\"`, or `\"all\"` without changing the session default (active). */\n display(selector: string): Promise<ComputerDisplayTarget>\n windows(filter?: ComputerWindowFilter): Promise<ComputerWindowInfo[]>\n /** Resolve exactly one window by opaque id or filter; ambiguous filters throw listing candidates. */\n window(selector: string | ComputerWindowFilter): Promise<ComputerWindow>\n focusedWindow(): Promise<ComputerWindow | null>\n /** Element under a global desktop coordinate. */\n elementAt(x: number, y: number): Promise<ComputerElement | null>\n focusedElement(): Promise<ComputerElement | null>\n ref(ref: string): Promise<ComputerElement | null>\n readonly clipboard: {\n read(): Promise<string>\n write(text: string): Promise<void>\n }\n readonly control: {\n /** Ask the human for the foreground-control grant; returns `{ active }` (false when headless or refused). */\n acquire(options: { reason: string }): Promise<ComputerControlState>\n /** Release the foreground-control grant; belongs in `finally`. */\n release(): Promise<void>\n /** Read the foreground-control grant state. */\n state(): Promise<ComputerControlState>\n }\n /** Native backend capabilities, permission state, stop path, and focus guard. */\n capabilities(): Promise<ComputerCapabilities>\n}\n\n/** The foreground-control grant state (#9651). */\ninterface ComputerControlState {\n active: boolean\n reason?: string | null\n grantedAt?: string | null\n}\n\n/** Scope object passed as the first argument to a computer run function. */\ninterface ComputerRunScope {\n /** Persistent host-desktop facade with the same helpers as `computer`. */\n readonly desktop: ComputerDesktop\n /** Sleep for milliseconds or poll a predicate until truthy. */\n readonly wait: (\n msOrPredicate: number | (() => unknown),\n options?: {\n /** Maximum polling time in milliseconds. */\n timeout?: number\n /** Delay between predicate calls in milliseconds. */\n interval?: number\n },\n ) => Promise<unknown>\n /** Throw with `message` when `condition` is falsy. */\n readonly assert: (condition: unknown, message?: string) => void\n}\n\n/** Arguments and policy for code executed by `computer.run`. */\ninterface ComputerRunOptions {\n /** Positional arguments passed after the run-scope object: JSON data, functions, or RegExp values. */\n args?: unknown[]\n /** Allow desktop inspection while blocking desktop-facade input and mutation. */\n read_only?: boolean\n /** Execution timeout in seconds. */\n timeout?: number\n}\n\n/**\n * Session-scoped host-computer facade in JavaScript eval while the `computer` tool is active. Every helper is one\n * `tool.computer(...)` call, so it passes the same permission check as a direct tool call.\n */\ndeclare const computer: ComputerDesktop & {\n /** Run a serialized function in the persistent computer runtime for multi-step sequences. */\n run<R>(\n fn: (scope: ComputerRunScope, ...args: unknown[]) => R | Promise<R>,\n options?: ComputerRunOptions,\n ): Promise<Awaited<R>>\n /** Run a JavaScript function body in the persistent computer runtime. */\n run<R = unknown>(code: string, options?: ComputerRunOptions): Promise<R>\n /** End the persistent desktop session; later calls fail. */\n close(): Promise<void>\n /** Poll read calls until `expectation` holds or `timeoutMs` (default 2000) passes; never sends input. */\n verify(\n expectation: ComputerExpectation,\n options?: { timeoutMs?: number; intervalMs?: number },\n ): Promise<ComputerVerdict>\n}\n",
|
|
5
5
|
"COMPUTER_DOCUMENTATION": "computer → host desktop facade, experimental (present while the `computer` tool is active)\n Drives the REAL desktop: windows, screenshots, native input, OS accessibility (AX), clipboard. Not a browser; no DOM.\n Find it with tool_search (\"computer\") or call `computer` by name; the global appears in the NEXT cell. The user controls it with `/computer on|off|status|stop|resume` and `/computer cursor on|off` (default on, display-only).\n Every helper is one `tool.computer({ action: \"call\", chain })` call. Permission tiers: inspection needs `computer:read`, input and mutation need `computer:exec`; a denied call throws.\n JS: `await` every helper. Python: sync, same names, keyword args become the trailing options object, `win.raise_()` stands in for `raise`.\ncomputer.displays() → ComputerDisplay[]\n All known monitors; pixel rectangles describe the all-display composite, not the default active screenshot.\ncomputer.display(id | \"active\" | \"all\") → ComputerDisplayTarget\n A handle with id, screenshot(), click(), doubleClick(), move(), drag(), scroll(), type(), press(). Each capture/input targets that display without changing the session default. Active re-resolves focus at capture time; all composites every display.\ncomputer.windows({ app?, title? }?) → ComputerWindowInfo[]\n Case-insensitive substring match on app and title.\ncomputer.window(idOrFilter) → ComputerWindow\n Exactly one window; zero or several matches throw listing candidates. Handle fields: id, app, title, pid, bounds, focused.\ncomputer.focusedWindow() → ComputerWindow | null\ncomputer.screenshot({ silent? }?) / win.screenshot({ silent? }?) → { target, frameId, width, height, sourceWidth, sourceHeight, coordinateWidth, coordinateHeight, scale, path? }\n The root captures the focused monitor by default (primary fallback), not the all-display composite. Auto-displays the image unless `silent: true`. Wayland uses the first display the portal reports, not a known compositor primary.\ncomputer.zoom({ x, y, width, height }, { silent?, frameId? }?) / win.zoom(...) → { target, frameId, width, height, sourceWidth, sourceHeight, coordinateWidth, coordinateHeight, region, scale, path? }\n Fresh native-detail crop of a region in the SAME target's last full screenshot. Desktop/display zoom pins the displays that full frame captured, even after focus moves. Zoom pixels are NOT input coordinates: later clicks still use the last full screenshot's coordinateWidth/coordinateHeight and frameId. A missing/stale full frame or invalid rectangle throws InvalidCoordinateFrame; take a new full screenshot. Same helper on display handles.\ncomputer.click(x, y, { button?, count?, modifiers?, delivery? }?) / win.click(...) → None\ncomputer.doubleClick(x, y, opts?) / computer.move(x, y) / computer.drag([[x, y], …], { modifiers?, delivery? }?) / computer.scroll(x, y, { dx?, dy?, delivery? }?) → None\n Same helpers on a window handle: win.doubleClick, win.move, win.drag, win.scroll.\n dx/dy are pixels, the same unit on every OS; one mouse-wheel notch is about 40 px, so dy: 120 scrolls about three notches.\n Scroll direction is semantic and the same on every OS: positive dy moves the view toward the end of the content (negative toward the start), positive dx toward the right edge; the natural-scrolling setting does not change it.\ncomputer.type(text, { delivery? }?) / computer.press(\"cmd+shift+p\" | keys[], { delivery? }?) → None\n Same helpers on a window handle: win.type, win.press.\ncomputer.holdKeys(keys[], { duration, delivery? }) / computer.holdMouse(x, y, { duration, button?, keys?, delivery?, frameId? }) → None\n Exec tier, also available on window and display handles and the desktop object inside computer.run. Duration is finite seconds in 0..=100; holdKeys refuses an empty list. Mouse coordinates use the latest full screenshot, never a zoom. Input is always released before the call settles, including errors, cancellation, deadlines and the user's safety stop; keys release in reverse order. Foreground delivery still needs the human-confirmed control grant. Existing run and engine deadlines can interrupt a hold early; give long holds an adequate run budget. Older engines refuse unsupported hold methods without affecting press/click.\nwin.raise() → None\n Brings the window to the front (exec tier). Unavailable on Wayland.\nwin.menu.items(path?) → ComputerMenuItem[]\n Read-only (read tier): lists the immediate children of the window's menu at `path`; no argument lists the menu bar. Item fields: title, path (native labels, ellipses included), enabled, checked, hasSubmenu, shortcut.\nwin.menu.select(path, { delivery? }?) → None\n Exec tier: invokes the leaf command `path` names. Matching prefers a case-insensitive exact title, otherwise compares titles ignoring a trailing `...` or `…`; each tier must match exactly one item. An ambiguous label, a disabled item anywhere in the path, a submenu as the leaf, or an untitled separator is refused and NOTHING is dispatched; the engine revalidates the command before the press. Background delivery (the default) refuses an app that has several windows, because the command would act on whichever window that app treats as key; pass `{ delivery: \"foreground\" }` (Python: `delivery='foreground'`) to raise and key this window first, which needs the human-confirmed grant (`computer.control.acquire`).\nwin.ax({ all?, maxDepth? }?) → str\n One formatted TEXT tree, one node per line with `[ref=eN]` tags; NEVER iterate or `.map` it.\nwin.observe({ silent?, all?, maxDepth?, maxNodes? }?) → ComputerObserveResult\n Read tier: one atomic window screenshot plus AX text, nodeCount and truncated. Displays the screenshot then AX text unless silent. The input frame and AX refs change only when both succeed and the reply can be delivered; failure or cancellation preserves the previous frame and delivered ref generations. Window handles only. An older engine without observe refuses it without changing screenshot() or ax().\nwin.find({ role?, title?, value?, limit? }) → ComputerElement[]\nwin.ref(\"e5\") / computer.ref(\"e5\") → ComputerElement | null\ncomputer.elementAt(x, y) / computer.focusedElement() → ComputerElement | null\n `elementAt` takes GLOBAL desktop coordinates, not screenshot pixels.\nel.value() / el.bounds() / el.attributes() / el.actions() / el.parent() / el.children() → reads\nel.setValue(text) / el.perform(action) / el.press() / el.click({ delivery? }?) / el.focus() → mutations\nel.type(text, { delivery? }?) → { method: \"inserted\" | \"keys\" }\n Types into THAT element without taking the user's focus (macOS). A native text field takes the text through its own selection and the value is read back exactly (`inserted`: no key sent, no focus moved, works in a multi-window app); any other element is given app-local focus and takes keys only once the app confirms it has focus (`keys`). An element that never takes focus throws `BackgroundUnavailable` (`InputFailed` in the foreground) naming where the focus is, with a ref; nothing was typed. A secure field's text never appears in an error. Foreground delivery raises the window first and needs the grant.\n Element fields: ref, role, nativeRole, title, description, enabled, focused, childCount. AX actions need no screenshot.\ncomputer.clipboard.read() → str\ncomputer.clipboard.write(text) → None\ncomputer.control.acquire({ reason }) → { active, reason?, grantedAt? }\n Ask the human for the foreground-control grant (exec tier). Headless, refusal, timeout, or interrupt returns { active: false }; a latched stop refuses Suspended. Foreground delivery and win.raise() are refused ControlRequired until this returns { active: true }.\ncomputer.control.release() → None\n Release the grant; belongs in `finally`. Interrupts, task completion, session shutdown, and a failed run also revoke it.\ncomputer.control.state() → { active, reason?, grantedAt? }\ncomputer.run(fnOrCode, { args?, read_only?, timeout? }?) → value\n One multi-step JS run in the persistent desktop session. Functions receive `{ desktop, wait, assert }` (`desktop` = same helpers) and cannot capture cell closures; `args` pass JSON data, functions, RegExp. Python passes a JS code string only. `read_only: true` needs `computer:read` and blocks mutation; `timeout` is seconds. Not sandboxed.\ncomputer.capabilities() → { backend, capture, input, ax, backgroundWindowInput, cursorOverlay, deliveryModes, *Permission, stopPath, stopReason?, focusGuard, screenLocked, displayAsleep, … }\n `stopPath` is `global` when the user's stop chord is armed; with `none`, input is refused. `focusGuard` says whether foreground delivery restores the previous front window and cursor. `displayAsleep` (macOS) is true when every display of the session sleeps; the engine keeps the display awake while you act, and a failure that ends `(the screen is locked)` or `(the display is asleep)` needs the user to unlock or wake the Mac, not a retry.\ncomputer.close() → None\n Ends the desktop session; later calls fail.\nRules:\n Observe once per turn before interacting with an app (one screenshot or `ax()` of the target), act, then observe again only when you need fresh state; never re-screenshot after every action.\n PREFER AX over pixels: `win.ax()` → `el.press()` / `el.click()` / `el.type()` / `el.setValue()`.\n Pointer x,y are pixels in the MOST RECENT FULL screenshot of the SAME target; zoom leaves that frame unchanged. AX coordinates are global desktop coordinates; NEVER mix them. `InvalidCoordinateFrame` → re-screenshot that target.\n `AxUnconfirmed` from an AX action, `setValue`, `el.type()` or focus means the app got the request but never answered (often a modal dialog opened): it may already have taken effect, so observe the window before any retry; NEVER repeat it blindly.\n By default (`computer.intervention: \"continue\"`) your input never waits for the user to pause and their keys and clicks do not stop it mid-send, with two exceptions: background keys into the frontmost app throw `BackgroundUnavailable` with nothing sent while the user pressed a key or clicked in that app within the last 1.5 s (retry once they pause), and the user's stop chord still suspends input, mid-send too (the report's `delivered` says how much was sent). `UserIntervened` (macOS, only under `\"pause\"`) means the user pressed a key or clicked in the app you were driving: either since your last read of its window (the input waited for them to pause up to 5 s, then nothing was sent) or during the input (input sent before their key may have landed, nothing more was sent). Read the window again (win.ax(), win.observe() or win.screenshot()) once they have paused for 5 s before acting on it; NEVER repeat the action as it was. Inspecting single elements does not count as that read.\n Each `win.ax()` starts a ref generation; refs from the 8 newest stay valid, older refs throw `StaleRef`. Re-snapshot; NEVER guess refs.\n Input defaults to `delivery: \"background\"`. On macOS it leaves the frontmost app, its focused window, the cursor and the destination of the user's next keystroke unchanged, but a clicked target window may rise directly under the user's front window. `BackgroundUnavailable` means use AX or retry with `delivery: \"foreground\"` (briefly activates the target, then the focus guard restores it). Never assume a background action landed without re-observing.\n REMOTE SCREENS (macOS): a window that shows another computer or device (Screen Sharing, iPhone Mirroring) receives key codes, not typed text, so `type()` into it sends the keys of the current keyboard layout: every character is mapped before anything is sent, and a character no key types throws `InvalidKey` with nothing typed; `el.type()` never inserts there. In the background, Screen Sharing takes Shift, Option, Control and Command from the physical keyboard, so text that needs them throws `BackgroundUnavailable` before the first key and a modifier the user holds stops the keys (use foreground delivery); iPhone Mirroring takes them as keys. A layout without key data throws `InputFailed`.\n Background keyboard input goes only to an app's SOLE window: typing or pressing keys into a process with several windows throws `BackgroundUnavailable`; use `el.type()` (inserted text needs no key window), AX `setValue`, or foreground delivery. With macOS key priming on, the target window is first made and proven the app's key window instead; reason `key_route_unproven` means that failed and nothing was sent.\n Chromium windows refuse ALL background input on Windows and X11: keystrokes, key combos, and plain mouse clicks alike throw `BackgroundUnavailable`. On Windows the reason is `Chromium requires input originating from the system input queue` (e.g. `'window <id> (Chrome_WidgetWin_1) drops background mouse_click events: Chromium requires input originating from the system input queue; retry with delivery:\"foreground\" or use ax actions'`); on X11 the message names the toolkit and its WM_CLASS instead (e.g. `'window <id> drops background mouse_click events: Chromium (WM_CLASS <class>) filters synthetic XSendEvent input; retry with delivery:\"foreground\" or use ax actions'`). On macOS only right-button input is affected: Chromium-family apps coerce synthetic background right-clicks and right-button drags to left-clicks, so the action may land as a left click; retry with `delivery: \"foreground\"` or use AX actions.\n The user's stop chord suspends all input. `Suspended` or `StopPathUnavailable` → stop acting and tell the user; only the user resumes (`/computer resume`).\n FOREGROUND CONTROL: input defaults to background and needs no grant. `delivery: \"foreground\"` and `win.raise()` (raising always takes the user's foreground) require the human-confirmed grant: call `await computer.control.acquire({ reason })` first (early in the run: it throws with under 8 s of the run's budget left), and act only when it returns `{ active: true }`; `ControlRequired` means acquire first, `InputBusy` means another session holds the grant (never stolen — continue in the background or retry after release). A failed run revokes the grant, so re-acquire after any error. Release with `computer.control.release()` in `finally`.\n Wayland: no per-window input and no `raise()`; use AX, or desktop input after the user focuses the target.\n",
|