@qoder-ai/qoder-agent-sdk 1.0.1 → 1.0.3

package/dist/browser/index.js

@@ -1,9 +1,9 @@
-import{McpServer as Q}from"@modelcontextprotocol/sdk/server/mcp.js";function V(r){if(!r.name||typeof r.name!="string"||r.name.trim()==="")throw new Error("[createSdkMcpServer] Server name must be a non-empty string.");let e=new Q({name:r.name,version:r.version??"1.0.0"},{capabilities:{tools:r.tools&&r.tools.length>0?{}:void 0}});if(r.tools&&r.tools.length>0)for(let t of r.tools){if(!t.name||typeof t.name!="string"||t.name.trim()==="")throw new Error(`[createSdkMcpServer] Tool name must be a non-empty string in server "${r.name}".`);if(!t.description||typeof t.description!="string")throw new Error(`[createSdkMcpServer] Tool "${t.name}" must have a non-empty description string.`);try{e.registerTool(t.name,{description:t.description,inputSchema:t.inputSchema,...t.annotations?{annotations:t.annotations}:{}},t.handler)}catch(o){throw o instanceof Error&&o.message.includes("already registered")?new Error(`[createSdkMcpServer] Duplicate tool name "${t.name}" in server "${r.name}". Each tool name must be unique within a server.`):o}}return{type:"sdk",name:r.name,instance:e}}function B(r,e,t,o,n){return{name:r,description:e,inputSchema:t,handler:o,annotations:n?.annotations}}var v=class{queue=[];readResolve;readReject;isDone=!1;errorValue;started=!1;returnCallback;constructor(e){this.returnCallback=e}[Symbol.asyncIterator](){if(this.started)throw new Error("Stream can only be iterated once");return this.started=!0,this}async next(){if(this.queue.length>0)return{done:!1,value:this.queue.shift()};if(this.isDone)return{done:!0,value:void 0};if(this.errorValue!==void 0)throw this.errorValue;return new Promise((e,t)=>{this.readResolve=e,this.readReject=t})}enqueue(e){if(!this.isDone)if(this.readResolve){let t=this.readResolve;this.readResolve=void 0,this.readReject=void 0,t({done:!1,value:e})}else this.queue.push(e)}done(){if(this.isDone=!0,this.readResolve){let e=this.readResolve;this.readResolve=void 0,this.readReject=void 0,e({done:!0,value:void 0})}}error(e){if(this.errorValue=e,this.readReject){let t=this.readReject;this.readResolve=void 0,this.readReject=void 0,t(e)}}async return(){return this.isDone=!0,this.returnCallback?.(),{done:!0,value:void 0}}async throw(e){return this.error(e),{done:!0,value:void 0}}};var G=3e4,Z=3e4,k=class{options;ws=null;ready=!1;readyResolve;readyReject;readyPromise;messages=new v;keepAliveTimer;exitError;constructor(e){this.options=e,this.readyPromise=new Promise((t,o)=>{this.readyResolve=t,this.readyReject=o}),this.initialize()}initialize(){let e=new globalThis.WebSocket(this.options.url);this.ws=e;let t=setTimeout(()=>{if(!this.ready){let o=new Error("WebSocket connection timeout");this.readyReject?.(o),e.close()}},Z);e.onopen=()=>{clearTimeout(t),this.ready=!0,this.readyResolve?.(),this.options.authMessage&&e.send(JSON.stringify(this.options.authMessage)+`
+import{McpServer as W}from"@modelcontextprotocol/sdk/server/mcp.js";function Q(r){if(!r.name||typeof r.name!="string"||r.name.trim()==="")throw new Error("[createSdkMcpServer] Server name must be a non-empty string.");let e=new W({name:r.name,version:r.version??"1.0.0"},{capabilities:{tools:r.tools&&r.tools.length>0?{}:void 0}});if(r.tools&&r.tools.length>0)for(let t of r.tools){if(!t.name||typeof t.name!="string"||t.name.trim()==="")throw new Error(`[createSdkMcpServer] Tool name must be a non-empty string in server "${r.name}".`);if(!t.description||typeof t.description!="string")throw new Error(`[createSdkMcpServer] Tool "${t.name}" must have a non-empty description string.`);try{e.registerTool(t.name,{description:t.description,inputSchema:t.inputSchema,...t.annotations?{annotations:t.annotations}:{}},t.handler)}catch(s){throw s instanceof Error&&s.message.includes("already registered")?new Error(`[createSdkMcpServer] Duplicate tool name "${t.name}" in server "${r.name}". Each tool name must be unique within a server.`):s}}return{type:"sdk",name:r.name,instance:e}}function B(r,e,t,s,n){return{name:r,description:e,inputSchema:t,handler:s,annotations:n?.annotations}}var v=class{queue=[];readResolve;readReject;isDone=!1;errorValue;started=!1;returnCallback;constructor(e){this.returnCallback=e}[Symbol.asyncIterator](){if(this.started)throw new Error("Stream can only be iterated once");return this.started=!0,this}async next(){if(this.queue.length>0)return{done:!1,value:this.queue.shift()};if(this.isDone)return{done:!0,value:void 0};if(this.errorValue!==void 0)throw this.errorValue;return new Promise((e,t)=>{this.readResolve=e,this.readReject=t})}enqueue(e){if(!this.isDone)if(this.readResolve){let t=this.readResolve;this.readResolve=void 0,this.readReject=void 0,t({done:!1,value:e})}else this.queue.push(e)}done(){if(this.isDone=!0,this.readResolve){let e=this.readResolve;this.readResolve=void 0,this.readReject=void 0,e({done:!0,value:void 0})}}error(e){if(this.errorValue=e,this.readReject){let t=this.readReject;this.readResolve=void 0,this.readReject=void 0,t(e)}}async return(){return this.isDone=!0,this.returnCallback?.(),{done:!0,value:void 0}}async throw(e){return this.error(e),{done:!0,value:void 0}}};var G=3e4,Z=3e4,M=class{options;ws=null;ready=!1;readyResolve;readyReject;readyPromise;messages=new v;keepAliveTimer;exitError;constructor(e){this.options=e,this.readyPromise=new Promise((t,s)=>{this.readyResolve=t,this.readyReject=s}),this.initialize()}initialize(){let e=new globalThis.WebSocket(this.options.url);this.ws=e;let t=setTimeout(()=>{if(!this.ready){let s=new Error("WebSocket connection timeout");this.readyReject?.(s),e.close()}},Z);e.onopen=()=>{clearTimeout(t),this.ready=!0,this.readyResolve?.(),this.options.authMessage&&e.send(JSON.stringify(this.options.authMessage)+`
 `),this.keepAliveTimer=setInterval(()=>{e.readyState===WebSocket.OPEN&&e.send(JSON.stringify({type:"keep_alive"})+`
-`)},G)},e.onmessage=o=>{let n=String(o.data).split(`
-`);for(let s of n)if(s.trim())try{let i=JSON.parse(s);this.messages.enqueue(i)}catch{}},e.onerror=()=>{let o=new Error("WebSocket connection error");this.exitError=o,this.readyReject?.(o),this.messages.done()},e.onclose=o=>{this.ready=!1,this.keepAliveTimer&&(clearInterval(this.keepAliveTimer),this.keepAliveTimer=void 0),o.code!==1e3&&o.code!==1001&&(this.exitError=new Error(`WebSocket closed abnormally: ${o.code} ${o.reason}`)),this.messages.done()},this.options.abortController?.signal.addEventListener("abort",()=>{this.close()})}async write(e){this.ready||await this.readyPromise,this.ws?.send(e)}close(){this.keepAliveTimer&&(clearInterval(this.keepAliveTimer),this.keepAliveTimer=void 0),this.ws&&(this.ws.close(1e3),this.ws=null),this.messages.done()}isReady(){return this.ready}async*readMessages(){if(yield*this.messages,this.exitError)throw this.exitError}endInput(){}};var R=class extends Error{constructor(e="Operation was aborted"){super(e),this.name="AbortError"}};var M=class extends Error{timeoutMs;constructor(e){super(`resolveModel did not return within ${e}ms. Increase resolveModelTimeoutMs or ensure the callback resolves faster.`),this.name="ModelPolicyTimeoutError",this.timeoutMs=e}},C=class extends Error{cliProtocolVersion;sdkProtocolVersion;constructor(e,t){super(`Wire protocol major mismatch: CLI announced "${e}" but this SDK was built for "${t}". Upgrade either qodercli or @qoder-ai/qoder-agent-sdk so the major versions align.`),this.name="ProtocolVersionMismatchError",this.cliProtocolVersion=e,this.sdkProtocolVersion=t}};var q="1.0.0";var I="ExitPlanMode";import*as W from"fs";function T(r,e,t,o){return new Promise((n,s)=>{if(!("id"in e&&e.id!==null)){try{t.onmessage?.(e)}catch(l){s(l);return}n({jsonrpc:"2.0"});return}let a=`${r}:${e.id}`;o.set(a,{resolve:n,reject:s}),t.onmessage?t.onmessage(e):(o.delete(a),s(new Error(`No message handler registered for MCP server "${r}"`)))})}function E(r,e,t){if("id"in e&&e.id!==null){let o=`${r}:${e.id}`,n=t.get(o);if(n)return n.resolve(e),t.delete(o),!0}return!1}function x(r,e,t){let o=0,n=`${r}:`,s=Array.from(t.entries());for(let i of s){let[a,l]=i;a.startsWith(n)&&(l.reject(e),t.delete(a),o++)}return o}function D(){return Math.random().toString(36).substring(2,15)}function K(r,e){let t="type"in e&&!("subtype"in e)?{...e,subtype:e.type}:e;return{type:"control_request",request_id:r,request:t}}function j(r,e){return{type:"control_response",response:{subtype:"success",request_id:r,response:e}}}function A(r,e,t){return{type:"control_response",response:{subtype:"error",request_id:r,error:e,...t?{code:t}:{}}}}function O(r){return typeof r=="object"&&r!==null&&r.type==="control_response"}function N(r){return typeof r=="object"&&r!==null&&r.type==="control_request"}function U(r){return typeof r=="object"&&r!==null&&(r.type==="control_cancel_request"||r.type==="control_cancel")}function w(r){if(typeof r!="object"||r===null)return;let e=r,t=e.subtype;if(typeof t=="string")return t;let o=e.type;return typeof o=="string"?o:void 0}function L(r){if(typeof r!="object"||r===null)return!1;let e=r.type;return e==="keepalive"||e==="keep_alive"}function J(r){return typeof r=="object"&&r!==null&&r.type==="streamlined_text"}function H(r){return typeof r=="object"&&r!==null&&r.type==="streamlined_tool_use_summary"}function z(r){return typeof r=="object"&&r!==null&&r.type==="post_turn_summary"}function $(r){return typeof r=="object"&&r!==null&&r.type==="result"}var P=class{transport;inputStream;pendingRequests=new Map;pendingInboundRequests=new Map;hooks;hookCallbacks=new Map;nextHookCallbackId=0;sdkMcpServers;sdkMcpTransports;pendingMcpResponses;isSingleTurn;canUseTool;abortController;jsonSchema;initConfig;onElicitation;onAuthExpired;fetchJobToken;debugLogger;controlRequestTimeoutMs;resolveModel;resolveModelTimeoutMs;initResponse;initializationPromise;resultMessage;readLoopPromise;closed=!1;authExpiredFired=!1;protocolHandshakeValidated=!1;firstResultReceived=!1;firstResultReceivedResolve;constructor(e,t,o,n,s,i,a,l,p,c,u,h,m,d,g,f,b){if(this.transport=e,this.isSingleTurn=t,this.canUseTool=o,this.hooks=n??{},this.abortController=s,this.sdkMcpServers=i??new Map,this.sdkMcpTransports=m??new Map,this.pendingMcpResponses=d??new Map,this.jsonSchema=a,this.initConfig=l??{},this.onElicitation=p,this.onAuthExpired=u,this.fetchJobToken=g,this.debugLogger=c,this.controlRequestTimeoutMs=h??6e4,this.resolveModel=f,this.resolveModelTimeoutMs=b??500,this.inputStream=new v(()=>{this.close().catch(()=>{})}),this.readLoopPromise=this.readMessages().catch(y=>{this.inputStream.error(y)}),this.initializationPromise=this.performInitialize(),this.initializationPromise.catch(()=>{}),this.abortController){let y=this.abortController.signal;y.aborted?this.close().catch(()=>{}):y.addEventListener("abort",()=>{this.close().catch(()=>{})},{once:!0})}}[Symbol.asyncIterator](){return this}async next(){return this.inputStream.next()}async return(){return await this.close(),{done:!0,value:void 0}}async throw(e){return await this.inputStream.throw(e),{done:!0,value:void 0}}async readMessages(){let e;try{for await(let t of this.transport.readMessages()){if(this.closed)break;if(O(t)){this.handleControlResponse(t);continue}if(N(t)){this.handleControlRequest(t).catch(n=>{this.debugLogger?.log("[QueryRunner] Error handling control request:",n)});continue}if(U(t)){this.handleControlCancelRequest(t);continue}if(L(t)||J(t)||H(t)||z(t))continue;if($(t)){let n=t;this.resultMessage=n,this.firstResultReceived=!0,this.firstResultReceivedResolve?.(),this.firstResultReceivedResolve=void 0,this.inputStream.enqueue(n),this.isSingleTurn&&this.transport.endInput();continue}let o=t;if(o.type==="system"&&o.subtype==="init")try{this.validateProtocolHandshake(o)}catch(n){throw this.inputStream.error(n),n}if(this.onAuthExpired&&!this.authExpiredFired){let n=!1;(o.type==="auth_status"&&o.error||o.type==="assistant"&&o.error==="authentication_failed")&&(n=!0),n&&(this.authExpiredFired=!0,Promise.resolve(this.onAuthExpired()).catch(i=>{this.debugLogger?.log("[QueryRunner] onAuthExpired callback threw:",i)}))}this.inputStream.enqueue(o)}}catch(t){e=t}finally{let t=e instanceof Error?e:new Error("Transport closed");this.firstResultReceivedResolve?.(),this.firstResultReceivedResolve=void 0;for(let[,o]of this.pendingRequests)o.reject(t);this.pendingRequests.clear(),e!==void 0?this.inputStream.error(e):this.inputStream.done()}}async request(e,t){let o=D(),n=K(o,e),s=t?.timeoutMs??this.controlRequestTimeoutMs;return new Promise((i,a)=>{let l=null,p=()=>{l&&(clearTimeout(l),l=null)};this.pendingRequests.set(o,{resolve:c=>{p(),i(c)},reject:c=>{p(),a(c)}}),s>0&&Number.isFinite(s)&&(l=setTimeout(()=>{if(this.pendingRequests.has(o)){this.pendingRequests.delete(o);try{this.transport.write(JSON.stringify({type:"control_cancel_request",request_id:o})+`
-`)}catch(c){this.debugLogger?.log("[QueryRunner] Failed to send control_cancel_request on timeout:",c)}a(new Error(`Control request "${w(n.request)??"unknown"}" timed out after ${s}ms`))}},s));try{this.transport.write(JSON.stringify(n)+`
-`)}catch(c){p(),this.pendingRequests.delete(o),a(c)}})}handleControlResponse(e){let t=e.response,o=t.request_id,n=this.pendingRequests.get(o);n&&(this.pendingRequests.delete(o),t.subtype==="success"?n.resolve(t.response):(n.reject(new Error(t.error)),this.processPendingPermissionRequests(t.pending_permission_requests)))}processPendingPermissionRequests(e){if(e)for(let t of e)w(t.request)==="can_use_tool"&&this.handleControlRequest(t).catch(o=>{this.debugLogger?.log("[QueryRunner] Error handling pending permission request:",o)})}async handleControlRequest(e){let t=e.request_id,o=new AbortController;this.pendingInboundRequests.set(t,{abortController:o});try{let n=await this.awaitAbortable(this.processControlRequest(e,o.signal),o.signal);if(!o.signal.aborted){let s=j(t,n);this.transport.write(JSON.stringify(s)+`
-`)}}catch(n){if(!o.signal.aborted){let{error:s,code:i}=X(n),a=A(t,s,i);this.transport.write(JSON.stringify(a)+`
-`)}}finally{this.pendingInboundRequests.delete(t)}}handleControlCancelRequest(e){let t=this.pendingInboundRequests.get(e.request_id);t&&(t.abortController.abort(),this.pendingInboundRequests.delete(e.request_id))}throwIfAborted(e){if(e.aborted)throw new R}validateProtocolHandshake(e){if(this.protocolHandshakeValidated)return;this.protocolHandshakeValidated=!0;let t=e.protocol_version,o=q;if(!t){this.debugLogger?.log(`[QueryRunner] CLI did not announce protocol_version. This SDK was built for ${o}. Consider upgrading qodercli for the version handshake.`);return}let n=F(t),s=F(o);if(!n||!s){this.debugLogger?.log(`[QueryRunner] Could not parse protocol_version "${t}" or built-in "${o}"; skipping handshake.`);return}if(n.major!==s.major)throw new C(t,o);n.minor<s.minor&&this.debugLogger?.log(`[QueryRunner] CLI protocol_version ${t} is older than this SDK's ${o}. New optional fields may be absent.`)}async awaitAbortable(e,t){if(t.aborted)throw new R;return new Promise((o,n)=>{let s=()=>{n(new R)};t.addEventListener("abort",s,{once:!0}),e.then(i=>{t.removeEventListener("abort",s),o(i)},i=>{t.removeEventListener("abort",s),n(i)})})}async processControlRequest(e,t){this.throwIfAborted(t);let o=e.request,n=w(o),s=o;switch(n){case"fetch_job_token":{if(!this.fetchJobToken)throw new Error("job_token_unavailable: No fetchJobToken callback configured");let i=s.reason??"initial",a=s.session_id,l=e.request_id,p=await this.awaitAbortable(this.fetchJobToken({requestId:l,reason:i,sessionId:a},{signal:t}),t);if(!p?.token)throw new Error("job_token_unavailable: Host did not provide a Job Token");return this.debugLogger?.log(`[QueryRunner] fetch_job_token fulfilled: reason=${i}`),{token:p.token}}case"can_use_tool":case"permission_response":{let i=s.tool_name,a=s.input??s.tool_input??{};if(!this.canUseTool)throw new Error("canUseTool callback is not provided.");let l=s.tool_use_id,p=s.permission_suggestions??s.suggestions,c=s.blocked_path,u=s.decision_reason,h=s.decision_reason_type,m=s.classifier_approvable,d=s.title,g=s.display_name,f=s.description,b=s.agent_id,y=Y(i,s.details,s.plan_path,s.plan_content),S=await this.awaitAbortable(this.canUseTool(i,a,{signal:t,suggestions:p,blockedPath:c,decisionReason:u,decisionReasonType:h,classifierApprovable:m,title:d,displayName:g,description:f,toolUseID:l,agentID:b,exitPlanMode:y}),t);if(S.behavior==="deny"&&!S.message)throw new Error("Permission deny result must include a message.");return S.behavior==="allow"?{...S,updatedInput:S.updatedInput??a,toolUseID:l}:{...S,toolUseID:l}}case"hook_callback":{let i=s.callback_id;if(!i)throw new Error("Hook callback missing callback_id");return this.invokeRegisteredHookCallback(i,s.input,s.tool_use_id,t)}case"mcp_message":{let i=s.server_name,a=s.message,l=this.sdkMcpTransports.get(i);if(!l)throw new Error(`Unknown in-process MCP server: ${i}`);return{mcp_response:await this.awaitAbortable(T(i,a,l,this.pendingMcpResponses),t)}}case"elicitation":case"elicitation_response":return this.onElicitation?await this.awaitAbortable(this.onElicitation({serverName:s.mcp_server_name??"",message:s.message??s.prompt??"",mode:s.mode,url:s.url,elicitationId:s.elicitation_id,requestedSchema:s.requested_schema,title:s.title,displayName:s.display_name,description:s.description},{signal:t}),t):{action:"cancel"};case"get_model_policy":{if(!this.resolveModel)return{type:"get_model_policy"};let i={purpose:s.purpose,sessionId:s.sessionId,turnIndex:s.turnIndex,availableModels:s.models??[]},a=this.resolveModelTimeoutMs,l=Promise.resolve(this.resolveModel(i)),p,c=new Promise((m,d)=>{p=setTimeout(()=>{d(new M(a))},a)}),u;try{u=await this.awaitAbortable(Promise.race([l,c]),t)}finally{clearTimeout(p)}let h={type:"get_model_policy",model:typeof u.model=="string"?u.model:u.model.model,parameters:u.parameters};if(typeof u.model!="string"){let{model:m,...d}=u.model;h.custom_model={...d,style:d.style??"openai"}}return h}default:throw new Error(`Unhandled control request subtype: ${n??"unknown"}`)}}async initialize(){return this.initializationPromise||(this.initializationPromise=this.performInitialize()),this.initializationPromise}async performInitialize(){let e={type:"initialize",modelPolicyProvider:this.resolveModel!==void 0},t={};for(let[n,s]of Object.entries(this.hooks)){if(!s||s.length===0)continue;let i=[];for(let a of s){let l=a.hooks.map(p=>{let c=`hook_${this.nextHookCallbackId++}`;return this.hookCallbacks.set(c,p),c});l.length!==0&&i.push({matcher:a.matcher,hookCallbackIds:l,timeout:a.timeout})}i.length>0&&(t[n]=i)}Object.keys(t).length>0&&(e.hooks=t),this.initConfig.systemPrompt!==void 0&&(e.systemPrompt=this.initConfig.systemPrompt),this.initConfig.appendSystemPrompt!==void 0&&(e.appendSystemPrompt=this.initConfig.appendSystemPrompt),this.initConfig.planModeInstructions!==void 0&&(e.planModeInstructions=this.initConfig.planModeInstructions),this.initConfig.agents&&(e.agents=this.initConfig.agents),this.initConfig.promptSuggestions!==void 0&&(e.promptSuggestions=this.initConfig.promptSuggestions),this.initConfig.enableFileCheckpointing!==void 0&&(e.enableFileCheckpointing=this.initConfig.enableFileCheckpointing),this.jsonSchema&&(e.jsonSchema=this.jsonSchema),this.sdkMcpServers.size>0&&(e.sdkMcpServers=Array.from(this.sdkMcpServers.keys()));let o=await this.request(e);if(o&&typeof o=="object"){let n=o;this.initResponse=n}if(!this.initResponse)throw new Error("Failed to receive initialization response");return this.initResponse}async invokeRegisteredHookCallback(e,t,o,n){let s=this.hookCallbacks.get(e);if(!s)throw new Error(`Unknown hook callback: ${e}`);return await this.awaitAbortable(s(t,o,{signal:n}),n)??{continue:!0}}async initializationResult(){return this.initialize()}async streamInput(e){(async()=>{try{let t=0;for await(let o of e){if(this.closed)break;t+=1,this.transport.write(JSON.stringify(o)+`
-`)}t>0&&this.hasBidirectionalNeeds()&&await this.waitForFirstResult(),this.transport.endInput()}catch(t){this.debugLogger?.log("[QueryRunner] streamInput error:",t),this.transport.endInput()}})().catch(()=>{})}async interrupt(){await this.request({type:"interrupt"})}async setPermissionMode(e){await this.request({type:"set_permission_mode",mode:e==="yolo"?"bypassPermissions":e})}hasBidirectionalNeeds(){return this.sdkMcpTransports.size>0||Object.keys(this.hooks).length>0||this.canUseTool!==void 0||this.onElicitation!==void 0||this.resolveModel!==void 0}waitForFirstResult(){return this.firstResultReceived||this.closed?Promise.resolve():new Promise(e=>{if(this.abortController?.signal.aborted){e();return}this.firstResultReceivedResolve=e,this.abortController?.signal.addEventListener("abort",()=>e(),{once:!0})})}async setModel(e){await this.request({type:"set_model",model:e??""})}async applyFlagSettings(e){await this.request({type:"apply_flag_settings",settings:e})}async supportedCommands(){return(await this.initializationResult()).commands??[]}async getAvailableModels(){let e={subtype:"get_models"};return(await this.request(e))?.models??[]}async listByokProviders(){try{return(await this.request({type:"get_byok_config"}))?.providers??null}catch{return null}}async supportedAgents(){return(await this.initializationResult()).agents??[]}async accountInfo(){try{let t=await this.request({type:"account_info"});if(t?.account)return t.account}catch{}return(await this.initializationResult()).account??{}}async mcpServerStatus(){return(await this.request({type:"mcp_status"}))?.servers??[]}async getContextUsage(){return await this.request({type:"get_context_usage"})}async reloadPlugins(){return await this.request({type:"reload_plugins"})}async rewindFiles(e,t){let o={type:"rewind_files",user_message_id:e};t?.dryRun&&(o.dry_run=!0);let s=await this.request(o);if(!t?.dryRun&&s?.canRewind===!1)throw new Error(typeof s.error=="string"&&s.error.length>0?s.error:"Unable to rewind files.");return s}async seedReadState(e,t){await this.request({type:"seed_read_state",path:e,mtime:t})}async reconnectMcpServer(e){await this.request({type:"mcp_reconnect",serverName:e})}async toggleMcpServer(e,t){await this.request({type:"mcp_toggle",serverName:e,enabled:t})}async setMcpServers(e){return await this.request({type:"mcp_set_servers",servers:e})??{added:[],removed:[],errors:{}}}async injectMcpToken(e,t){await this.request({type:"mcp_inject_token",serverName:e,token:t})}async mcpAuthenticate(e,t){let o=await this.request({type:"mcp_authenticate",serverName:e,...t!==void 0?{redirectUri:t}:{}}),n=o?.requiresUserAction===!0,s=typeof o?.authUrl=="string"?o.authUrl:void 0;if(n&&s===void 0)throw new Error("mcp_authenticate response set requiresUserAction=true but did not include an authUrl");return n?{authUrl:s,requiresUserAction:!0}:{requiresUserAction:!1}}async mcpSubmitOAuthCallbackUrl(e,t){await this.request({type:"mcp_oauth_callback_url",serverName:e,callbackUrl:t})}async mcpClearAuth(e){await this.request({type:"mcp_clear_auth",serverName:e})}async close(){if(this.closed)return;this.closed=!0;for(let[,t]of this.pendingInboundRequests)t.abortController.abort();this.pendingInboundRequests.clear(),this.hookCallbacks.clear();let e=new Error("SDK closing");for(let[t,o]of this.sdkMcpTransports){try{await o.close()}catch(n){this.debugLogger?.log(`[QueryRunner] error closing SDK MCP transport "${t}":`,n)}x(t,e,this.pendingMcpResponses)}this.transport.close();try{await this.readLoopPromise}catch{}}async[Symbol.asyncDispose](){await this.close()}};function X(r){let e=r instanceof Error?r.message:String(r),t=typeof r=="object"&&r!==null?r.code:void 0,o=typeof t=="string"&&t.length>0?t:void 0,n=/^([a-z][a-z0-9_]*):\s*(.*)$/.exec(e);if(n){let s=o??n[1];return(!o||o===n[1])&&(e=n[2]||e),{error:e,code:s}}return o?{error:e,code:o}:{error:e}}function Y(r,e,t,o){if(r!==I)return;let n=e!==null&&typeof e=="object"?e:void 0,s=n?.type===I||n?.type==="ExitPlanMode",i=s&&typeof n?.planPath=="string"&&n.planPath.length>0?n.planPath:typeof t=="string"&&t.length>0?t:void 0,a=s&&typeof n?.planContent=="string"&&n.planContent.length>0?n.planContent:typeof o=="string"&&o.length>0?o:void 0;if(!a&&i&&(a=W.readFileSync(i,"utf8").trim()||void 0),!(!i&&!a))return{planPath:i,planContent:a}}function F(r){let e=/^(\d+)\.(\d+)(?:\.\d+)?(?:[-+].*)?$/.exec(r);return e?{major:Number(e[1]),minor:Number(e[2])}:null}var _=class{sendMcpMessage;isClosed=!1;onclose;onerror;onmessage;constructor(e){this.sendMcpMessage=e}async start(){}async send(e){if(this.isClosed)throw new Error("Transport is closed");this.sendMcpMessage(e)}async close(){this.isClosed||(this.isClosed=!0,this.onclose?.())}get closed(){return this.isClosed}};function ee(r){let{prompt:e,websocket:t,abortController:o,canUseTool:n,hooks:s,mcpServers:i,jsonSchema:a}=r,l=new Map,p=new Map,c=new Map;if(i)for(let[m,d]of Object.entries(i))if(d.type==="sdk"&&"instance"in d){let g=d.instance;l.set(m,g);let f=new _(b=>{E(m,b,c)});p.set(m,f),g.connect(f).catch(()=>{})}else throw new Error(`Browser SDK only supports SDK MCP servers. Server "${m}" has type "${d.type}".`);let u=new k({url:t.url,headers:t.headers,authMessage:t.authMessage,abortController:o}),h=new P(u,!0,n,s,o,l,a,{},void 0,void 0,void 0,void 0,p,c);return h.streamInput(e),h}export{V as createSdkMcpServer,ee as query,B as tool};
+`)},G)},e.onmessage=s=>{let n=String(s.data).split(`
+`);for(let o of n)if(o.trim())try{let i=JSON.parse(o);this.messages.enqueue(i)}catch{}},e.onerror=()=>{let s=new Error("WebSocket connection error");this.exitError=s,this.readyReject?.(s),this.messages.done()},e.onclose=s=>{this.ready=!1,this.keepAliveTimer&&(clearInterval(this.keepAliveTimer),this.keepAliveTimer=void 0),s.code!==1e3&&s.code!==1001&&(this.exitError=new Error(`WebSocket closed abnormally: ${s.code} ${s.reason}`)),this.messages.done()},this.options.abortController?.signal.addEventListener("abort",()=>{this.close()})}async write(e){this.ready||await this.readyPromise,this.ws?.send(e)}close(){this.keepAliveTimer&&(clearInterval(this.keepAliveTimer),this.keepAliveTimer=void 0),this.ws&&(this.ws.close(1e3),this.ws=null),this.messages.done()}isReady(){return this.ready}async*readMessages(){if(yield*this.messages,this.exitError)throw this.exitError}endInput(){}};var R=class extends Error{constructor(e="Operation was aborted"){super(e),this.name="AbortError"}};var b=class extends Error{timeoutMs;constructor(e){super(`resolveModel did not return within ${e}ms. Increase resolveModelTimeoutMs or ensure the callback resolves faster.`),this.name="ModelPolicyTimeoutError",this.timeoutMs=e}},C=class extends Error{cliProtocolVersion;sdkProtocolVersion;constructor(e,t){super(`Wire protocol major mismatch: CLI announced "${e}" but this SDK was built for "${t}". Upgrade either qodercli or @qoder-ai/qoder-agent-sdk so the major versions align.`),this.name="ProtocolVersionMismatchError",this.cliProtocolVersion=e,this.sdkProtocolVersion=t}};var T="1.0.0";var I="ExitPlanMode";import*as V from"fs";function q(r,e,t,s){return new Promise((n,o)=>{if(!("id"in e&&e.id!==null)){try{t.onmessage?.(e)}catch(l){o(l);return}n({jsonrpc:"2.0"});return}let a=`${r}:${e.id}`;s.set(a,{resolve:n,reject:o}),t.onmessage?t.onmessage(e):(s.delete(a),o(new Error(`No message handler registered for MCP server "${r}"`)))})}function E(r,e,t){if("id"in e&&e.id!==null){let s=`${r}:${e.id}`,n=t.get(s);if(n)return n.resolve(e),t.delete(s),!0}return!1}function D(r,e,t){let s=0,n=`${r}:`,o=Array.from(t.entries());for(let i of o){let[a,l]=i;a.startsWith(n)&&(l.reject(e),t.delete(a),s++)}return s}function x(){return Math.random().toString(36).substring(2,15)}function K(r,e){let t="type"in e&&!("subtype"in e)?{...e,subtype:e.type}:e;return{type:"control_request",request_id:r,request:t}}function A(r,e){return{type:"control_response",response:{subtype:"success",request_id:r,response:e}}}function j(r,e,t){return{type:"control_response",response:{subtype:"error",request_id:r,error:e,...t?{code:t}:{}}}}function O(r){return typeof r=="object"&&r!==null&&r.type==="control_response"}function N(r){return typeof r=="object"&&r!==null&&r.type==="control_request"}function U(r){return typeof r=="object"&&r!==null&&(r.type==="control_cancel_request"||r.type==="control_cancel")}function w(r){if(typeof r!="object"||r===null)return;let e=r,t=e.subtype;if(typeof t=="string")return t;let s=e.type;return typeof s=="string"?s:void 0}function J(r){if(typeof r!="object"||r===null)return!1;let e=r.type;return e==="keepalive"||e==="keep_alive"}function z(r){return typeof r=="object"&&r!==null&&r.type==="streamlined_text"}function H(r){return typeof r=="object"&&r!==null&&r.type==="streamlined_tool_use_summary"}function $(r){return typeof r=="object"&&r!==null&&r.type==="post_turn_summary"}function L(r){return typeof r=="object"&&r!==null&&r.type==="result"}var P=class r{static INITIALIZE_TIMEOUT_MS=12e4;transport;inputStream;pendingRequests=new Map;pendingInboundRequests=new Map;hooks;hookCallbacks=new Map;nextHookCallbackId=0;sdkMcpServers;sdkMcpTransports;pendingMcpResponses;isSingleTurn;canUseTool;abortController;jsonSchema;initConfig;onElicitation;onAuthExpired;fetchJobToken;diagnostics;controlRequestTimeoutMs;resolveModel;resolveModelTimeoutMs;initResponse;initializationPromise;resultMessage;readLoopPromise;closed=!1;authExpiredFired=!1;protocolHandshakeValidated=!1;firstResultReceived=!1;firstResultReceivedResolve;constructor(e,t,s,n,o,i,a,l,c,p,d,h,m,u,y,f,k){if(this.transport=e,this.isSingleTurn=t,this.canUseTool=s,this.hooks=n??{},this.abortController=o,this.sdkMcpServers=i??new Map,this.sdkMcpTransports=m??new Map,this.pendingMcpResponses=u??new Map,this.jsonSchema=a,this.initConfig=l??{},this.onElicitation=c,this.onAuthExpired=d,this.fetchJobToken=y,this.diagnostics=p,this.controlRequestTimeoutMs=h??6e4,this.resolveModel=f,this.resolveModelTimeoutMs=k??500,this.inputStream=new v(()=>{this.close().catch(()=>{})}),this.readLoopPromise=this.readMessages().catch(g=>{this.inputStream.error(g)}),this.initializationPromise=this.performInitialize(),this.initializationPromise.catch(()=>{}),this.abortController){let g=this.abortController.signal;g.aborted?this.close().catch(()=>{}):g.addEventListener("abort",()=>{this.close().catch(()=>{})},{once:!0})}}[Symbol.asyncIterator](){return this}async next(){return this.inputStream.next()}async return(){return await this.close(),{done:!0,value:void 0}}async throw(e){return await this.inputStream.throw(e),{done:!0,value:void 0}}async readMessages(){let e;try{for await(let t of this.transport.readMessages()){if(this.closed)break;if(O(t)){this.handleControlResponse(t);continue}if(N(t)){this.handleControlRequest(t).catch(n=>{this.diagnostics?.record("[QueryRunner] Error handling control request:",n)});continue}if(U(t)){this.handleControlCancelRequest(t);continue}if(J(t)||z(t)||H(t)||$(t))continue;if(L(t)){let n=t;this.resultMessage=n,this.firstResultReceived=!0,this.firstResultReceivedResolve?.(),this.firstResultReceivedResolve=void 0,this.inputStream.enqueue(n),this.isSingleTurn&&this.transport.endInput();continue}let s=t;if(s.type==="system"&&s.subtype==="init")try{this.validateProtocolHandshake(s)}catch(n){throw this.inputStream.error(n),n}if(this.onAuthExpired&&!this.authExpiredFired){let n=!1;(s.type==="auth_status"&&s.error||s.type==="assistant"&&s.error==="authentication_failed")&&(n=!0),n&&(this.authExpiredFired=!0,Promise.resolve(this.onAuthExpired()).catch(i=>{this.diagnostics?.record("[QueryRunner] onAuthExpired callback threw:",i)}))}this.inputStream.enqueue(s)}}catch(t){e=t}finally{let t=e instanceof Error?e:new Error("Transport closed");this.firstResultReceivedResolve?.(),this.firstResultReceivedResolve=void 0;for(let[,s]of this.pendingRequests)s.reject(t);this.pendingRequests.clear(),e!==void 0?this.inputStream.error(e):this.inputStream.done()}}async request(e,t){let s=x(),n=K(s,e),o=t?.timeoutMs??this.controlRequestTimeoutMs;return new Promise((i,a)=>{let l=null,c=()=>{l&&(clearTimeout(l),l=null)};this.pendingRequests.set(s,{resolve:p=>{c(),i(p)},reject:p=>{c(),a(p)}}),o>0&&Number.isFinite(o)&&(l=setTimeout(()=>{if(this.pendingRequests.has(s)){this.pendingRequests.delete(s);try{this.transport.write(JSON.stringify({type:"control_cancel_request",request_id:s})+`
+`)}catch(p){this.diagnostics?.record("[QueryRunner] Failed to send control_cancel_request on timeout:",p)}a(new Error(`Control request "${w(n.request)??"unknown"}" timed out after ${o}ms`))}},o));try{this.transport.write(JSON.stringify(n)+`
+`)}catch(p){c(),this.pendingRequests.delete(s),a(p)}})}handleControlResponse(e){let t=e.response,s=t.request_id,n=this.pendingRequests.get(s);if(n)if(this.pendingRequests.delete(s),t.subtype==="success")n.resolve(t.response);else{let o=new Error(t.error);t.code&&(o.code=t.code),n.reject(o),this.processPendingPermissionRequests(t.pending_permission_requests)}}processPendingPermissionRequests(e){if(e)for(let t of e)w(t.request)==="can_use_tool"&&this.handleControlRequest(t).catch(s=>{this.diagnostics?.record("[QueryRunner] Error handling pending permission request:",s)})}async handleControlRequest(e){let t=e.request_id,s=new AbortController;this.pendingInboundRequests.set(t,{abortController:s});try{let n=await this.awaitAbortable(this.processControlRequest(e,s.signal),s.signal);if(!s.signal.aborted){let o=A(t,n);this.transport.write(JSON.stringify(o)+`
+`)}}catch(n){if(!s.signal.aborted){let{error:o,code:i}=X(n),a=j(t,o,i);this.transport.write(JSON.stringify(a)+`
+`)}}finally{this.pendingInboundRequests.delete(t)}}handleControlCancelRequest(e){let t=this.pendingInboundRequests.get(e.request_id);t&&(t.abortController.abort(),this.pendingInboundRequests.delete(e.request_id))}throwIfAborted(e){if(e.aborted)throw new R}validateProtocolHandshake(e){if(this.protocolHandshakeValidated)return;this.protocolHandshakeValidated=!0;let t=e.protocol_version,s=T;if(!t){this.diagnostics?.record(`[QueryRunner] CLI did not announce protocol_version. This SDK was built for ${s}. Consider upgrading qodercli for the version handshake.`);return}let n=F(t),o=F(s);if(!n||!o){this.diagnostics?.record(`[QueryRunner] Could not parse protocol_version "${t}" or built-in "${s}"; skipping handshake.`);return}if(n.major!==o.major)throw new C(t,s);n.minor<o.minor&&this.diagnostics?.record(`[QueryRunner] CLI protocol_version ${t} is older than this SDK's ${s}. New optional fields may be absent.`)}async awaitAbortable(e,t){if(t.aborted)throw new R;return new Promise((s,n)=>{let o=()=>{n(new R)};t.addEventListener("abort",o,{once:!0}),e.then(i=>{t.removeEventListener("abort",o),s(i)},i=>{t.removeEventListener("abort",o),n(i)})})}async processControlRequest(e,t){this.throwIfAborted(t);let s=e.request,n=w(s),o=s;switch(n){case"fetch_job_token":{if(!this.fetchJobToken)throw new Error("job_token_unavailable: No fetchJobToken callback configured");let i=o.reason??"initial",a=o.session_id,l=e.request_id,c=await this.awaitAbortable(this.fetchJobToken({requestId:l,reason:i,sessionId:a},{signal:t}),t);if(!c?.token)throw new Error("job_token_unavailable: Host did not provide a Job Token");return this.diagnostics?.record(`[QueryRunner] fetch_job_token fulfilled: reason=${i}`),{token:c.token}}case"can_use_tool":case"permission_response":{let i=o.tool_name,a=o.input??o.tool_input??{};if(!this.canUseTool)throw new Error("canUseTool callback is not provided.");let l=o.tool_use_id,c=o.permission_suggestions??o.suggestions,p=o.blocked_path,d=o.decision_reason,h=o.decision_reason_type,m=o.classifier_approvable,u=o.title,y=o.display_name,f=o.description,k=o.agent_id,g=Y(i,o.details,o.plan_path,o.plan_content),S=await this.awaitAbortable(this.canUseTool(i,a,{signal:t,suggestions:c,blockedPath:p,decisionReason:d,decisionReasonType:h,classifierApprovable:m,title:u,displayName:y,description:f,toolUseID:l,agentID:k,exitPlanMode:g}),t);if(S.behavior==="deny"&&!S.message)throw new Error("Permission deny result must include a message.");return S.behavior==="allow"?{...S,updatedInput:S.updatedInput??a,toolUseID:l}:{...S,toolUseID:l}}case"hook_callback":{let i=o.callback_id;if(!i)throw new Error("Hook callback missing callback_id");return this.invokeRegisteredHookCallback(i,o.input,o.tool_use_id,t)}case"mcp_message":{let i=o.server_name,a=o.message,l=this.sdkMcpTransports.get(i);if(!l)throw new Error(`Unknown in-process MCP server: ${i}`);return{mcp_response:await this.awaitAbortable(q(i,a,l,this.pendingMcpResponses),t)}}case"elicitation":case"elicitation_response":return this.onElicitation?await this.awaitAbortable(this.onElicitation({serverName:o.mcp_server_name??"",message:o.message??o.prompt??"",mode:o.mode,url:o.url,elicitationId:o.elicitation_id,requestedSchema:o.requested_schema,title:o.title,displayName:o.display_name,description:o.description},{signal:t}),t):{action:"cancel"};case"get_model_policy":{if(!this.resolveModel)return{type:"get_model_policy"};let i={purpose:o.purpose,sessionId:o.sessionId,turnIndex:o.turnIndex,availableModels:o.models??[]},a=this.resolveModelTimeoutMs,l=Promise.resolve(this.resolveModel(i)),c,p=new Promise((m,u)=>{c=setTimeout(()=>{u(new b(a))},a)}),d;try{d=await this.awaitAbortable(Promise.race([l,p]),t)}finally{clearTimeout(c)}let h={type:"get_model_policy",model:typeof d.model=="string"?d.model:d.model.model,parameters:d.parameters};if(typeof d.model!="string"){let{model:m,...u}=d.model;h.custom_model={...u,style:u.style??"openai"}}return h}default:throw new Error(`Unhandled control request subtype: ${n??"unknown"}`)}}async initialize(){return this.initializationPromise||(this.initializationPromise=this.performInitialize()),this.initializationPromise}async performInitialize(){let e={type:"initialize",modelPolicyProvider:this.resolveModel!==void 0,supportsCatalogReadyInitialize:!0,initializeTimeoutMs:r.INITIALIZE_TIMEOUT_MS},t={};for(let[n,o]of Object.entries(this.hooks)){if(!o||o.length===0)continue;let i=[];for(let a of o){let l=a.hooks.map(c=>{let p=`hook_${this.nextHookCallbackId++}`;return this.hookCallbacks.set(p,c),p});l.length!==0&&i.push({matcher:a.matcher,hookCallbackIds:l,timeout:a.timeout})}i.length>0&&(t[n]=i)}Object.keys(t).length>0&&(e.hooks=t),this.initConfig.systemPrompt!==void 0&&(e.systemPrompt=this.initConfig.systemPrompt),this.initConfig.appendSystemPrompt!==void 0&&(e.appendSystemPrompt=this.initConfig.appendSystemPrompt),this.initConfig.planModeInstructions!==void 0&&(e.planModeInstructions=this.initConfig.planModeInstructions),this.initConfig.agents&&(e.agents=this.initConfig.agents),this.initConfig.promptSuggestions!==void 0&&(e.promptSuggestions=this.initConfig.promptSuggestions),this.initConfig.enableFileCheckpointing!==void 0&&(e.enableFileCheckpointing=this.initConfig.enableFileCheckpointing),this.jsonSchema&&(e.jsonSchema=this.jsonSchema),this.sdkMcpServers.size>0&&(e.sdkMcpServers=Array.from(this.sdkMcpServers.keys()));let s=await this.request(e,{timeoutMs:r.INITIALIZE_TIMEOUT_MS});if(s&&typeof s=="object"){let n=s;this.initResponse=n}if(!this.initResponse)throw new Error("Failed to receive initialization response");return this.initResponse}async invokeRegisteredHookCallback(e,t,s,n){let o=this.hookCallbacks.get(e);if(!o)throw new Error(`Unknown hook callback: ${e}`);return await this.awaitAbortable(o(t,s,{signal:n}),n)??{continue:!0}}async initializationResult(){return this.initialize()}async streamInput(e){(async()=>{try{await this.initialize();let t=0;for await(let s of e){if(this.closed)break;t+=1,this.transport.write(JSON.stringify(s)+`
+`)}t>0&&this.hasBidirectionalNeeds()&&await this.waitForFirstResult(),this.transport.endInput()}catch(t){this.diagnostics?.record("[QueryRunner] streamInput error:",t),this.inputStream.error(t instanceof Error?t:new Error(String(t))),this.transport.endInput()}})().catch(()=>{})}async interrupt(){await this.request({type:"interrupt"})}async setPermissionMode(e){await this.request({type:"set_permission_mode",mode:e==="yolo"?"bypassPermissions":e})}hasBidirectionalNeeds(){return this.sdkMcpTransports.size>0||Object.keys(this.hooks).length>0||this.canUseTool!==void 0||this.onElicitation!==void 0||this.fetchJobToken!==void 0||this.resolveModel!==void 0}waitForFirstResult(){return this.firstResultReceived||this.closed?Promise.resolve():new Promise(e=>{if(this.abortController?.signal.aborted){e();return}this.firstResultReceivedResolve=e,this.abortController?.signal.addEventListener("abort",()=>e(),{once:!0})})}async setModel(e){await this.request({type:"set_model",model:e??""})}async setProxy(e){await this.request({type:"set_proxy",proxy:e||null})}async generateSessionTitle(e,t){return(await this.request({type:"generate_session_title",description:e,...t?.persist!==void 0?{persist:t.persist}:{}}))?.title??null}async addDirectories(e){if(!Array.isArray(e))throw new Error("directories must be an array");return await this.request({type:"add_directories",directories:e})}async applyFlagSettings(e){await this.request({type:"apply_flag_settings",settings:e})}async supportedCommands(){return(await this.initializationResult()).commands??[]}async getAvailableModels(){let e={subtype:"get_models"};return(await this.request(e))?.models??[]}async listByokProviders(){try{return(await this.request({type:"get_byok_config"}))?.providers??null}catch{return null}}async validateByokModel(e){try{let t=await this.request({type:"validate_byok_model",provider:e.provider,model:e.model,api_key:e.api_key,...e.url!==void 0?{url:e.url}:{},...e.style!==void 0?{style:e.style}:{}});return typeof t?.success=="boolean"?t.success:null}catch{return null}}async supportedAgents(){return(await this.initializationResult()).agents??[]}async accountInfo(){try{let t=await this.request({type:"account_info"});if(t?.account)return t.account}catch{}return(await this.initializationResult()).account??{}}async mcpServerStatus(){return(await this.request({type:"mcp_status"}))?.servers??[]}async getContextUsage(){return await this.request({type:"get_context_usage"})}async reloadPlugins(){return await this.request({type:"reload_plugins"})}async rewindFiles(e,t){let s={type:"rewind_files",user_message_id:e};t?.dryRun&&(s.dry_run=!0);let o=await this.request(s);if(!t?.dryRun&&o?.canRewind===!1)throw new Error(typeof o.error=="string"&&o.error.length>0?o.error:"Unable to rewind files.");return o}async seedReadState(e,t){await this.request({type:"seed_read_state",path:e,mtime:t})}async reconnectMcpServer(e){await this.request({type:"mcp_reconnect",serverName:e})}async toggleMcpServer(e,t){await this.request({type:"mcp_toggle",serverName:e,enabled:t})}async setMcpServers(e){return await this.request({type:"mcp_set_servers",servers:e})??{added:[],removed:[],errors:{}}}async injectMcpToken(e,t){await this.request({type:"mcp_inject_token",serverName:e,token:t})}async mcpAuthenticate(e,t){let s=await this.request({type:"mcp_authenticate",serverName:e,...t!==void 0?{redirectUri:t}:{}}),n=s?.requiresUserAction===!0,o=typeof s?.authUrl=="string"?s.authUrl:void 0;if(n&&o===void 0)throw new Error("mcp_authenticate response set requiresUserAction=true but did not include an authUrl");return n?{authUrl:o,requiresUserAction:!0}:{requiresUserAction:!1}}async mcpSubmitOAuthCallbackUrl(e,t){await this.request({type:"mcp_oauth_callback_url",serverName:e,callbackUrl:t})}async mcpClearAuth(e){await this.request({type:"mcp_clear_auth",serverName:e})}async close(){if(this.closed)return;this.closed=!0;for(let[,t]of this.pendingInboundRequests)t.abortController.abort();this.pendingInboundRequests.clear(),this.hookCallbacks.clear();let e=new Error("SDK closing");for(let[t,s]of this.sdkMcpTransports){try{await s.close()}catch(n){this.diagnostics?.record(`[QueryRunner] error closing SDK MCP transport "${t}":`,n)}D(t,e,this.pendingMcpResponses)}this.transport.close();try{await this.readLoopPromise}catch{}}async[Symbol.asyncDispose](){await this.close()}};function X(r){let e=r instanceof Error?r.message:String(r),t=typeof r=="object"&&r!==null?r.code:void 0,s=typeof t=="string"&&t.length>0?t:void 0,n=/^([a-z][a-z0-9_]*):\s*(.*)$/.exec(e);if(n){let o=s??n[1];return(!s||s===n[1])&&(e=n[2]||e),{error:e,code:o}}return s?{error:e,code:s}:{error:e}}function Y(r,e,t,s){if(r!==I)return;let n=e!==null&&typeof e=="object"?e:void 0,o=n?.type===I||n?.type==="ExitPlanMode",i=o&&typeof n?.planPath=="string"&&n.planPath.length>0?n.planPath:typeof t=="string"&&t.length>0?t:void 0,a=o&&typeof n?.planContent=="string"&&n.planContent.length>0?n.planContent:typeof s=="string"&&s.length>0?s:void 0;if(!a&&i&&(a=V.readFileSync(i,"utf8").trim()||void 0),!(!i&&!a))return{planPath:i,planContent:a}}function F(r){let e=/^(\d+)\.(\d+)(?:\.\d+)?(?:[-+].*)?$/.exec(r);return e?{major:Number(e[1]),minor:Number(e[2])}:null}var _=class{sendMcpMessage;isClosed=!1;onclose;onerror;onmessage;constructor(e){this.sendMcpMessage=e}async start(){}async send(e){if(this.isClosed)throw new Error("Transport is closed");this.sendMcpMessage(e)}async close(){this.isClosed||(this.isClosed=!0,this.onclose?.())}get closed(){return this.isClosed}};function ee(r){let{prompt:e,websocket:t,abortController:s,canUseTool:n,hooks:o,mcpServers:i,jsonSchema:a}=r,l=new Map,c=new Map,p=new Map;if(i)for(let[m,u]of Object.entries(i))if(u.type==="sdk"&&"instance"in u){let y=u.instance;l.set(m,y);let f=new _(k=>{E(m,k,p)});c.set(m,f),y.connect(f).catch(()=>{})}else throw new Error(`Browser SDK only supports SDK MCP servers. Server "${m}" has type "${u.type}".`);let d=new M({url:t.url,headers:t.headers,authMessage:t.authMessage,abortController:s}),h=new P(d,!0,n,o,s,l,a,{},void 0,void 0,void 0,void 0,c,p);return h.streamInput(e),h}export{Q as createSdkMcpServer,ee as query,B as tool};

