[{"data":1,"prerenderedAt":1346},["ShallowReactive",2],{"doc-\u002Fen\u002Fdocs\u002Fguides\u002Fa2a":3,"doc-surround-\u002Fen\u002Fdocs\u002Fguides\u002Fa2a":1234,"doc-nav-en":1242},{"id":4,"title":5,"body":6,"description":1225,"extension":1226,"meta":1227,"navigation":269,"order":1228,"path":1229,"section":1230,"seo":1231,"stem":1232,"__hash__":1233},"docs_en\u002Fen\u002Fdocs\u002F02.guides\u002F20.a2a.md","A2A connections and task collaboration",{"type":7,"value":8,"toc":1217},"minimark",[9,13,17,22,25,45,69,83,86,121,128,132,143,180,235,245,281,284,288,295,304,333,352,356,366,484,515,537,735,738,742,749,891,914,1057,1093,1107,1111,1114,1195,1207,1213],[10,11,5],"h1",{"id":12},"a2a-connections-and-task-collaboration",[14,15,16],"p",{},"A2A connects agents; MCP connects tools. This guide covers the current LingXizhi local kernel endpoints, not cloud account APIs or every third-party A2A protocol revision. Registering an agent, recording a delegation, and actually executing a remote task are separate operations.",[18,19,21],"h2",{"id":20},"_1-start-the-kernel-and-configure-authentication","1. Start the kernel and configure authentication",[14,23,24],{},"Start the IDE\u002Fkernel, sign in, and verify your local license. The kernel normally listens on loopback and can choose another port after a conflict. Use the actual configuration or startup log instead of assuming a fixed port.",[14,26,27,28,32,33,36,37,40,41,44],{},"The global data directory is ",[29,30,31],"code",{},"LINGXIZHI_HOME",", or ",[29,34,35],{},"data"," beside the executable when unset. Its ",[29,38,39],{},"lxz.config.json"," contains ",[29,42,43],{},"server.auth_token","; the kernel generates and writes one when empty. Keep this file, tokens, and authenticated command output out of public logs.",[14,46,47,48,50,51,54,55,58,59,68],{},"The combined router checks the local ",[29,49,43],{},", a valid signed-in license, and ",[29,52,53],{},"A2A_API_KEY",". Both token checks read the same ",[29,56,57],{},"Authorization: Bearer ..."," header, so currently ",[60,61,62,63,65,66],"strong",{},"set ",[29,64,53],{}," to the same local ",[29,67,43],{}," in the environment that launches the kernel, then restart it. Setting an environment variable outside an already-running process has no effect. This token also grants access to other protected local APIs: share it only with trusted clients and keep the service off the public Internet.",[14,70,71,74,75,78,79,82],{},[29,72,73],{},"\u002F.well-known\u002Fagent-card.json"," is public. Business endpoints require the checks above. ",[29,76,77],{},"A2A_AUTH_ENABLED=false","\u002F",[29,80,81],{},"0"," is a development bypass, not the normal setup; it does not disable global authentication or license checks.",[14,84,85],{},"Replace these placeholders yourself; angle-bracket values are not valid credentials. Obtain your token securely from the local configuration rather than committing it into scripts:",[87,88,93],"pre",{"className":89,"code":90,"language":91,"meta":92,"style":92},"language-powershell shiki shiki-themes tokyo-night","$a2aBase = 'http:\u002F\u002F127.0.0.1:\u003Cactual-port>'\n$a2aToken = '\u003Clocal server.auth_token, also used as the startup A2A_API_KEY>'\n$headers = @{ Authorization = \"Bearer $a2aToken\" }\nInvoke-RestMethod \"$a2aBase\u002F.well-known\u002Fagent-card.json\"\n","powershell","",[29,94,95,103,109,115],{"__ignoreMap":92},[96,97,100],"span",{"class":98,"line":99},"line",1,[96,101,102],{},"$a2aBase = 'http:\u002F\u002F127.0.0.1:\u003Cactual-port>'\n",[96,104,106],{"class":98,"line":105},2,[96,107,108],{},"$a2aToken = '\u003Clocal server.auth_token, also used as the startup A2A_API_KEY>'\n",[96,110,112],{"class":98,"line":111},3,[96,113,114],{},"$headers = @{ Authorization = \"Bearer $a2aToken\" }\n",[96,116,118],{"class":98,"line":117},4,[96,119,120],{},"Invoke-RestMethod \"$a2aBase\u002F.well-known\u002Fagent-card.json\"\n",[14,122,123,124,127],{},"The card describes capabilities and endpoints; it does not prove your license or model credentials work. Set ",[29,125,126],{},"LXZ_PROJECT_ROOT"," in the kernel startup environment to the intended workspace. Otherwise tasks use the kernel process working directory.",[18,129,131],{"id":130},"_2-create-inspect-and-cancel-a-task","2. Create, inspect, and cancel a task",[14,133,134,135,138,139,142],{},"REST request fields use camelCase. Success is wrapped as ",[29,136,137],{},"{\"success\":true,\"data\":...}","; business errors commonly use HTTP 400 and ",[29,140,141],{},"{\"success\":false,\"error\":\"...\"}",". Creation only confirms submission, not successful execution.",[87,144,146],{"className":89,"code":145,"language":91,"meta":92,"style":92},"$body = @{ text = 'Analyze the project structure without modifying files' } | ConvertTo-Json\n$created = Invoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002Fcreate\" -Method Post -Headers $headers -ContentType 'application\u002Fjson' -Body $body\nif (-not $created.success) { throw $created.error }\n$taskId = $created.data.id\n$contextId = $created.data.contextId\nInvoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002F$taskId\" -Headers $headers\n",[29,147,148,153,158,163,168,174],{"__ignoreMap":92},[96,149,150],{"class":98,"line":99},[96,151,152],{},"$body = @{ text = 'Analyze the project structure without modifying files' } | ConvertTo-Json\n",[96,154,155],{"class":98,"line":105},[96,156,157],{},"$created = Invoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002Fcreate\" -Method Post -Headers $headers -ContentType 'application\u002Fjson' -Body $body\n",[96,159,160],{"class":98,"line":111},[96,161,162],{},"if (-not $created.success) { throw $created.error }\n",[96,164,165],{"class":98,"line":117},[96,166,167],{},"$taskId = $created.data.id\n",[96,169,171],{"class":98,"line":170},5,[96,172,173],{},"$contextId = $created.data.contextId\n",[96,175,177],{"class":98,"line":176},6,[96,178,179],{},"Invoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002F$taskId\" -Headers $headers\n",[14,181,182,40,184,187,188,187,191,187,194,187,197,200,201,204,205,208,209,187,212,187,215,187,218,200,221,224,225,187,228,200,231,234],{},[29,183,35],{},[29,185,186],{},"id",", ",[29,189,190],{},"contextId",[29,192,193],{},"status",[29,195,196],{},"history",[29,198,199],{},"artifacts",", and ",[29,202,203],{},"metadata",". ",[29,206,207],{},"status.state"," uses values such as ",[29,210,211],{},"submitted",[29,213,214],{},"working",[29,216,217],{},"completed",[29,219,220],{},"failed",[29,222,223],{},"canceled",". Inspect the terminal state and results; submission is not completion. The protocol also defines ",[29,226,227],{},"input-required",[29,229,230],{},"auth-required",[29,232,233],{},"rejected",", but not every execution path emits every state.",[14,236,237,238,240,241,244],{},"Optional ",[29,239,190],{}," associates subsequent tasks; optional ",[29,242,243],{},"skill"," selects a capability. Neither represents an admin role or cloud account permission.",[87,246,248],{"className":89,"code":247,"language":91,"meta":92,"style":92},"$followUp = @{ text = 'Continue by describing each directory'; contextId = $contextId } | ConvertTo-Json\n# Submit only when needed, to avoid starting duplicate work.\n# Invoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002Fcreate\" -Method Post -Headers $headers -ContentType 'application\u002Fjson' -Body $followUp\n\n# Cancel only a task you actually want to stop:\nInvoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002F$taskId\u002Fcancel\" -Method Post -Headers $headers\n",[29,249,250,255,260,265,271,276],{"__ignoreMap":92},[96,251,252],{"class":98,"line":99},[96,253,254],{},"$followUp = @{ text = 'Continue by describing each directory'; contextId = $contextId } | ConvertTo-Json\n",[96,256,257],{"class":98,"line":105},[96,258,259],{},"# Submit only when needed, to avoid starting duplicate work.\n",[96,261,262],{"class":98,"line":111},[96,263,264],{},"# Invoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002Fcreate\" -Method Post -Headers $headers -ContentType 'application\u002Fjson' -Body $followUp\n",[96,266,267],{"class":98,"line":117},[96,268,270],{"emptyLinePlaceholder":269},true,"\n",[96,272,273],{"class":98,"line":170},[96,274,275],{},"# Cancel only a task you actually want to stop:\n",[96,277,278],{"class":98,"line":176},[96,279,280],{},"Invoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002F$taskId\u002Fcancel\" -Method Post -Headers $headers\n",[14,282,283],{},"Cancellation does not undo files or external side effects already produced. A terminal task may no longer be cancellable; inspect the error instead of blindly submitting another task.",[18,285,287],{"id":286},"_3-receive-sse-events","3. Receive SSE events",[14,289,290,291,294],{},"Use ",[29,292,293],{},"GET \u002Fapi\u002Fa2a\u002Ftasks\u002F:id\u002Fstream"," for an existing task. The client must support a Bearer header. Browser-native EventSource cannot set it directly, and a query token does not bypass A2A authentication.",[87,296,298],{"className":89,"code":297,"language":91,"meta":92,"style":92},"curl.exe --no-buffer --header \"Authorization: Bearer $a2aToken\" \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002F$taskId\u002Fstream\"\n",[29,299,300],{"__ignoreMap":92},[96,301,302],{"class":98,"line":99},[96,303,297],{},[14,305,306,307,187,310,187,313,187,316,200,319,322,323,187,326,200,329,332],{},"Events include ",[29,308,309],{},"task-created",[29,311,312],{},"task-updated",[29,314,315],{},"task-completed",[29,317,318],{},"task-failed",[29,320,321],{},"task-canceled",". Parse ",[29,324,325],{},"event:",[29,327,328],{},"id:",[29,330,331],{},"data:"," fields. After disconnecting, query the task state: connection closure alone is not success. The REST stream does not promise durable history replay. A late subscriber may only observe terminal state.",[14,334,335,336,339,340,343,344,347,348,351],{},"To submit and immediately stream, POST a JSON-RPC ",[29,337,338],{},"tasks\u002FsendSubscribe"," request to ",[29,341,342],{},"\u002Fa2a\u002Fsubscribe",", which returns SSE. Alternatively call that method at ",[29,345,346],{},"\u002Fa2a\u002Fjsonrpc"," to obtain a subscription ID, then connect to ",[29,349,350],{},"\u002Fa2a\u002Fsse\u002F:subscription_id",". Task IDs and subscription IDs are different.",[18,353,355],{"id":354},"_4-json-rpc-requests","4. JSON-RPC requests",[14,357,358,361,362,365],{},[29,359,360],{},"POST \u002Fa2a\u002Fjsonrpc"," uses the same authentication. Replace ",[29,363,364],{},"taskId"," in this request body with a real ID:",[87,367,371],{"className":368,"code":369,"language":370,"meta":92,"style":92},"language-json shiki shiki-themes tokyo-night","{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"read-task-1\",\n  \"method\": \"tasks\u002Fget\",\n  \"params\": { \"taskId\": \"a2a_\u003Cactual-id>\" }\n}\n","json",[29,372,373,379,407,426,446,479],{"__ignoreMap":92},[96,374,375],{"class":98,"line":99},[96,376,378],{"class":377},"sgJMe","{\n",[96,380,381,385,389,392,395,398,402,404],{"class":98,"line":105},[96,382,384],{"class":383},"sAklC","  \"",[96,386,388],{"class":387},"s3R4Z","jsonrpc",[96,390,391],{"class":383},"\"",[96,393,394],{"class":383},":",[96,396,397],{"class":383}," \"",[96,399,401],{"class":400},"sPY7s","2.0",[96,403,391],{"class":383},[96,405,406],{"class":383},",\n",[96,408,409,411,413,415,417,419,422,424],{"class":98,"line":111},[96,410,384],{"class":383},[96,412,186],{"class":387},[96,414,391],{"class":383},[96,416,394],{"class":383},[96,418,397],{"class":383},[96,420,421],{"class":400},"read-task-1",[96,423,391],{"class":383},[96,425,406],{"class":383},[96,427,428,430,433,435,437,439,442,444],{"class":98,"line":117},[96,429,384],{"class":383},[96,431,432],{"class":387},"method",[96,434,391],{"class":383},[96,436,394],{"class":383},[96,438,397],{"class":383},[96,440,441],{"class":400},"tasks\u002Fget",[96,443,391],{"class":383},[96,445,406],{"class":383},[96,447,448,450,453,455,457,460,462,465,467,469,471,474,476],{"class":98,"line":170},[96,449,384],{"class":383},[96,451,452],{"class":387},"params",[96,454,391],{"class":383},[96,456,394],{"class":383},[96,458,459],{"class":377}," {",[96,461,397],{"class":383},[96,463,364],{"class":464},"sySf4",[96,466,391],{"class":383},[96,468,394],{"class":383},[96,470,397],{"class":383},[96,472,473],{"class":400},"a2a_\u003Cactual-id>",[96,475,391],{"class":383},[96,477,478],{"class":377}," }\n",[96,480,481],{"class":98,"line":176},[96,482,483],{"class":377},"}\n",[14,485,486,487,187,490,187,492,187,495,187,498,187,500,200,503,506,507,510,511,514],{},"Supported methods are ",[29,488,489],{},"tasks\u002Fsend",[29,491,441],{},[29,493,494],{},"tasks\u002Flist",[29,496,497],{},"tasks\u002Fcancel",[29,499,338],{},[29,501,502],{},"tasks\u002FpushNotification\u002Fset",[29,504,505],{},"agents\u002Fcard",". Inspect ",[29,508,509],{},"result"," or ",[29,512,513],{},"error",": HTTP 200 can still contain a JSON-RPC error.",[14,516,517,518,521,522,187,525,528,529,532,533,536],{},"Creation requires ",[29,519,520],{},"params.message"," with ",[29,523,524],{},"role",[29,526,527],{},"parts",", and a Unix-seconds ",[29,530,531],{},"timestamp",". A REST ",[29,534,535],{},"text"," body is not a valid JSON-RPC message:",[87,538,540],{"className":368,"code":539,"language":370,"meta":92,"style":92},"{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"create-task-1\",\n  \"method\": \"tasks\u002Fsend\",\n  \"params\": {\n    \"message\": {\n      \"role\": \"user\",\n      \"parts\": [{ \"type\": \"text\", \"text\": \"Analyze without modifying files\" }],\n      \"timestamp\": 1793232000\n    }\n  }\n}\n",[29,541,542,546,564,583,601,614,628,650,703,718,724,730],{"__ignoreMap":92},[96,543,544],{"class":98,"line":99},[96,545,378],{"class":377},[96,547,548,550,552,554,556,558,560,562],{"class":98,"line":105},[96,549,384],{"class":383},[96,551,388],{"class":387},[96,553,391],{"class":383},[96,555,394],{"class":383},[96,557,397],{"class":383},[96,559,401],{"class":400},[96,561,391],{"class":383},[96,563,406],{"class":383},[96,565,566,568,570,572,574,576,579,581],{"class":98,"line":111},[96,567,384],{"class":383},[96,569,186],{"class":387},[96,571,391],{"class":383},[96,573,394],{"class":383},[96,575,397],{"class":383},[96,577,578],{"class":400},"create-task-1",[96,580,391],{"class":383},[96,582,406],{"class":383},[96,584,585,587,589,591,593,595,597,599],{"class":98,"line":117},[96,586,384],{"class":383},[96,588,432],{"class":387},[96,590,391],{"class":383},[96,592,394],{"class":383},[96,594,397],{"class":383},[96,596,489],{"class":400},[96,598,391],{"class":383},[96,600,406],{"class":383},[96,602,603,605,607,609,611],{"class":98,"line":170},[96,604,384],{"class":383},[96,606,452],{"class":387},[96,608,391],{"class":383},[96,610,394],{"class":383},[96,612,613],{"class":377}," {\n",[96,615,616,619,622,624,626],{"class":98,"line":176},[96,617,618],{"class":383},"    \"",[96,620,621],{"class":464},"message",[96,623,391],{"class":383},[96,625,394],{"class":383},[96,627,613],{"class":377},[96,629,631,634,637,639,641,643,646,648],{"class":98,"line":630},7,[96,632,633],{"class":383},"      \"",[96,635,524],{"class":636},"su0L4",[96,638,391],{"class":383},[96,640,394],{"class":383},[96,642,397],{"class":383},[96,644,645],{"class":400},"user",[96,647,391],{"class":383},[96,649,406],{"class":383},[96,651,653,655,657,659,661,664,666,670,672,674,676,678,680,683,685,687,689,691,693,696,698,701],{"class":98,"line":652},8,[96,654,633],{"class":383},[96,656,527],{"class":636},[96,658,391],{"class":383},[96,660,394],{"class":383},[96,662,663],{"class":377}," [{",[96,665,397],{"class":383},[96,667,669],{"class":668},"sd1Qi","type",[96,671,391],{"class":383},[96,673,394],{"class":383},[96,675,397],{"class":383},[96,677,535],{"class":400},[96,679,391],{"class":383},[96,681,682],{"class":383},",",[96,684,397],{"class":383},[96,686,535],{"class":668},[96,688,391],{"class":383},[96,690,394],{"class":383},[96,692,397],{"class":383},[96,694,695],{"class":400},"Analyze without modifying files",[96,697,391],{"class":383},[96,699,700],{"class":377}," }]",[96,702,406],{"class":383},[96,704,706,708,710,712,714],{"class":98,"line":705},9,[96,707,633],{"class":383},[96,709,531],{"class":636},[96,711,391],{"class":383},[96,713,394],{"class":383},[96,715,717],{"class":716},"sOJ5S"," 1793232000\n",[96,719,721],{"class":98,"line":720},10,[96,722,723],{"class":377},"    }\n",[96,725,727],{"class":98,"line":726},11,[96,728,729],{"class":377},"  }\n",[96,731,733],{"class":98,"line":732},12,[96,734,483],{"class":377},[14,736,737],{},"The timestamp illustrates the format; generate current Unix seconds when sending. Push notification configuration initiates outbound HTTP calls. Check destinations and permitted data before using it; this is not a durable message queue.",[18,739,741],{"id":740},"_5-registration-discovery-trust-and-delegation","5. Registration, discovery, trust, and delegation",[14,743,744,745,748],{},"Register an external agent description with ",[29,746,747],{},"POST \u002Fapi\u002Fa2a\u002Fagents\u002Fregister",". This minimal body tests registration:",[87,750,752],{"className":368,"code":751,"language":370,"meta":92,"style":92},"{\n  \"id\": \"team-review-agent\",\n  \"name\": \"Team review agent\",\n  \"version\": \"1.0.0\",\n  \"organization\": \"example-team\",\n  \"description\": \"Internal review service\",\n  \"capabilities\": [],\n  \"endpoints\": []\n}\n",[29,753,754,758,777,797,817,837,857,873,887],{"__ignoreMap":92},[96,755,756],{"class":98,"line":99},[96,757,378],{"class":377},[96,759,760,762,764,766,768,770,773,775],{"class":98,"line":105},[96,761,384],{"class":383},[96,763,186],{"class":387},[96,765,391],{"class":383},[96,767,394],{"class":383},[96,769,397],{"class":383},[96,771,772],{"class":400},"team-review-agent",[96,774,391],{"class":383},[96,776,406],{"class":383},[96,778,779,781,784,786,788,790,793,795],{"class":98,"line":111},[96,780,384],{"class":383},[96,782,783],{"class":387},"name",[96,785,391],{"class":383},[96,787,394],{"class":383},[96,789,397],{"class":383},[96,791,792],{"class":400},"Team review agent",[96,794,391],{"class":383},[96,796,406],{"class":383},[96,798,799,801,804,806,808,810,813,815],{"class":98,"line":117},[96,800,384],{"class":383},[96,802,803],{"class":387},"version",[96,805,391],{"class":383},[96,807,394],{"class":383},[96,809,397],{"class":383},[96,811,812],{"class":400},"1.0.0",[96,814,391],{"class":383},[96,816,406],{"class":383},[96,818,819,821,824,826,828,830,833,835],{"class":98,"line":170},[96,820,384],{"class":383},[96,822,823],{"class":387},"organization",[96,825,391],{"class":383},[96,827,394],{"class":383},[96,829,397],{"class":383},[96,831,832],{"class":400},"example-team",[96,834,391],{"class":383},[96,836,406],{"class":383},[96,838,839,841,844,846,848,850,853,855],{"class":98,"line":176},[96,840,384],{"class":383},[96,842,843],{"class":387},"description",[96,845,391],{"class":383},[96,847,394],{"class":383},[96,849,397],{"class":383},[96,851,852],{"class":400},"Internal review service",[96,854,391],{"class":383},[96,856,406],{"class":383},[96,858,859,861,864,866,868,871],{"class":98,"line":630},[96,860,384],{"class":383},[96,862,863],{"class":387},"capabilities",[96,865,391],{"class":383},[96,867,394],{"class":383},[96,869,870],{"class":377}," []",[96,872,406],{"class":383},[96,874,875,877,880,882,884],{"class":98,"line":652},[96,876,384],{"class":383},[96,878,879],{"class":387},"endpoints",[96,881,391],{"class":383},[96,883,394],{"class":383},[96,885,886],{"class":377}," []\n",[96,888,889],{"class":98,"line":705},[96,890,483],{"class":377},[14,892,893,894,187,896,187,898,200,901,904,905,187,908,200,911,913],{},"Empty capabilities and endpoints do not enable remote execution. Real capabilities contain ",[29,895,783],{},[29,897,843],{},[29,899,900],{},"inputSchema",[29,902,903],{},"outputSchema","; endpoints contain ",[29,906,907],{},"url",[29,909,910],{},"protocol",[29,912,843],{},". Protocol values must match the current kernel enum.",[915,916,917,933],"table",{},[918,919,920],"thead",{},[921,922,923,927,930],"tr",{},[924,925,926],"th",{},"Operation",[924,928,929],{},"Method and path",[924,931,932],{},"Input or behavior",[934,935,936,963,977,990,1003,1028],"tbody",{},[921,937,938,942,948],{},[939,940,941],"td",{},"Discover",[939,943,944,945],{},"POST ",[29,946,947],{},"\u002Fapi\u002Fa2a\u002Fagents\u002Fdiscover",[939,949,950,953,954,187,956,187,958,187,961],{},[29,951,952],{},"{}"," to list; optional ",[29,955,243],{},[29,957,823],{},[29,959,960],{},"minTrustScore",[29,962,863],{},[921,964,965,968,974],{},[939,966,967],{},"Details",[939,969,970,971],{},"GET ",[29,972,973],{},"\u002Fapi\u002Fa2a\u002Fagents\u002F:id",[939,975,976],{},"Read a registered entry",[921,978,979,982,987],{},[939,980,981],{},"Health",[939,983,970,984],{},[29,985,986],{},"\u002Fapi\u002Fa2a\u002Fagents\u002F:id\u002Fhealth",[939,988,989],{},"Local status and trust information, not a live remote probe",[921,991,992,995,1000],{},[939,993,994],{},"Read trust",[939,996,970,997],{},[29,998,999],{},"\u002Fapi\u002Fa2a\u002Ftrust\u002F:id",[939,1001,1002],{},"Score, history, and factors",[921,1004,1005,1008,1013],{},[939,1006,1007],{},"Update trust",[939,1009,944,1010],{},[29,1011,1012],{},"\u002Fapi\u002Fa2a\u002Ftrust\u002Fupdate",[939,1014,1015,187,1018,1021,1022,187,1025],{},[29,1016,1017],{},"agentId",[29,1019,1020],{},"eventType","; optional ",[29,1023,1024],{},"details",[29,1026,1027],{},"responseMs",[921,1029,1030,1033,1038],{},[939,1031,1032],{},"Delegate",[939,1034,944,1035],{},[29,1036,1037],{},"\u002Fapi\u002Fa2a\u002Fdelegate",[939,1039,1040,187,1043,187,1046,1049,1050,1053,1054],{},[29,1041,1042],{},"toAgent",[29,1044,1045],{},"skillId",[29,1047,1048],{},"taskDescription","; optional Unix-seconds ",[29,1051,1052],{},"deadline"," and ",[29,1055,1056],{},"priority",[14,1058,1059,1060,1062,1063,1065,1066,1053,1068,1070,1071,187,1074,187,1077,187,1080,187,1083,187,1086,200,1089,1092],{},"Discovery gives ",[29,1061,243],{}," precedence over ",[29,1064,823],{},"; those filters are not automatically combined. ",[29,1067,960],{},[29,1069,863],{}," are subsequently applied. Trust events include ",[29,1072,1073],{},"success",[29,1075,1076],{},"failure",[29,1078,1079],{},"timeout",[29,1081,1082],{},"cancelled",[29,1084,1085],{},"security_violation",[29,1087,1088],{},"endorsement",[29,1090,1091],{},"complaint",". They are caller reports, not independent verification.",[14,1094,1095,1096,1053,1099,1102,1103,1106],{},"Delegation requires a target trust score of at least 30. The current REST delegation endpoint returns record identifiers such as ",[29,1097,1098],{},"requestId",[29,1100,1101],{},"chainId","; ",[60,1104,1105],{},"it does not itself dispatch a remote task",". Success does not mean a remote agent executed or completed work. Registry trust levels and trust-engine scores are also distinct stores, not automatically synchronized.",[18,1108,1110],{"id":1109},"limits-and-troubleshooting","Limits and troubleshooting",[14,1112,1113],{},"Tasks, contexts, registration, trust, and delegations are in memory and do not survive restart. Limits are 100 retained tasks, 200 subscriptions, 64 buffered events per subscription, and a 30-minute task monitor timeout. This is not durable external production orchestration. A2A request bodies are limited to 1 MiB.",[915,1115,1116,1126],{},[918,1117,1118],{},[921,1119,1120,1123],{},[924,1121,1122],{},"Symptom",[924,1124,1125],{},"What to check",[934,1127,1128,1136,1144,1155,1163,1171,1179,1187],{},[921,1129,1130,1133],{},[939,1131,1132],{},"Connection failure",[939,1134,1135],{},"Actual port, kernel process, loopback address; do not start by exposing a public listener",[921,1137,1138,1141],{},[939,1139,1140],{},"HTTP 401",[939,1142,1143],{},"Both Bearer values, startup environment, and whether a proxy removed the header",[921,1145,1146,1149],{},[939,1147,1148],{},"HTTP 503",[939,1150,1151,1152,1154],{},"After global authentication succeeds, check that startup ",[29,1153,53],{}," is configured",[921,1156,1157,1160],{},[939,1158,1159],{},"License rejection",[939,1161,1162],{},"Sign in through the IDE and check the license; an A2A key does not replace sign-in",[921,1164,1165,1168],{},[939,1166,1167],{},"HTTP 400\u002F422",[939,1169,1170],{},"Endpoint fields, camelCase, JSON-RPC envelope, and response error",[921,1172,1173,1176],{},[939,1174,1175],{},"Missing task",[939,1177,1178],{},"Distinguish task\u002Fsubscription IDs; check restart or FIFO eviction; REST lookup commonly returns 400, missing stream task returns 404",[921,1180,1181,1184],{},[939,1182,1183],{},"Task becomes failed",[939,1185,1186],{},"Model configuration, credentials, project path, and tool approvals; creation is not execution success",[921,1188,1189,1192],{},[939,1190,1191],{},"SSE disconnect",[939,1193,1194],{},"Query terminal state; do not recreate tasks indefinitely or assume full replay",[14,1196,1197,1202,1203],{},[1198,1199,1201],"a",{"href":1200},"\u002Fen\u002Fdocs\u002Freference\u002Fkernel-api","Kernel API"," · ",[1198,1204,1206],{"href":1205},"\u002Fen\u002Fdocs\u002Fguides\u002Fmcp","MCP configuration",[14,1208,1209],{},[1198,1210,1212],{"href":1211},"\u002Fen\u002Fdocs\u002Fguides\u002Fhooks","Hook automation",[1214,1215,1216],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .sgJMe, html code.shiki .sgJMe{--shiki-default:#9ABDF5}html pre.shiki code .sAklC, html code.shiki .sAklC{--shiki-default:#89DDFF}html pre.shiki code .s3R4Z, html code.shiki .s3R4Z{--shiki-default:#7AA2F7}html pre.shiki code .sPY7s, html code.shiki .sPY7s{--shiki-default:#9ECE6A}html pre.shiki code .sySf4, html code.shiki .sySf4{--shiki-default:#0DB9D7}html pre.shiki code .su0L4, html code.shiki .su0L4{--shiki-default:#7DCFFF}html pre.shiki code .sd1Qi, html code.shiki .sd1Qi{--shiki-default:#BB9AF7}html pre.shiki code .sOJ5S, html code.shiki .sOJ5S{--shiki-default:#FF9E64}",{"title":92,"searchDepth":105,"depth":105,"links":1218},[1219,1220,1221,1222,1223,1224],{"id":20,"depth":105,"text":21},{"id":130,"depth":105,"text":131},{"id":286,"depth":105,"text":287},{"id":354,"depth":105,"text":355},{"id":740,"depth":105,"text":741},{"id":1109,"depth":105,"text":1110},"Configure local authentication, discover agents, create and cancel tasks, and receive events","md",{},20,"\u002Fen\u002Fdocs\u002Fguides\u002Fa2a","Guides",{"title":5,"description":1225},"en\u002Fdocs\u002F02.guides\u002F20.a2a","0vxzV486HHTXVb8a5Og82gDgzXrZc2wpNYFoxk7vQOI",[1235,1239],{"title":1236,"path":1237,"stem":1238,"children":-1},"Terminal and Sandbox","\u002Fen\u002Fdocs\u002Fguides\u002Fterminal","en\u002Fdocs\u002F02.guides\u002F11.terminal",{"title":1240,"path":1211,"stem":1241,"children":-1},"Hook automation and blocking","en\u002Fdocs\u002F02.guides\u002F21.hooks",[1243],{"title":1244,"path":1245,"stem":1246,"children":1247,"page":1274},"En","\u002Fen","en",[1248],{"title":1249,"path":1250,"stem":1251,"children":1252,"page":1274},"Docs","\u002Fen\u002Fdocs","en\u002Fdocs",[1253,1275,1306,1323],{"title":1254,"path":1255,"stem":1256,"children":1257,"page":1274},"Getting Started","\u002Fen\u002Fdocs\u002Fgetting-started","en\u002Fdocs\u002F01.getting-started",[1258,1262,1266,1270],{"title":1259,"path":1260,"stem":1261},"Installation & Download","\u002Fen\u002Fdocs\u002Fgetting-started\u002Finstallation","en\u002Fdocs\u002F01.getting-started\u002F01.installation",{"title":1263,"path":1264,"stem":1265},"Register & Sign In","\u002Fen\u002Fdocs\u002Fgetting-started\u002Fregister-login","en\u002Fdocs\u002F01.getting-started\u002F02.register-login",{"title":1267,"path":1268,"stem":1269},"First Setup","\u002Fen\u002Fdocs\u002Fgetting-started\u002Ffirst-setup","en\u002Fdocs\u002F01.getting-started\u002F03.first-setup",{"title":1271,"path":1272,"stem":1273},"Manual Migration from VS Code \u002F Cursor","\u002Fen\u002Fdocs\u002Fgetting-started\u002Fmigrate-from-vscode","en\u002Fdocs\u002F01.getting-started\u002F04.migrate-from-vscode",false,{"title":1276,"path":1277,"stem":1278,"children":1279,"page":1274},"Feature Guides","\u002Fen\u002Fdocs\u002Fguides","en\u002Fdocs\u002F02.guides",[1280,1284,1288,1292,1296,1299,1303,1304,1305],{"title":1281,"path":1282,"stem":1283},"AI Chat and Inline Editing","\u002Fen\u002Fdocs\u002Fguides\u002Fai-chat","en\u002Fdocs\u002F02.guides\u002F05.ai-chat",{"title":1285,"path":1286,"stem":1287},"RUSH Deep Tasks","\u002Fen\u002Fdocs\u002Fguides\u002Frush","en\u002Fdocs\u002F02.guides\u002F06.rush",{"title":1289,"path":1290,"stem":1291},"FIM Completion","\u002Fen\u002Fdocs\u002Fguides\u002Ffim-completion","en\u002Fdocs\u002F02.guides\u002F07.fim-completion",{"title":1293,"path":1294,"stem":1295},"Semantic Code Graph","\u002Fen\u002Fdocs\u002Fguides\u002Fcode-graph","en\u002Fdocs\u002F02.guides\u002F08.code-graph",{"title":1297,"path":1205,"stem":1298},"MCP Tools and Configuration","en\u002Fdocs\u002F02.guides\u002F09.mcp",{"title":1300,"path":1301,"stem":1302},"Debugging","\u002Fen\u002Fdocs\u002Fguides\u002Fdebugging","en\u002Fdocs\u002F02.guides\u002F10.debugging",{"title":1236,"path":1237,"stem":1238},{"title":5,"path":1229,"stem":1232},{"title":1240,"path":1211,"stem":1241},{"title":1307,"path":1308,"stem":1309,"children":1310,"page":1274},"Models & Billing","\u002Fen\u002Fdocs\u002Fmodels-billing","en\u002Fdocs\u002F03.models-billing",[1311,1315,1319],{"title":1312,"path":1313,"stem":1314},"Supported Models","\u002Fen\u002Fdocs\u002Fmodels-billing\u002Fmodels","en\u002Fdocs\u002F03.models-billing\u002F12.models",{"title":1316,"path":1317,"stem":1318},"Plans and Credits","\u002Fen\u002Fdocs\u002Fmodels-billing\u002Fplans-quota","en\u002Fdocs\u002F03.models-billing\u002F13.plans-quota",{"title":1320,"path":1321,"stem":1322},"Bring Your Own API Key","\u002Fen\u002Fdocs\u002Fmodels-billing\u002Fbyok","en\u002Fdocs\u002F03.models-billing\u002F14.byok",{"title":1324,"path":1325,"stem":1326,"children":1327,"page":1274},"Reference & FAQ","\u002Fen\u002Fdocs\u002Freference","en\u002Fdocs\u002F04.reference",[1328,1332,1336,1338,1342],{"title":1329,"path":1330,"stem":1331},"Keyboard Shortcuts","\u002Fen\u002Fdocs\u002Freference\u002Fshortcuts","en\u002Fdocs\u002F04.reference\u002F15.shortcuts",{"title":1333,"path":1334,"stem":1335},"Configuration and Data Directory","\u002Fen\u002Fdocs\u002Freference\u002Fconfiguration","en\u002Fdocs\u002F04.reference\u002F16.configuration",{"title":1201,"path":1200,"stem":1337},"en\u002Fdocs\u002F04.reference\u002F17.kernel-api",{"title":1339,"path":1340,"stem":1341},"FAQ","\u002Fen\u002Fdocs\u002Freference\u002Ffaq","en\u002Fdocs\u002F04.reference\u002F18.faq",{"title":1343,"path":1344,"stem":1345},"Cloud REST API","\u002Fen\u002Fdocs\u002Freference\u002Fcloud-api","en\u002Fdocs\u002F04.reference\u002F19.cloud-api",1793596426863]