[{"data":1,"prerenderedAt":504},["ShallowReactive",2],{"docs-page:\u002Fdocs\u002Ffiles-and-repositories":3,"docs-navigation-links":472},{"id":4,"title":5,"body":6,"description":464,"extension":465,"meta":466,"navigation":467,"path":468,"seo":469,"stem":470,"__hash__":471},"docs\u002Fdocs\u002Ffiles-and-repositories.md","Files and repositories",{"type":7,"value":8,"toc":457},"minimark",[9,14,23,136,201,204,207,211,214,268,271,275,278,329,339,343,362,365,373,376,380,383,447,450,453],[10,11,13],"h2",{"id":12},"repositories","Repositories",[15,16,17,18,22],"p",{},"Pass up to 32 repositories in ",[19,20,21],"code",{},"repos",":",[24,25,30],"pre",{"className":26,"code":27,"language":28,"meta":29,"style":29},"language-json shiki shiki-themes github-dark","{\n  \"repos\": [\n    {\n      \"url\": \"https:\u002F\u002Fgithub.com\u002Facme\u002Fbackend\",\n      \"branch\": \"main\",\n      \"token\": \"github_pat_...\"\n    },\n    {\n      \"url\": \"https:\u002F\u002Fgithub.com\u002Facme\u002Fpublic-docs\"\n    }\n  ]\n}\n","json","",[19,31,32,41,51,57,73,86,97,103,108,118,124,130],{"__ignoreMap":29},[33,34,37],"span",{"class":35,"line":36},"line",1,[33,38,40],{"class":39},"s95oV","{\n",[33,42,44,48],{"class":35,"line":43},2,[33,45,47],{"class":46},"sDLfK","  \"repos\"",[33,49,50],{"class":39},": [\n",[33,52,54],{"class":35,"line":53},3,[33,55,56],{"class":39},"    {\n",[33,58,60,63,66,70],{"class":35,"line":59},4,[33,61,62],{"class":46},"      \"url\"",[33,64,65],{"class":39},": ",[33,67,69],{"class":68},"sU2Wk","\"https:\u002F\u002Fgithub.com\u002Facme\u002Fbackend\"",[33,71,72],{"class":39},",\n",[33,74,76,79,81,84],{"class":35,"line":75},5,[33,77,78],{"class":46},"      \"branch\"",[33,80,65],{"class":39},[33,82,83],{"class":68},"\"main\"",[33,85,72],{"class":39},[33,87,89,92,94],{"class":35,"line":88},6,[33,90,91],{"class":46},"      \"token\"",[33,93,65],{"class":39},[33,95,96],{"class":68},"\"github_pat_...\"\n",[33,98,100],{"class":35,"line":99},7,[33,101,102],{"class":39},"    },\n",[33,104,106],{"class":35,"line":105},8,[33,107,56],{"class":39},[33,109,111,113,115],{"class":35,"line":110},9,[33,112,62],{"class":46},[33,114,65],{"class":39},[33,116,117],{"class":68},"\"https:\u002F\u002Fgithub.com\u002Facme\u002Fpublic-docs\"\n",[33,119,121],{"class":35,"line":120},10,[33,122,123],{"class":39},"    }\n",[33,125,127],{"class":35,"line":126},11,[33,128,129],{"class":39},"  ]\n",[33,131,133],{"class":35,"line":132},12,[33,134,135],{"class":39},"}\n",[137,138,139,155],"table",{},[140,141,142],"thead",{},[143,144,145,149,152],"tr",{},[146,147,148],"th",{},"Field",[146,150,151],{},"Required",[146,153,154],{},"Description",[156,157,158,176,189],"tbody",{},[143,159,160,166,169],{},[161,162,163],"td",{},[19,164,165],{},"url",[161,167,168],{},"yes",[161,170,171,172,175],{},"HTTPS or ",[19,173,174],{},"git@host:owner\u002Frepo"," repository URL",[143,177,178,183,186],{},[161,179,180],{},[19,181,182],{},"branch",[161,184,185],{},"no",[161,187,188],{},"Branch to check out; an empty value uses the repository default",[143,190,191,196,198],{},[161,192,193],{},[19,194,195],{},"token",[161,197,185],{},[161,199,200],{},"Credential for a private GitHub, GitLab, or Bitbucket repository",[15,202,203],{},"SSH-style URLs are normalized to HTTPS. Token injection is adapted for GitHub,\nGitLab, and Bitbucket. Public repositories need no token.",[15,205,206],{},"Repositories are per-turn values and are accepted when resuming a chat. The\nrepository payload and its tokens live on the queued job for that run rather\nthan being stored on the chat.",[10,208,210],{"id":209},"inline-input-files","Inline input files",[15,212,213],{},"Attach base64-encoded bytes:",[24,215,217],{"className":26,"code":216,"language":28,"meta":29,"style":29},"{\n  \"input_files\": [\n    {\n      \"name\": \"data.csv\",\n      \"content\": \"YSxiLGMKMSwyLDMK\"\n    }\n  ]\n}\n",[19,218,219,223,230,234,246,256,260,264],{"__ignoreMap":29},[33,220,221],{"class":35,"line":36},[33,222,40],{"class":39},[33,224,225,228],{"class":35,"line":43},[33,226,227],{"class":46},"  \"input_files\"",[33,229,50],{"class":39},[33,231,232],{"class":35,"line":53},[33,233,56],{"class":39},[33,235,236,239,241,244],{"class":35,"line":59},[33,237,238],{"class":46},"      \"name\"",[33,240,65],{"class":39},[33,242,243],{"class":68},"\"data.csv\"",[33,245,72],{"class":39},[33,247,248,251,253],{"class":35,"line":75},[33,249,250],{"class":46},"      \"content\"",[33,252,65],{"class":39},[33,254,255],{"class":68},"\"YSxiLGMKMSwyLDMK\"\n",[33,257,258],{"class":35,"line":88},[33,259,123],{"class":39},[33,261,262],{"class":35,"line":99},[33,263,129],{"class":39},[33,265,266],{"class":35,"line":105},[33,267,135],{"class":39},[15,269,270],{},"Epho stores the bytes privately and gives the sandbox a temporary download URL.",[10,272,274],{"id":273},"url-input-files","URL input files",[15,276,277],{},"If the file already has an accessible URL, avoid base64 overhead:",[24,279,281],{"className":26,"code":280,"language":28,"meta":29,"style":29},"{\n  \"input_files\": [\n    {\n      \"name\": \"spec.pdf\",\n      \"url\": \"https:\u002F\u002Ffiles.example.com\u002Fspec.pdf?signature=...\"\n    }\n  ]\n}\n",[19,282,283,287,293,297,308,317,321,325],{"__ignoreMap":29},[33,284,285],{"class":35,"line":36},[33,286,40],{"class":39},[33,288,289,291],{"class":35,"line":43},[33,290,227],{"class":46},[33,292,50],{"class":39},[33,294,295],{"class":35,"line":53},[33,296,56],{"class":39},[33,298,299,301,303,306],{"class":35,"line":59},[33,300,238],{"class":46},[33,302,65],{"class":39},[33,304,305],{"class":68},"\"spec.pdf\"",[33,307,72],{"class":39},[33,309,310,312,314],{"class":35,"line":75},[33,311,62],{"class":46},[33,313,65],{"class":39},[33,315,316],{"class":68},"\"https:\u002F\u002Ffiles.example.com\u002Fspec.pdf?signature=...\"\n",[33,318,319],{"class":35,"line":88},[33,320,123],{"class":39},[33,322,323],{"class":35,"line":99},[33,324,129],{"class":39},[33,326,327],{"class":35,"line":105},[33,328,135],{"class":39},[15,330,331,332,335,336,338],{},"Production URLs must use HTTPS. Each entry must contain exactly one of\n",[19,333,334],{},"content"," or ",[19,337,165],{},".",[10,340,342],{"id":341},"input-limits","Input limits",[344,345,346,350,353,356,359],"ul",{},[347,348,349],"li",{},"Maximum 20 files per turn.",[347,351,352],{},"Maximum 25 MiB for one decoded base64 file.",[347,354,355],{},"Maximum 50 MiB total decoded base64 content.",[347,357,358],{},"File names must be valid, unique basenames.",[347,360,361],{},"URL and base64 inputs may be used together in one request.",[15,363,364],{},"The runner downloads every attachment into:",[24,366,371],{"className":367,"code":369,"language":370,"meta":29},[368],"language-text","\u002Ftmp\u002Finputs\u002F\u003Cname>\n","text",[19,372,369],{"__ignoreMap":29},[15,374,375],{},"Epho also prepends the exact file paths to the prompt so the agent knows where\nto look.",[10,377,379],{"id":378},"output-artifacts","Output artifacts",[15,381,382],{},"A completed turn may expose files created by the agent:",[24,384,386],{"className":26,"code":385,"language":28,"meta":29,"style":29},"{\n  \"artifacts\": [\n    {\n      \"name\": \"report.csv\",\n      \"size\": 1240,\n      \"url\": \"https:\u002F\u002F...\"\n    }\n  ]\n}\n",[19,387,388,392,399,403,414,426,435,439,443],{"__ignoreMap":29},[33,389,390],{"class":35,"line":36},[33,391,40],{"class":39},[33,393,394,397],{"class":35,"line":43},[33,395,396],{"class":46},"  \"artifacts\"",[33,398,50],{"class":39},[33,400,401],{"class":35,"line":53},[33,402,56],{"class":39},[33,404,405,407,409,412],{"class":35,"line":59},[33,406,238],{"class":46},[33,408,65],{"class":39},[33,410,411],{"class":68},"\"report.csv\"",[33,413,72],{"class":39},[33,415,416,419,421,424],{"class":35,"line":75},[33,417,418],{"class":46},"      \"size\"",[33,420,65],{"class":39},[33,422,423],{"class":46},"1240",[33,425,72],{"class":39},[33,427,428,430,432],{"class":35,"line":88},[33,429,62],{"class":46},[33,431,65],{"class":39},[33,433,434],{"class":68},"\"https:\u002F\u002F...\"\n",[33,436,437],{"class":35,"line":99},[33,438,123],{"class":39},[33,440,441],{"class":35,"line":105},[33,442,129],{"class":39},[33,444,445],{"class":35,"line":110},[33,446,135],{"class":39},[15,448,449],{},"Artifacts live in private object storage. The returned URL is a short-lived\npresigned download, normally valid for about ten minutes. Call a response or\nevents read endpoint again to mint fresh URLs.",[15,451,452],{},"Internal agent-session snapshots are never exposed as user artifacts.",[454,455,456],"style",{},"html pre.shiki code .s95oV, html code.shiki .s95oV{--shiki-default:#E1E4E8}html pre.shiki code .sDLfK, html code.shiki .sDLfK{--shiki-default:#79B8FF}html pre.shiki code .sU2Wk, html code.shiki .sU2Wk{--shiki-default:#9ECBFF}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);}",{"title":29,"searchDepth":43,"depth":43,"links":458},[459,460,461,462,463],{"id":12,"depth":43,"text":13},{"id":209,"depth":43,"text":210},{"id":273,"depth":43,"text":274},{"id":341,"depth":43,"text":342},{"id":378,"depth":43,"text":379},"Give each turn source repositories and attached input files, then download its artifacts.","md",{},true,"\u002Fdocs\u002Ffiles-and-repositories",{"title":5,"description":464},"docs\u002Ffiles-and-repositories","M-S5YujEZtBZQB02kh34EtPycde5Tw2n42nUNDjhlss",[473,476,479,482,485,486,489,492,495,498,501],{"path":474,"title":475},"\u002Fdocs","Overview",{"path":477,"title":478},"\u002Fdocs\u002Fauthentication","Authentication",{"path":480,"title":481},"\u002Fdocs\u002Fchats-and-turns","Chats and turns",{"path":483,"title":484},"\u002Fdocs\u002Ferrors","Errors and statuses",{"path":468,"title":5},{"path":487,"title":488},"\u002Fdocs\u002Fharnesses-and-models","Harnesses and models",{"path":490,"title":491},"\u002Fdocs\u002Fmcp-and-environment","MCP and environment",{"path":493,"title":494},"\u002Fdocs\u002Fquickstart","Quickstart",{"path":496,"title":497},"\u002Fdocs\u002Fresources-and-billing","Resources and billing",{"path":499,"title":500},"\u002Fdocs\u002Fresuming-chats","Resuming chats",{"path":502,"title":503},"\u002Fdocs\u002Frunning-agents","Running agents",1785310516454]