package/dist/cloud-agent/cloud-agent-query.d.ts

@@ -1,4 +1,4 @@
-import type { DebugLogger } from '../core/sdk-debug.js';
+import type { DiagnosticsSink } from '../core/sdk-diagnostics.js';
 import type { InternalAuthOptions } from '../types/auth.js';
 import type { CloudAgentOptions } from '../types/cloud-agent.js';
 import type { Query } from '../types/options.js';
@@ -12,7 +12,7 @@ type CreateCloudAgentQueryParams = {
         abortController?: AbortController;
         onAuthExpired?: () => void;
     };
-    debugLogger?: DebugLogger;
+    diagnostics?: DiagnosticsSink;
 };
 export declare function validateCloudAgentQueryOptions(options: CreateCloudAgentQueryParams['options'] & Record<string, unknown>): void;
 export declare function createCloudAgentQuery(params: CreateCloudAgentQueryParams): Query;

package/dist/core/process-transport.d.ts

@@ -16,6 +16,19 @@ import type { PermissionMode } from '../types/permissions.js';
 import type { McpServerConfigForProcessTransport, McpServerToolPolicy } from '../types/mcp.js';
 import type { InternalAuthOptions } from '../types/auth.js';
 import type { SpawnedProcess, SpawnOptions, SettingSource } from '../types/options.js';
+import type { DiagnosticsSink } from './sdk-diagnostics.js';
+export declare class QoderCliProcessError extends Error {
+    readonly code: "QODER_CLI_PROCESS_ERROR";
+    readonly exitCode?: number | null;
+    readonly signal?: NodeJS.Signals | null;
+    readonly stderr?: string;
+    constructor(message: string, options?: {
+        exitCode?: number | null;
+        signal?: NodeJS.Signals | null;
+        stderr?: string;
+        cause?: unknown;
+    });
+}
 /**
  * Options for configuring the ProcessTransport.
  *
@@ -33,6 +46,7 @@ export interface ProcessTransportOptions {
     cwd?: string;
     /** Custom environment variables (defaults to process.env) */
     env?: Record<string, string | undefined>;
+    proxy?: string;
     /** stderr handling mode */
     stderr?: 'inherit' | 'pipe' | 'ignore';
     /** Optional callback for child-process stderr output */
@@ -44,6 +58,8 @@ export interface ProcessTransportOptions {
     model?: string;
     /** Forward --debug to the CLI process. */
     debug?: boolean;
+    /** SDK-internal diagnostics sink. This is not forwarded to qodercli. */
+    diagnostics?: DiagnosticsSink;
     agent?: string;
     sessionId?: string;
     continue?: boolean;
@@ -59,7 +75,7 @@ export interface ProcessTransportOptions {
     includeHookEvents?: boolean;
     allowedTools?: string[];
     disallowedTools?: string[];
-    tools?: string[];
+    tools?: ToolsOption;
     toolConfig?: ToolConfig;
     extensions?: string[];
     mcpServers?: Record<string, McpServerConfigForProcessTransport>;
@@ -86,6 +102,10 @@ export interface ProcessTransportOptions {
      */
     onAuthExpired?: () => void;
 }
+type ToolsOption = string[] | {
+    type: 'preset';
+    preset: 'qodercli';
+};
 export declare class ProcessTransport implements Transport {
     private process;
     private customHandle;
@@ -97,7 +117,9 @@ export declare class ProcessTransport implements Transport {
     private authPayloadPath;
     private pendingInput;
     private generatedSettingsDir;
-    private debugLogger;
+    private diagnostics?;
+    private processExitError;
+    private stderrTail;
     constructor(options?: ProcessTransportOptions);
     /**
      * Build CLI arguments, resolve the executable, spawn the process,
@@ -144,6 +166,11 @@ export declare class ProcessTransport implements Transport {
      * Get the stdout stream from the process or custom handle.
      */
     private getStdout;
+    private appendStderr;
+    private createSpawnError;
+    private createProcessExitError;
+    private getStderrTail;
+    private waitForProcessExit;
     /**
      * Resolve the executable command and arguments.
      *
@@ -183,4 +210,5 @@ export declare class ProcessTransport implements Transport {
     private cleanupAuthPayload;
     /** Fire `onAuthExpired` at most once per session. */
     private fireAuthExpired;
-}
+}
+export {};

package/dist/core/sdk-diagnostics.d.ts

@@ -0,0 +1,23 @@
+/** Minimal internal diagnostics sink used by query runtimes. */
+export interface DiagnosticsSink {
+    record(message: string, error?: unknown): void;
+}
+export type SdkDiagnosticsOptions = {
+    debug?: boolean;
+    debugFile?: string;
+    stderr?: (data: string) => void;
+};
+export declare function isSdkDiagnosticsEnabled(options: SdkDiagnosticsOptions): boolean;
+export declare function resolveSdkDiagnosticsFilePath(options: SdkDiagnosticsOptions): string | undefined;
+export declare class SdkDiagnostics implements DiagnosticsSink {
+    private readonly enabled;
+    private readonly debugFile?;
+    private readonly stderr?;
+    constructor(options?: SdkDiagnosticsOptions);
+    record(message: string, error?: unknown): void;
+    get filePath(): string | undefined;
+    private writeToFile;
+    private writeToStderr;
+    private formatLine;
+    private formatError;
+}

package/dist/index.d.ts

@@ -52,6 +52,7 @@
  * ```
  */
 export { query } from './query/query.js';
+export { QoderCliProcessError } from './core/process-transport.js';
 export { DEFAULT_ACCESS_TOKEN_ENV_VAR, accessToken, accessTokenFromEnv, jobToken, qodercliAuth, } from './auth.js';
 export { createSdkMcpServer, tool } from './mcp/sdk-mcp-server.js';
 export type { AnyZodRawShape, InferShape, SdkMcpToolDefinition, ToolExtras, CreateSdkMcpServerOptions, } from './mcp/sdk-mcp-server.js';
@@ -73,7 +74,7 @@ export type { AccessTokenInput, AuthOptions } from './types/auth.js';
  * @internal Internal auth types for first-party host integration, not general public use.
  */
 export type { FetchJobToken, JobTokenAuthOptions, JobTokenRequest, JobTokenResult, } from './types/auth.js';
-export type { AccountInfo, ApiKeySource, ExitReason, FastModeState, ConfigScope, SettingSource, SDKAssistantMessageError, SDKStatus, EffortLevel, ThinkingAdaptive, ThinkingEnabled, ThinkingDisabled, ThinkingConfig, OutputFormatType, JsonSchemaOutputFormat, OutputFormat, BaseOutputFormat, ModelInfo, ModelUsage, NonNullableUsage, SlashCommand, ToolConfig, SdkPluginConfig, } from './types/common.js';
+export type { AccountInfo, ApiKeySource, ExitReason, FastModeState, ConfigScope, SettingSource, SDKAssistantMessageError, SDKStatus, EffortLevel, ThinkingAdaptive, ThinkingEnabled, ThinkingDisabled, ThinkingConfig, OutputFormatType, JsonSchemaOutputFormat, OutputFormat, BaseOutputFormat, ModelInfo, ModelSource, ModelStrategy, ModelContextConfig, ModelContextWindowEntry, ModelEffortEntry, ModelThinkingConfig, ModelThinkingDisabled, ModelThinkingEnabled, ModelUsage, NonNullableUsage, SlashCommand, ToolConfig, SdkPluginConfig, } from './types/common.js';
 export type { SDKMessage, SDKAssistantMessage, SDKUserMessage, SDKUserMessageReplay, SDKResultMessage, SDKResultSuccess, SDKResultError, SDKSystemMessage, SDKSystemInitMessage, SDKSystemMessageSubtype, SDKSystemMessageBySubtype, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKLocalCommandOutputMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKPermissionDeniedMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKBridgeStateMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKPermissionDenial, } from './types/messages.js';
 export type { Options, Query, SpawnOptions, SpawnedProcess, ElicitationRequest, ElicitationResult, OnElicitation, PromptRequest, PromptRequestOption, PromptResponse, CanUseTool, Transport, } from './types/options.js';
 export type { AgentCreateParams, BetaManagedAgentsAgentToolName, BetaManagedAgentsAgentToolset20260401Params, BetaManagedAgentsCustomSkillParams, BetaManagedAgentsFileResourceParams, BetaManagedAgentsModel, BetaManagedAgentsSkillParams, BetaManagedAgentsURLMCPServerParams, CloudAgentOptions, CloudAgentReference, CloudAgentStreamOptions, CloudSessionResource, CloudSessionCreateParams, CloudSessionCreateReference, CloudSessionExistingReference, CloudSessionReference, SessionCreateParams, } from './types/cloud-agent.js';
@@ -86,9 +87,9 @@ export type { SDKSessionInfo, SessionMessage, ListSessionsOptions, GetSessionInf
 export type { Settings, SandboxSettings, SandboxNetworkConfig, SandboxFilesystemConfig, SandboxIgnoreViolations, ResolvedSettings, ResolvedSettingsSource, } from './types/settings.js';
 export { filterEscalatingDefaultMode } from './types/settings.js';
 export type { QoderModelPurpose } from './types/control.js';
-export type { SDKControlRequest, SDKControlResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlReloadPluginsResponse, } from './types/control.js';
+export type { SDKControlRequest, SDKControlResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse, } from './types/control.js';
 export type { SDKControlGetModelPolicyRequest, SDKControlGetModelPolicyResponse, SDKCapabilities, ModelPolicyContext, ModelPolicyResult, ModelPolicyProvider, } from './types/model-policy-provider.js';
-export type { SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, BYOKProviderInfo, BYOKModelTypeInfo, BYOKModelInfo, CustomModel, } from './types/byok.js';
+export type { SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, BYOKModelValidationInput, BYOKProviderInfo, BYOKModelTypeInfo, BYOKModelInfo, CustomModel, } from './types/byok.js';
 export type { SessionState, BridgeSessionHandle, AttachBridgeSessionOptions, RemoteCredentials, } from './types/bridge.js';
 export type { OAuthCredential, AuthMessage, WebSocketOptions, BrowserQueryOptions, } from './types/browser.js';
 export type { AgentInput, AgentOutput, BashInput, FileReadInput, FileReadOutput, FileEditInput, FileWriteInput, GlobInput, GrepInput, WebFetchInput, WebSearchInput, AskUserQuestionInput, NotebookEditInput, ExitPlanModeInput, TodoWriteInput, ToolInputSchemas, ToolOutputSchemas, } from './types/tools.js';