@openadapter/koda 1.0.0-beta.3

package/openadapter/extensions/koda-ask.js

@@ -0,0 +1,12 @@
+var v=Object.defineProperty;var l=(r,t)=>v(r,"name",{value:t,configurable:!0});import{Text as k,truncateToWidth as q,wrapTextWithAnsi as b}from"@openadapter/koda-tui";import{Type as h}from"typebox";const x={__chat__:!0},m=l(r=>({content:[{type:"text",text:r}],details:void 0}),"text");class T{static{l(this,"QuestionCard")}qIndex=0;rowIndex=0;picks;freeText;typing=!1;buffer="";width=0;tui;theme;questions;done;constructor(t,e,s,a){this.tui=t,this.theme=e,this.questions=s,this.done=a,this.picks=s.map(()=>new Set),this.freeText=s.map(()=>{})}invalidate(){}get q(){return this.questions[this.qIndex]}get onSubmitTab(){return this.qIndex>=this.questions.length}get rowCount(){return(this.q?.options.length??0)+2}get typeRow(){return this.q.options.length}get chatRow(){return this.q.options.length+1}get singleImmediate(){return this.questions.length===1&&!this.questions[0]?.multiSelect}handleInput(t){if(this.typing)return this.handleTyping(t);const e=t;if(e==="\x1B"||e===""){this.done(x);return}if(e==="\x1B[A")this.moveRow(-1);else if(e==="\x1B[B")this.moveRow(1);else if(e==="\x1B[C"||e==="	")this.moveTab(1);else if(e==="\x1B[D"||e==="\x1B[Z")this.moveTab(-1);else if(e==="\r"||e===`
+`)this.enter();else if(e===" ")this.toggleCurrent();else if(/^[1-9]$/.test(e))this.pickNumber(Number(e)-1);else return;this.tui.requestRender()}handleTyping(t){if(t==="\r"||t===`
+`)this.freeText[this.qIndex]=this.buffer.trim()||void 0,this.typing=!1,this.buffer="",this.advanceAfterAnswer();else if(t==="\x7F"||t==="\b")this.buffer=this.buffer.slice(0,-1);else if(t==="\x1B")this.typing=!1,this.buffer="";else if(t.length===1&&t>=" ")this.buffer+=t;else return;this.tui.requestRender()}moveRow(t){if(this.onSubmitTab)return;const e=this.rowCount;this.rowIndex=(this.rowIndex+t+e)%e}moveTab(t){const e=this.questions.length;this.qIndex=Math.max(0,Math.min(this.qIndex+t,e)),this.rowIndex=0}toggleCurrent(){this.onSubmitTab||this.rowIndex>=this.q.options.length||this.toggleOption(this.rowIndex)}toggleOption(t){const e=this.picks[this.qIndex];this.q.multiSelect?e.has(t)?e.delete(t):e.add(t):(e.clear(),e.add(t))}pickNumber(t){this.onSubmitTab||t>=this.q.options.length||(this.rowIndex=t,this.toggleOption(t),this.q.multiSelect||this.afterSinglePick(),this.tui.requestRender())}enter(){if(this.onSubmitTab){this.finalize();return}if(this.rowIndex===this.chatRow){this.done(x);return}if(this.rowIndex===this.typeRow){this.typing=!0,this.buffer=this.freeText[this.qIndex]??"";return}this.toggleOption(this.rowIndex),this.q.multiSelect||this.afterSinglePick()}afterSinglePick(){if(this.singleImmediate){this.finalize();return}this.advanceAfterAnswer()}advanceAfterAnswer(){this.qIndex<this.questions.length-1?(this.qIndex+=1,this.rowIndex=0):this.qIndex=this.questions.length}finalize(){const t={};this.questions.forEach((e,s)=>{const a=this.freeText[s];if(a){t[e.header]=a;return}const u=[...this.picks[s]],d=u.length?u:[0];t[e.header]=d.map(n=>e.options[n]?.label??"").filter(Boolean).join(", ")}),this.done(t)}render(t){const e=this.theme,s=[];if(s.push(this.renderTabs(t)),s.push(""),this.onSubmitTab)return s.push(e.fg("text",e.bold("Review & submit"))),s.push(""),this.questions.forEach(n=>{const o=this.freeText[this.questions.indexOf(n)],i=this.questions.indexOf(n),c=o??[...this.picks[i]].map(p=>n.options[p]?.label).filter(Boolean).join(", ");s.push(`  ${e.fg("accent",n.header)}: ${e.fg("text",c||e.fg("muted","(recommended)"))}`)}),s.push(""),s.push(e.fg("success","  \u2714 Press Enter to submit")),s.push(""),s.push(e.fg("muted","Enter submit \xB7 Tab/\u2190\u2192 switch \xB7 Esc cancel")),s;for(const n of b(e.bold(this.q.question),t))s.push(n);s.push("");const a=l(n=>n?e.fg("accent","\u2192 "):"  ","cursor");this.q.options.forEach((n,o)=>{const i=this.rowIndex===o,c=this.picks[this.qIndex].has(o),p=this.q.multiSelect?c?e.fg("success","\u2612"):e.fg("muted","\u2610"):c?e.fg("success","\u2713"):" ",f=`${o+1}. ${n.label}`;if(s.push(`${a(i)}${p} ${i?e.fg("accent",e.bold(f)):e.fg("accent",f)}`),n.description){const g="      ";for(const y of b(e.fg("muted",n.description),Math.max(20,t-g.length)))s.push(g+y)}}),s.push(e.fg("border","\u2500".repeat(Math.min(t,60))));const u=this.rowIndex===this.typeRow;if(this.typing)s.push(`${a(!0)}${e.fg("text",this.buffer)}${e.fg("accent","\u258F")}`),s.push(e.fg("muted","  type your answer \xB7 Enter to confirm \xB7 Esc to cancel"));else{const n=this.q.options.length,o=`${n+1}. Type something`,i=`${n+2}. Chat about this`;s.push(`${a(u)}${u?e.fg("text",e.bold(o)):e.fg("muted",o)}`);const c=this.rowIndex===this.chatRow;s.push(`${a(c)}${c?e.fg("text",e.bold(i)):e.fg("muted",i)}`)}s.push("");const d=this.q.multiSelect?"Space toggle \xB7 Enter next \xB7 \u2191\u2193 move \xB7 Tab/\u2190\u2192 switch \xB7 Esc cancel":"Enter select \xB7 \u2191\u2193 move \xB7 Tab/\u2190\u2192 switch \xB7 1-9 pick \xB7 Esc cancel";return s.push(e.fg("muted",d)),s}renderTabs(t){const e=this.theme,s=[];this.questions.forEach((n,o)=>{const i=this.qIndex===o,f=` ${this.freeText[o]||this.picks[o].size>0?"\u2612":"\u2610"} ${n.header} `;s.push(i?e.fg("accent",`\x1B[7m${f}\x1B[27m`):e.fg("muted",f))});const a=this.onSubmitTab,u=" \u2714 Submit ";s.push(a?e.fg("success",`\x1B[7m${u}\x1B[27m`):e.fg("muted",u));const d=`${e.fg("muted","\u2190 ")}${s.join(e.fg("muted"," "))}${e.fg("muted"," \u2192")}`;return q(d,t,"")}}function A(r){const t=(r||"").trim();if(!t)return!1;const e=t.toLowerCase();if(/[\w.\-]+\.(ts|tsx|js|jsx|mjs|cjs|py|go|rs|java|rb|php|c|cpp|h|hpp|cs|css|scss|html|json|md|sql|ya?ml|toml|sh|swift|kt)\b/.test(e)||/\b(fix|debug|why|explain|refactor|rename|revert|undo|investigate|trace|reproduce|stack ?trace|error:|exception)\b/.test(e)||/[a-z0-9_~.]+\/[a-z0-9_]/i.test(t)||t.length>600)return!1;const s=/\b(build|make|create|set ?up|scaffold|start|bootstrap|generate|spin ?up|add a|i want|i'?d like|we (?:need|want)|help me|let'?s (?:build|make|create|do))\b/.test(e),a=/\b(app|application|site|website|web ?app|api|backend|back-end|frontend|front-end|server|service|tool|cli|bot|dashboard|game|project|landing|page|component|library|package|extension|plugin|prototype|mvp|feature|integration|pipeline|script)\b/.test(e),u=t.split(/\s+/).length;return!!(s&&a||s&&u<=12)}l(A,"isVague");const I=["","<koda-brainstorm>","This request is open-ended. Before writing code:","1. Briefly state the approach you intend to take (one or two sentences).","2. Call the `ask_user` tool to confirm ONLY the decisions that genuinely change the outcome \u2014 e.g. framework, language, storage, styling, scope. Give 2\u20134 options each, your recommended option FIRST, with a one-line description per option. Batch related questions into a single `ask_user` call (up to 4).","Skip anything you can reasonably infer from the existing repo, and don't ask about things you can just decide yourself. Ask at most one round, then build. If nothing is genuinely ambiguous, skip ask_user and proceed.","</koda-brainstorm>"].join(`
+`);function S(r){return Array.isArray(r)?r.map(t=>{const e=Array.isArray(t?.options)?t.options.map(s=>({label:String(s?.label??"").trim(),description:s?.description?String(s.description):void 0})).filter(s=>s.label):[];return{header:String(t?.header??t?.question??"Choose").trim().slice(0,16),question:String(t?.question??"").trim(),options:e,multiSelect:!!t?.multiSelect}}).filter(t=>t.question&&t.options.length>=2).slice(0,4):[]}l(S,"normalizeQuestions");function w(r){return`The user answered:
+${Object.entries(r).map(([e,s])=>`- ${e}: ${s}`).join(`
+`)}
+
+Proceed based on these choices. Do not re-ask what they already decided.`}l(w,"answerText");function $(r){r.registerTool({name:"ask_user",label:"Ask the user",description:"Ask the user to choose between concrete options for a decision that genuinely changes the outcome (framework, language, storage, styling, scope, \u2026). Renders a multiple-choice card. Put YOUR recommended option first. Use this instead of guessing on open-ended requests \u2014 but only for decisions you can't reasonably infer or just decide yourself. Returns the user's choice(s).",promptSnippet:"ask_user: present multiple-choice options to the user for a key decision and get their pick",promptGuidelines:["When a request is open-ended and a decision would change the result (which framework? which DB? what scope?), call ask_user with 1-4 questions, each with 2-4 options, your recommended option first, a one-line description per option.","Do NOT ask about things you can infer from the repo or decide yourself. Don't ask more than one round. After the user answers, build \u2014 don't re-ask."],parameters:h.Object({questions:h.Array(h.Object({header:h.String({description:"Very short tab label, \u226412 chars (e.g. 'Framework', 'Storage')."}),question:h.String({description:"The full question to ask."}),options:h.Array(h.Object({label:h.String({description:"Concise option label (1-5 words)."}),description:h.Optional(h.String({description:"One line explaining the option / trade-off."}))}),{minItems:2,maxItems:4,description:"2-4 options; put your recommendation FIRST."}),multiSelect:h.Optional(h.Boolean({description:"Allow selecting multiple options."}))}),{minItems:1,maxItems:4})}),async execute(t,e,s,a,u){const d=S(e?.questions);if(!d.length)return m("ask_user: no valid questions (need \u22651 question with \u22652 options). Proceed with your best judgement.");if(u?.mode!=="tui"){const o=Object.fromEntries(d.map(i=>[i.header,i.options[0]?.label??""]));return m(`Non-interactive mode \u2014 auto-selected the recommended option for each question:
+${Object.entries(o).map(([i,c])=>`- ${i}: ${c}`).join(`
+`)}
+
+Proceed with these.`)}let n;try{n=await u.ui.custom((o,i,c,p)=>new T(o,i,d,p))}catch{const o=Object.fromEntries(d.map(i=>[i.header,i.options[0]?.label??""]));return m(w(o))}return n?.__chat__?m("The user chose to discuss this rather than pick from the options. Continue the conversation and help them decide \u2014 do not force a selection or re-open the card unless they ask."):m(w(n))},renderCall(t,e){const s=Array.isArray(t?.questions)?t.questions[0]?.question:void 0;return new k(e.fg("toolTitle",e.bold("ask_user "))+e.fg("muted",String(s??"").slice(0,80)),0,0)}}),r.on("before_agent_start",t=>{if(process.env.KODA_ASK!=="0"&&A(t?.prompt??""))return{systemPrompt:`${t.systemPrompt}${I}`}})}l($,"default");export{$ as default};

package/openadapter/extensions/koda-bg.js

@@ -0,0 +1,14 @@
+var h=Object.defineProperty;var u=(n,s)=>h(n,"name",{value:s,configurable:!0});import{spawn as f}from"node:child_process";import{openSync as k,readFileSync as y}from"node:fs";import{tmpdir as w}from"node:os";import{join as $}from"node:path";import{Text as _}from"@openadapter/koda-tui";import{Type as i}from"typebox";const d=new Map,c=u(n=>({content:[{type:"text",text:n}]}),"text");function p(n){try{return process.kill(n,0),!0}catch{return!1}}u(p,"alive");function g(n,s=40){try{return y(n,"utf-8").split(`
+`).slice(-s).join(`
+`).trim()}catch{return""}}u(g,"tailLog");function S(n){n.registerTool({name:"run_background",label:"Run in background",description:"Start a long-running command in the BACKGROUND and return immediately \u2014 for anything that does not exit on its own: a dev server, `docker-compose up`, a file watcher, `npm run dev`. Returns the PID, the log path, and any early output. Use this instead of bash for servers/demos; check it with bg_output and stop it with bg_stop.",promptSnippet:"run_background: start a server / long-running process without blocking",promptGuidelines:["For anything that runs continuously (a dev server, docker-compose up, a watcher) use run_background, NOT bash \u2014 bash blocks until the command exits, which never happens for a server. After starting it, check bg_output to confirm it came up."],parameters:i.Object({command:i.String({description:"Shell command to run in the background"}),cwd:i.Optional(i.String({description:"Working directory (default: current)"}))}),async execute(s,t){try{const e=$(w(),`koda-bg-${Date.now()}-${Math.floor(performance.now())}.log`),o=k(e,"a"),r=f(t.command,{shell:!0,detached:!0,stdio:["ignore",o,o],cwd:t.cwd||process.cwd()}),a=r.pid;if(!a)return c("run_background failed: could not start process.");r.unref(),d.set(a,{pid:a,command:t.command,log:e,startedAt:Date.now()}),await new Promise(b=>setTimeout(b,1e3));const l=g(e,20),m=p(a)?`running (pid ${a})`:`exited already (pid ${a}) \u2014 likely failed`;return c(`Started in background \u2014 ${m}.
+Logs: ${e}
+${l?`
+Early output:
+${l}`:"(no output yet)"}
+
+Check more with bg_output, stop with bg_stop ${a}.`)}catch(e){return c(`run_background failed: ${e.message}`)}},renderCall(s,t){return new _(t.fg("toolTitle",t.bold("run_background "))+t.fg("muted",String(s.command).slice(0,80)),0,0)}}),n.registerTool({name:"bg_output",label:"Background output",description:"Show recent output from a background process (started with run_background). Omit pid for the most recent one.",promptSnippet:"bg_output: read recent output of a background process",parameters:i.Object({pid:i.Optional(i.Number({description:"PID (default: most recent)"})),lines:i.Optional(i.Number({description:"How many trailing lines (default 40)"}))}),async execute(s,t){const e=[...d.values()];if(e.length===0)return c("No background processes.");const o=t.pid?d.get(t.pid):e[e.length-1];if(!o)return c(`No background process with pid ${t.pid}.`);const r=g(o.log,t.lines??40),a=p(o.pid)?"running":"exited";return c(`pid ${o.pid} (${a}) \u2014 ${o.command}
+
+${r||"(no output)"}`)}}),n.registerTool({name:"bg_stop",label:"Stop background",description:"Stop a background process and its children. Pass the pid (omit to stop all background processes).",promptSnippet:"bg_stop: stop a background process",parameters:i.Object({pid:i.Optional(i.Number({description:"PID to stop (default: all)"}))}),async execute(s,t){const e=t.pid?[d.get(t.pid)].filter(Boolean):[...d.values()];if(e.length===0)return c(t.pid?`No background process with pid ${t.pid}.`:"No background processes.");const o=[];for(const r of e){try{process.kill(-r.pid,"SIGTERM")}catch{try{process.kill(r.pid,"SIGTERM")}catch{}}d.delete(r.pid),o.push(r.pid)}return c(`Stopped: ${o.join(", ")}`)}}),n.registerCommand("bg",{description:"List background processes Koda started",handler:u(async(s,t)=>{const e=[...d.values()];if(e.length===0){t.ui.notify("No background processes.","info");return}const o=e.map(r=>`pid ${r.pid} \xB7 ${p(r.pid)?"running":"exited"} \xB7 ${r.command}`);t.ui.notify(`Background processes:
+${o.join(`
+`)}`,"info")},"handler")}),n.registerTool({name:"bg_list",label:"List background",description:"List the background processes Koda has started this session, with running/exited status.",promptSnippet:"bg_list: list background processes",parameters:i.Object({}),async execute(){const s=[...d.values()];return s.length===0?c("No background processes."):c(s.map(t=>`pid ${t.pid} (${p(t.pid)?"running":"exited"}) \u2014 ${t.command}`).join(`
+`))}})}u(S,"default");export{S as default};

package/openadapter/extensions/koda-commands.mjs

@@ -0,0 +1,15 @@
+var f=Object.defineProperty;var s=(n,t)=>f(n,"name",{value:t,configurable:!0});import{existsSync as c,readdirSync as p,readFileSync as g,statSync as u,unlinkSync as y,writeFileSync as h}from"node:fs";import{homedir as _}from"node:os";import{join as d}from"node:path";function K(){return d(process.env.KODA_CODING_AGENT_DIR||d(_(),".koda","agent"),"checkpoints")}s(K,"checkpointBase");function v(){const n=K();if(!c(n))return null;const t=p(n).map(e=>d(n,e)).filter(e=>{try{return u(e).isDirectory()}catch{return!1}});return t.length?t.sort((e,o)=>u(o).mtimeMs-u(e).mtimeMs)[0]:null}s(v,"latestCheckpointDir");function D(n){n.registerCommand("undo",{description:"Revert file changes Koda made this session (restore from the safety checkpoint)",handler:s(async(t,e)=>{const o=v(),r=[];if(o){for(const i of p(o))if(i.endsWith(".json"))try{r.push(JSON.parse(g(d(o,i),"utf-8")))}catch{}}if(!r.length){e.ui.notify("Nothing to undo \u2014 no recorded file changes.","info");return}if(!await e.ui.confirm("Undo",`Restore ${r.length} file(s) to their pre-session state? This discards Koda's edits to them.`))return;let l=0,m=0;for(const i of r)try{i.existed?(h(i.path,i.content??"","utf-8"),l++):c(i.path)&&(y(i.path),m++)}catch{}e.ui.notify(`Undo complete: ${l} restored, ${m} removed.`,"info")},"handler")}),n.registerCommand("init",{description:"Create an AGENTS.md with project conventions Koda will follow",handler:s(async(t,e)=>{const o=d(process.cwd(),"AGENTS.md");if(c(o)){e.ui.notify("AGENTS.md already exists \u2014 nothing to do.","info");return}h(o,`# Project guide for Koda
+
+## Overview
+_What this project is and what it does._
+
+## Conventions
+- _Coding style, naming, file/module layout._
+
+## Build & test
+- Build: _command_
+- Test: _command_ (run this to verify changes)
+
+## Do / don't
+- _Anything Koda should always or never do in this repo._
+`,"utf-8"),e.ui.notify("Created AGENTS.md \u2014 fill it in; Koda reads it as project context.","info")},"handler")}),n.registerCommand("zenitsu",{description:"Zenitsu mode \u2014 speeds things up (toggle)",handler:s(async(t,e)=>{const o=process.env.KODA_ZENITSU==="1";process.env.KODA_ZENITSU=o?"0":"1",e.ui.notify(o?"Zenitsu off.":"\xBB Zenitsu on \u2014 speeds things up.","info"),e.ui.requestRender?.()},"handler")}),n.registerCommand("plan",{description:"Plan mode \u2014 Koda investigates and proposes a plan; no changes until you run /build",handler:s(async(t,e)=>{process.env.KODA_MODE="plan",e.ui.notify("\u25B9 Plan mode \u2014 Koda will investigate and propose a plan. No files change. Run /build when you're ready to execute.","info"),e.ui.requestRender?.()},"handler")}),n.registerCommand("build",{description:"Build mode \u2014 Koda executes (make changes). Switch here from plan mode to run the plan",handler:s(async(t,e)=>{const o=process.env.KODA_MODE==="plan";process.env.KODA_MODE="build",e.ui.notify(o?"\u25B8 Build mode \u2014 approved. Tell Koda to go ahead and it'll execute the plan.":"\u25B8 Build mode \u2014 Koda will make changes.","info"),e.ui.requestRender?.()},"handler")}),n.registerShortcut("ctrl+alt+p",{description:"Toggle plan / build mode",handler:s(async t=>{const e=process.env.KODA_MODE!=="plan";process.env.KODA_MODE=e?"plan":"build",t.ui.notify(e?"\u25B9 Plan mode \u2014 Koda proposes a plan (no changes). Ctrl+Alt+P or /build to execute.":"\u25B8 Build mode \u2014 Koda will make changes.","info"),t.ui.requestRender?.()},"handler")}),n.registerCommand("help",{description:"List available slash commands",handler:s(async(t,e)=>{const r=n.getCommands().slice().sort((a,l)=>a.name.localeCompare(l.name)).map(a=>`/${a.name}${a.description?` \u2014 ${a.description}`:""}`);await e.ui.select("Koda commands",r)},"handler")})}s(D,"kodaCommands");export{D as default};

package/openadapter/extensions/koda-help.js

@@ -0,0 +1,8 @@
+var h=Object.defineProperty;var a=(o,t)=>h(o,"name",{value:t,configurable:!0});import{readFileSync as y}from"node:fs";import{homedir as _}from"node:os";import{join as f}from"node:path";import{Text as k}from"@openadapter/koda-tui";import{Type as g}from"typebox";function w(){let o=process.env.OPENADAPTER_BASE_URL||"",t=process.env.OPENADAPTER_API_KEY||"";if(!o||!t)try{const n=process.env.KODA_CODING_AGENT_DIR||f(_(),".koda","agent"),e=JSON.parse(y(f(n,"models.json"),"utf-8"));o=o||e?.providers?.openadapter?.baseUrl||"",t=t||e?.providers?.openadapter?.apiKey||""}catch{}return t?{root:(o||"https://api.openadapter.in/v1").replace(/\/v1\/?$/,"").replace(/\/$/,""),key:t}:null}a(w,"getGateway");const E=process.env.KODA_HELPER_MODEL||"glm-5.1";let p;async function b(o,t,n){if(!p){p=new Map;try{const e=await fetch(`${o}/v1/models`,{headers:{Authorization:`Bearer ${t}`}});if(e.ok){const l=await e.json();for(const r of l.data??[])r.tier&&p.set(r.id,r.tier)}}catch{}}return p.get(n)}a(b,"tierOf");function A(o){const t=[];try{for(const n of o.sessionManager.getBranch().slice(-16)){const e=n?.message;if(e)if(e.role==="user"||e.role==="assistant"){const l=typeof e.content=="string"?e.content:Array.isArray(e.content)?e.content.filter(r=>r?.type==="text").map(r=>r.text).join(" "):"";l.trim()&&t.push(`${e.role}: ${l.trim()}`)}else e.role==="toolResult"&&t.push(`  result(${e.toolName??""}): ${(typeof e.content=="string"?e.content:"").slice(0,200)}`)}}catch{}return t.join(`
+`).slice(-4e3)}a(A,"recentContext");const i=a(o=>({content:[{type:"text",text:o}]}),"text");function v(o){o.registerTool({name:"ask_for_help",label:"Ask for help",description:"Stuck, unsure how to approach a task, or about to give up or guess? Ask a more capable SENIOR model for a concrete, step-by-step plan, then follow it. Returns the plan \u2014 carry it out yourself.",promptSnippet:"ask_for_help: get a step-by-step plan from a senior model when you're stuck",promptGuidelines:["If you are unsure how to do something, stuck, or tempted to give up or guess, call ask_for_help with a clear description of the task/problem to get a concrete plan from a senior model \u2014 then follow that plan instead of guessing."],parameters:g.Object({question:g.String({description:"What you need help with, e.g. 'give me a plan to X' or 'I'm stuck on Y'"})}),async execute(t,n,e,l,r){const c=w();if(!c)return i("ask_for_help unavailable: no OpenAdapter key.");const u=r?.model?.id;if(u&&await b(c.root,c.key,u)==="max")return i("You are already a top-tier model \u2014 work through this directly; there is no more senior model to consult.");try{const s=await fetch(`${c.root}/v1/chat/completions`,{method:"POST",headers:{Authorization:`Bearer ${c.key}`,"Content-Type":"application/json"},body:JSON.stringify({model:E,temperature:0,messages:[{role:"system",content:"You are a senior engineer advising a smaller, less capable model that is working in a coding agent. Given the problem and what it has tried, give a CONCRETE, numbered, step-by-step plan it can follow directly \u2014 name exact files, commands, and tools to use, and call out the likely pitfalls. Be specific and decisive; if you were doing it yourself, lay out exactly what you'd do. Keep it tight (no preamble)."},{role:"user",content:`PROBLEM:
+${n.question}
+
+WHAT'S HAPPENED SO FAR:
+${A(r)}`}]})});if(!s.ok)return i(`ask_for_help: senior model unavailable (HTTP ${s.status}). Proceed with your best judgement.`);const d=await s.json(),m=(d?.choices?.[0]?.message?.content??d?.choices?.[0]?.message?.reasoning_content??"").trim();return i(m?`Senior model's plan \u2014 follow these steps:
+
+${m}`:"ask_for_help: no plan returned. Proceed with your best judgement.")}catch(s){return i(`ask_for_help failed: ${s.message}. Proceed with your best judgement.`)}},renderCall(t,n){return new k(n.fg("toolTitle",n.bold("ask_for_help "))+n.fg("muted",String(t.question).slice(0,80)),0,0)}})}a(v,"default");export{v as default};

package/openadapter/extensions/koda-memory.js

@@ -0,0 +1,16 @@
+var C=Object.defineProperty;var a=(n,e)=>C(n,"name",{value:e,configurable:!0});import{existsSync as O,mkdirSync as S,readFileSync as d,writeFileSync as $}from"node:fs";import{homedir as b}from"node:os";import{dirname as D,join as u}from"node:path";import{matchesKey as A,Text as R,truncateToWidth as v}from"@openadapter/koda-tui";import{Type as l}from"typebox";const x=`# Koda memory
+
+`;function j(){const n=process.env.KODA_CODING_AGENT_DIR||u(b(),".koda","agent");return u(n,"koda-memory.md")}a(j,"userMemoryPath");function k(){return u(process.cwd(),"koda-memory.md")}a(k,"projectMemoryPath");function I(n){return n==="user"?j():k()}a(I,"memoryPath");function g(n){if(!O(n))return[];try{return d(n,"utf-8").split(`
+`).filter(e=>e.trim().startsWith("- ")).map(e=>e.trim().slice(2).trim()).filter(Boolean)}catch{return[]}}a(g,"readFacts");function E(n,e){const t=e.trim().replace(/\s+/g," ");if(!t)return!1;const r=I(n);if(g(r).some(i=>i.toLowerCase()===t.toLowerCase()))return!1;S(D(r),{recursive:!0});const s=O(r)?d(r,"utf-8").replace(/\s*$/,""):x.replace(/\s*$/,"");return $(r,`${s}
+- ${t}
+`,"utf-8"),!0}a(E,"addFact");const y=a(n=>({content:[{type:"text",text:n}]}),"textResult");function _(){let n=process.env.OPENADAPTER_BASE_URL||"",e=process.env.OPENADAPTER_API_KEY||"";if(!n||!e)try{const t=process.env.KODA_CODING_AGENT_DIR||u(b(),".koda","agent"),r=JSON.parse(d(u(t,"models.json"),"utf-8"));n=n||r?.providers?.openadapter?.baseUrl||"",e=e||r?.providers?.openadapter?.apiKey||""}catch{}return e?{root:(n||"https://api.openadapter.in/v1").replace(/\/v1\/?$/,"").replace(/\/$/,""),key:e}:null}a(_,"getGateway");const L=process.env.KODA_EMBED_MODEL||"bge-m3";function w(){const n=process.env.KODA_CODING_AGENT_DIR||u(b(),".koda","agent");return u(n,".koda-mem-emb.json")}a(w,"embedCachePath");function G(){try{return JSON.parse(d(w(),"utf-8"))}catch{return{}}}a(G,"readEmbedCache");function K(n){try{S(D(w()),{recursive:!0}),$(w(),JSON.stringify(n),"utf-8")}catch{}}a(K,"writeEmbedCache");async function T(n){const e=_();if(!e||n.length===0)return null;try{const t=await fetch(`${e.root}/v1/embeddings`,{method:"POST",headers:{Authorization:`Bearer ${e.key}`,"Content-Type":"application/json"},body:JSON.stringify({model:L,input:n})});if(!t.ok)return null;const o=((await t.json())?.data||[]).map(s=>s.embedding);return o.length===n.length?o:null}catch{return null}}a(T,"embed");function q(n,e){let t=0,r=0,o=0;for(let s=0;s<n.length;s++)t+=n[s]*e[s],r+=n[s]*n[s],o+=e[s]*e[s];return r&&o?t/(Math.sqrt(r)*Math.sqrt(o)):0}a(q,"cosine");async function U(n,e,t){if(e.length===0)return[];const r=G(),o=e.filter(i=>!r[i]);if(o.length){const i=await T(o);if(!i)return null;o.forEach((c,f)=>{r[c]=i[f]}),K(r)}const s=await T([n]);return s?e.map(i=>({f:i,s:r[i]?q(s[0],r[i]):0})).sort((i,c)=>c.s-i.s).slice(0,t).map(i=>i.f):null}a(U,"semanticRank");function B(){try{const n=process.env.KODA_CODING_AGENT_DIR||u(b(),".koda","agent"),e=JSON.parse(d(u(n,"settings.json"),"utf-8"));if(e?.defaultModel)return e.defaultModel}catch{}return"GLM-4.7"}a(B,"getDefaultModel");function J(n){const e=[];for(const t of n.slice(-40)){const r=t?.message;if(!r||r.role!=="user"&&r.role!=="assistant")continue;let o="";typeof r.content=="string"?o=r.content:Array.isArray(r.content)&&(o=r.content.filter(s=>s?.type==="text").map(s=>s.text).join(" ")),o.trim()&&e.push(`${r.role}: ${o.trim()}`)}return e.join(`
+`).slice(-6e3)}a(J,"extractConvoText");async function F(n){const e=_();if(!e||!n)return[];try{const t=await fetch(`${e.root}/v1/chat/completions`,{method:"POST",headers:{Authorization:`Bearer ${e.key}`,"Content-Type":"application/json"},body:JSON.stringify({model:B(),temperature:0,messages:[{role:"system",content:`From the conversation, extract up to 5 DURABLE facts worth remembering long-term about THIS project or the user's preferences \u2014 architecture, where key code lives, decisions made, conventions, non-obvious gotchas, stated preferences. Skip transient details and anything obvious from the code. Reply with ONLY a JSON array of short one-sentence strings, e.g. ["fact one", "fact two"]. If nothing is worth saving, reply [].`},{role:"user",content:n}]})});if(!t.ok)return[];let o=(await t.json())?.choices?.[0]?.message?.content??"";const s=o.match(/\[[\s\S]*\]/);s&&(o=s[0]);const i=JSON.parse(o);return Array.isArray(i)?i.filter(c=>typeof c=="string"&&c.trim()).map(c=>c.trim()).slice(0,5):[]}catch{return[]}}a(F,"extractFacts");class W{constructor(e,t,r,o){this.user=e;this.project=t;this.theme=r;this.onClose=o}user;project;theme;onClose;static{a(this,"MemoryViewComponent")}handleInput(e){(A(e,"escape")||A(e,"ctrl+c"))&&this.onClose()}render(e){const t=this.theme,r=[""],o=a(i=>v(t.fg("borderMuted","\u2500\u2500\u2500 ")+t.fg("accent",i)+t.fg("borderMuted"," "+"\u2500".repeat(Math.max(0,e-i.length-6))),e),"header"),s=a((i,c)=>{if(r.push(o(i)),c.length===0)r.push(v(`  ${t.fg("dim","(empty)")}`,e));else for(const f of c)r.push(v(`  ${t.fg("accent","\u2022")} ${t.fg("text",f)}`,e));r.push("")},"section");return s(" User memory ",this.user),s(" Project memory ",this.project),r.push(v(`  ${t.fg("dim","Press Escape to close")}`,e)),r}invalidate(){}}function H(n){n.registerTool({name:"remember",label:"Remember",description:"Save an important fact to long-term memory so it's available in future sessions. Use scope 'user' for the user's preferences/taste (cross-project) and 'project' for facts about THIS project (architecture, file layout, key decisions, gotchas). Keep each fact one concise sentence.",promptSnippet:"remember: save an important fact to long-term memory (user or project scope)",promptGuidelines:["When you learn a durable, reusable fact \u2014 a user preference, a project convention, where key code lives, a non-obvious gotcha \u2014 save it with the remember tool (project scope for project facts, user scope for preferences). Don't save transient details or anything already obvious from the code."],parameters:l.Object({fact:l.String({description:"The fact to remember, as one concise sentence"}),scope:l.Union([l.Literal("user"),l.Literal("project")],{description:"'user' for cross-project preferences, 'project' for facts about this project"})}),async execute(e,t){const r=E(t.scope,t.fact);return y(r?`Remembered (${t.scope}): ${t.fact.trim()}`:`Already known (${t.scope}) \u2014 not duplicated.`)},renderCall(e,t){return new R(t.fg("toolTitle",t.bold("remember "))+t.fg("muted",`(${e.scope}) `)+t.fg("dim",String(e.fact).slice(0,80)),0,0)}}),n.registerTool({name:"recall",label:"Recall",description:"Look up facts from long-term memory by meaning. Give a query to semantically retrieve the most relevant facts (embeddings; falls back to substring). Omit the query to list everything. Memory also auto-loads at session start \u2014 use this for an explicit lookup mid-task.",promptSnippet:"recall: semantically look up facts from long-term memory",parameters:l.Object({query:l.Optional(l.String({description:"What to recall; semantic match. Omit to list all."})),limit:l.Optional(l.Number({description:"Max facts to return (default 8)"}))}),async execute(e,t){const r=g(j()),o=g(k());if(r.length===0&&o.length===0)return y("Memory is empty.");const s=a((m,h)=>h.length?`${m}:
+${h.map(M=>`- ${M}`).join(`
+`)}`:"","fmt");if(!t.query)return y([s("User memory",r),s("Project memory",o)].filter(Boolean).join(`
+
+`));const i=t.limit??8,c=new Map;for(const m of r)c.set(m,"user");for(const m of o)c.has(m)||c.set(m,"project");const f=[...c.keys()];let p=await U(t.query,f,i);if(!p){const m=t.query.toLowerCase();p=f.filter(h=>h.toLowerCase().includes(m)).slice(0,i)}if(p.length===0)return y(`No memory matches "${t.query}".`);const P=p.filter(m=>c.get(m)==="user"),N=p.filter(m=>c.get(m)==="project");return y([s("User memory",P),s("Project memory",N)].filter(Boolean).join(`
+
+`))}}),n.on("session_before_compact",async(e,t)=>{try{if(t.mode!=="tui")return;const r=J(e.branchEntries||[]),o=await F(r);if(o.length===0||!await t.ui.confirm("Save to memory before compacting?",`Koda is about to compact this conversation. Save these facts to project memory so they're not lost?
+
+${o.map(c=>`\u2022 ${c}`).join(`
+`)}`))return;let i=0;for(const c of o)E("project",c)&&i++;t.ui.notify(`Saved ${i} fact(s) to project memory.`,"info")}catch{}}),n.registerCommand("memory",{description:"Show what Koda remembers (user + project)",handler:a(async(e,t)=>{const r=g(j()),o=g(k());if(t.mode!=="tui"){t.ui.notify(`User: ${r.length} fact(s), Project: ${o.length} fact(s)`,"info");return}await t.ui.custom((s,i,c,f)=>new W(r,o,i,()=>f()))},"handler")})}a(H,"default");export{H as default};

package/openadapter/extensions/koda-status.js

@@ -0,0 +1 @@
+var y=Object.defineProperty;var o=(n,e)=>y(n,"name",{value:e,configurable:!0});import{readFileSync as _}from"node:fs";import{homedir as b}from"node:os";import{join as f}from"node:path";import{matchesKey as l,truncateToWidth as u}from"@openadapter/koda-tui";function v(){let n=process.env.OPENADAPTER_BASE_URL||"",e=process.env.OPENADAPTER_API_KEY||"";if(!n||!e)try{const t=process.env.KODA_CODING_AGENT_DIR||f(b(),".koda","agent"),r=JSON.parse(_(f(t,"models.json"),"utf-8"));n=n||r?.providers?.openadapter?.baseUrl||"",e=e||r?.providers?.openadapter?.apiKey||""}catch{}return e?{root:(n||"https://api.openadapter.in/v1").replace(/\/v1\/?$/,"").replace(/\/$/,""),key:e}:null}o(v,"getGateway");function k(n){const e=Math.max(0,Math.min(10,Math.round(n/10)));return"\u2588".repeat(e)+"\u2591".repeat(10-e)}o(k,"bar");function A(n){const e=new Date(n).getTime()-Date.now();if(!Number.isFinite(e)||e<=0)return"now";const t=Math.floor(e/6e4),r=Math.floor(t/60),s=Math.floor(r/24);return s>0?`${s}d ${r%24}h`:r>0?`${r}h ${t%60}m`:`${t}m`}o(A,"until");function p(n){return n>=1e6?`${(n/1e6).toFixed(2)}M`:n>=1e3?`${(n/1e3).toFixed(1)}k`:String(n)}o(p,"fmtN");class M{constructor(e,t,r){this.u=e;this.theme=t;this.onClose=r}u;theme;onClose;static{o(this,"StatusComponent")}cachedW;cachedL;handleInput(e){(l(e,"escape")||l(e,"ctrl+c"))&&this.onClose()}render(e){if(this.cachedL&&this.cachedW===e)return this.cachedL;const t=this.theme,r=[""],s=t.fg("borderMuted","\u2500\u2500\u2500 ")+t.fg("accent","Status")+t.fg("borderMuted"," "+"\u2500".repeat(Math.max(0,e-12)));r.push(u(s,e)),r.push(""),r.push(u(`  ${t.fg("muted","Plan")}  ${t.fg("text",this.u.plan_name||"\u2014")}`,e)),r.push("");const a=[["5h","5h"],["Week","week"],["Month","month"]];for(const[m,d]of a){const h=this.u.limits?.[d];if(!h)continue;const c=Math.round(h.percent),g=c>=90?"error":c>=70?"warning":"success",$=`  ${t.fg("text",m.padEnd(6))}${t.fg(g,k(c))} ${t.fg("text",`${c}%`.padStart(4))}  ${t.fg("dim",`${100-c}% left \xB7 resets in ${A(h.resets_at)}`)}`;r.push(u($,e))}r.push("");const i=`  ${t.fg("muted","Today")}  ${t.fg("text",`${p(this.u.requests_today||0)} requests \xB7 ${p(this.u.tokens_today||0)} tokens`)}`;return r.push(u(i,e)),this.u.credit_balance&&r.push(u(`  ${t.fg("muted","Credits")}  ${t.fg("text",String(this.u.credit_balance))}`,e)),r.push(""),r.push(u(`  ${t.fg("dim","Press Escape to close")}`,e)),this.cachedW=e,this.cachedL=r,r}invalidate(){this.cachedW=void 0,this.cachedL=void 0}}function E(n){n.registerCommand("status",{description:"Show plan usage \u2014 5h / week / month limits, resets, and today's tokens",handler:o(async(e,t)=>{const r=v();if(!r){t.ui.notify("Status unavailable: no OpenAdapter key.","error");return}let s;try{const a=await fetch(`${r.root}/api/usage`,{headers:{Authorization:`Bearer ${r.key}`}});if(!a.ok){t.ui.notify(`Status: usage unavailable (HTTP ${a.status}).`,"error");return}s=await a.json()}catch(a){t.ui.notify(`Status failed: ${a.message}`,"error");return}if(t.mode!=="tui"){const a=o(i=>s.limits?.[i]?`${i} ${Math.round(s.limits[i].percent)}%`:"","f");t.ui.notify(`Plan ${s.plan_name||"?"} \xB7 ${["5h","week","month"].map(a).filter(Boolean).join(" \xB7 ")} \xB7 ${p(s.tokens_today||0)} tokens today`,"info");return}await t.ui.custom((a,i,m,d)=>new M(s,i,()=>d()))},"handler")})}o(E,"default");export{E as default};

package/openadapter/extensions/koda-todo.js

@@ -0,0 +1,4 @@
+var y=Object.defineProperty;var x=(u,t)=>y(u,"name",{value:t,configurable:!0});import{StringEnum as v}from"@openadapter/koda-ai";import{matchesKey as T,Text as l,truncateToWidth as p}from"@openadapter/koda-tui";import{Type as h}from"typebox";const b=h.Object({action:v(["list","add","toggle","clear"]),text:h.Optional(h.String({description:"Todo text (for add)"})),id:h.Optional(h.Number({description:"Todo ID (for toggle)"}))});class w{static{x(this,"TodoListComponent")}todos;theme;onClose;cachedWidth;cachedLines;constructor(t,n,i){this.todos=t,this.theme=n,this.onClose=i}handleInput(t){(T(t,"escape")||T(t,"ctrl+c"))&&this.onClose()}render(t){if(this.cachedLines&&this.cachedWidth===t)return this.cachedLines;const n=[],i=this.theme;n.push("");const d=i.fg("accent"," Todos "),e=i.fg("borderMuted","\u2500".repeat(3))+d+i.fg("borderMuted","\u2500".repeat(Math.max(0,t-10)));if(n.push(p(e,t)),n.push(""),this.todos.length===0)n.push(p(`  ${i.fg("dim","No todos yet. Ask the agent to add some!")}`,t));else{const s=this.todos.filter(c=>c.done).length,a=this.todos.length;n.push(p(`  ${i.fg("muted",`${s}/${a} completed`)}`,t)),n.push("");for(const c of this.todos){const o=c.done?i.fg("success","\u2713"):i.fg("dim","\u25CB"),r=i.fg("accent",`#${c.id}`),f=c.done?i.fg("dim",c.text):i.fg("text",c.text);n.push(p(`  ${o} ${r} ${f}`,t))}}return n.push(""),n.push(p(`  ${i.fg("dim","Press Escape to close")}`,t)),n.push(""),this.cachedWidth=t,this.cachedLines=n,n}invalidate(){this.cachedWidth=void 0,this.cachedLines=void 0}}function _(u){let t=[],n=1;const i=x(d=>{t=[],n=1;for(const e of d.sessionManager.getBranch()){if(e.type!=="message")continue;const s=e.message;if(s.role!=="toolResult"||s.toolName!=="todo")continue;const a=s.details;a&&(t=a.todos,n=a.nextId)}},"reconstructState");u.on("session_start",async(d,e)=>i(e)),u.on("session_tree",async(d,e)=>i(e)),u.registerTool({name:"todo",label:"Todo",description:"Track a plan as a todo list for multi-step work. Actions: add (text) one item per step, toggle (id) when a step is done, list to review, clear to reset. For any task with more than a couple of steps, add all steps up front, then toggle each as you complete it.",parameters:b,async execute(d,e,s,a,c){switch(e.action){case"list":return{content:[{type:"text",text:t.length?t.map(o=>`[${o.done?"x":" "}] #${o.id}: ${o.text}`).join(`
+`):"No todos"}],details:{action:"list",todos:[...t],nextId:n}};case"add":{if(!e.text)return{content:[{type:"text",text:"Error: text required for add"}],details:{action:"add",todos:[...t],nextId:n,error:"text required"}};const o={id:n++,text:e.text,done:!1};return t.push(o),{content:[{type:"text",text:`Added todo #${o.id}: ${o.text}`}],details:{action:"add",todos:[...t],nextId:n}}}case"toggle":{if(e.id===void 0)return{content:[{type:"text",text:"Error: id required for toggle"}],details:{action:"toggle",todos:[...t],nextId:n,error:"id required"}};const o=t.find(r=>r.id===e.id);return o?(o.done=!o.done,{content:[{type:"text",text:`Todo #${o.id} ${o.done?"completed":"uncompleted"}`}],details:{action:"toggle",todos:[...t],nextId:n}}):{content:[{type:"text",text:`Todo #${e.id} not found`}],details:{action:"toggle",todos:[...t],nextId:n,error:`#${e.id} not found`}}}case"clear":{const o=t.length;return t=[],n=1,{content:[{type:"text",text:`Cleared ${o} todos`}],details:{action:"clear",todos:[],nextId:1}}}default:return{content:[{type:"text",text:`Unknown action: ${e.action}`}],details:{action:"list",todos:[...t],nextId:n,error:`unknown action: ${e.action}`}}}},renderCall(d,e,s){let a=e.fg("toolTitle",e.bold("todo "))+e.fg("muted",d.action);return d.text&&(a+=` ${e.fg("dim",`"${d.text}"`)}`),d.id!==void 0&&(a+=` ${e.fg("accent",`#${d.id}`)}`),new l(a,0,0)},renderResult(d,{expanded:e},s,a){const c=d.details;if(!c){const r=d.content[0];return new l(r?.type==="text"?r.text:"",0,0)}if(c.error)return new l(s.fg("error",`Error: ${c.error}`),0,0);const o=c.todos;switch(c.action){case"list":{if(o.length===0)return new l(s.fg("dim","No todos"),0,0);let r=s.fg("muted",`${o.length} todo(s):`);const f=e?o:o.slice(0,5);for(const g of f){const m=g.done?s.fg("success","\u2713"):s.fg("dim","\u25CB"),$=g.done?s.fg("dim",g.text):s.fg("muted",g.text);r+=`
+${m} ${s.fg("accent",`#${g.id}`)} ${$}`}return!e&&o.length>5&&(r+=`
+${s.fg("dim",`... ${o.length-5} more`)}`),new l(r,0,0)}case"add":{const r=o[o.length-1];return new l(s.fg("success","\u2713 Added ")+s.fg("accent",`#${r.id}`)+" "+s.fg("muted",r.text),0,0)}case"toggle":{const r=d.content[0],f=r?.type==="text"?r.text:"";return new l(s.fg("success","\u2713 ")+s.fg("muted",f),0,0)}case"clear":return new l(s.fg("success","\u2713 ")+s.fg("muted","Cleared all todos"),0,0)}}}),u.registerCommand("todos",{description:"Show all todos on the current branch",handler:x(async(d,e)=>{if(e.mode!=="tui"){e.ui.notify("/todos requires interactive mode","error");return}await e.ui.custom((s,a,c,o)=>new w(t,a,()=>o()))},"handler")})}x(_,"default");export{_ as default};

package/openadapter/extensions/koda-vision.js

@@ -0,0 +1,4 @@
+var x=Object.defineProperty;var c=(t,e)=>x(t,"name",{value:e,configurable:!0});import{createHash as E}from"node:crypto";import{readFileSync as A}from"node:fs";import{homedir as I}from"node:os";import{join as f}from"node:path";function T(){let t=process.env.OPENADAPTER_BASE_URL||"",e=process.env.OPENADAPTER_API_KEY||"";if(!t||!e)try{const n=process.env.KODA_CODING_AGENT_DIR||f(I(),".koda","agent"),i=JSON.parse(A(f(n,"models.json"),"utf-8"));t=t||i?.providers?.openadapter?.baseUrl||"",e=e||i?.providers?.openadapter?.apiKey||""}catch{}return e?{root:(t||"https://api.openadapter.in/v1").replace(/\/v1\/?$/,"").replace(/\/$/,""),key:e}:null}c(T,"getGateway");let g;async function p(t,e){if(g)return g;g=new Map;try{const n=await fetch(`${t}/v1/models`,{headers:{Authorization:`Bearer ${e}`}});if(n.ok){const i=await n.json();for(const o of i.data??[])g.set(o.id,{vision:!!o.supports_vision,tier:o.tier??""})}}catch{}return g}c(p,"loadModelInfo");const h=["freemium","lite","pro","max"];let m;async function b(t,e){if(process.env.KODA_VISION_MODEL)return process.env.KODA_VISION_MODEL;if(m!==void 0)return m;const i=[...(await p(t,e)).entries()].filter(([,o])=>o.vision);return i.sort(([,o],[,r])=>{const s=h.indexOf(o.tier),a=h.indexOf(r.tier);return(s===-1?99:s)-(a===-1?99:a)}),m=i[0]?.[0]??null,m}c(b,"pickExtractor");async function w(t,e){const n=e?.model?.id;if(n){const r=(await p(t.root,t.key)).get(n);if(r)return r.vision}const i=e?.model?.input;return Array.isArray(i)?i.includes("image"):!1}c(w,"activeModelSeesImages");const y=new Map;function _(t){const e=E("sha1");for(const n of t)e.update(n.mimeType).update(n.data.slice(0,4096)).update(String(n.data.length));return e.digest("hex")}c(_,"imagesKey");const $="You are a vision extractor for a coding agent. The downstream model is blind, so it relies entirely on your description. Transcribe ALL visible text VERBATIM (code, errors, logs, UI labels, URLs), and describe the image in full technical detail: layout/structure, diagrams and their connections, charts, tables, colors and states where meaningful. Be literal, thorough, and well-organized. No preamble, no opinions \u2014 just the faithful contents.";async function O(t,e,n,i){const o=[{type:"text",text:i?`The user's message: "${i}". Extract everything from the attached image(s) relevant to it.`:"Extract everything from the attached image(s)."},...n.map(d=>({type:"image_url",image_url:{url:`data:${d.mimeType};base64,${d.data}`}}))],r=await fetch(`${t.root}/v1/chat/completions`,{method:"POST",headers:{Authorization:`Bearer ${t.key}`,"Content-Type":"application/json"},body:JSON.stringify({model:e,temperature:0,messages:[{role:"system",content:$},{role:"user",content:o}]})});if(!r.ok)throw new Error(`vision model HTTP ${r.status}`);const s=await r.json(),a=(s?.choices?.[0]?.message?.content??s?.choices?.[0]?.message?.reasoning_content??"").trim();if(!a)throw new Error("vision model returned empty");return a}c(O,"extract");function S(t){t.on("input",async(e,n)=>{if(process.env.KODA_VISION_BRIDGE==="0")return{action:"continue"};const i=Array.isArray(e?.images)?e.images:[];if(i.length===0)return{action:"continue"};const o=T();if(!o)return{action:"continue"};if(await w(o,n))return{action:"continue"};const r=i.length,s=r>1?`${r} images`:"the image",a=await b(o.root,o.key);if(!a)return n?.ui?.notify?.(`This model can't see images and no vision model is available \u2014 ${s} may be ignored.`,"warning"),{action:"continue"};n?.ui?.notify?.(`This model can't see images \u2014 Koda is using a vision model to read ${s}, then continuing here.`,"warning");let d;const l=_(i),u=y.get(l);try{d=u??await O(o,a,i,String(e?.text??"")),u||y.set(l,d)}catch(v){return n?.ui?.notify?.(`Couldn't read ${s} (vision step failed: ${v.message}). Sending your text only.`,"error"),{action:"transform",text:String(e?.text??""),images:[]}}return{action:"transform",text:`${String(e?.text??"")}
+
+[Koda vision bridge \u2014 you attached ${s}; the active model can't see, so a vision model read ${r>1?"them":"it"} for you:]
+${d}`,images:[]}})}c(S,"default");export{S as default};

package/openadapter/extensions/koda-web.js

@@ -0,0 +1,7 @@
+var P=Object.defineProperty;var d=(o,r)=>P(o,"name",{value:r,configurable:!0});import{readFileSync as h}from"node:fs";import{basename as b}from"node:path";import{Text as m}from"@openadapter/koda-tui";import{Type as c}from"typebox";import{homedir as _}from"node:os";import{join as g}from"node:path";function y(){let o=process.env.OPENADAPTER_BASE_URL||"",r=process.env.OPENADAPTER_API_KEY||"";if(!o||!r)try{const a=process.env.KODA_CODING_AGENT_DIR||g(_(),".koda","agent"),n=JSON.parse(h(g(a,"models.json"),"utf-8"))?.providers?.openadapter;o=o||n?.baseUrl||"",r=r||n?.apiKey||""}catch{}return r?{root:(o||"https://api.openadapter.in/v1").replace(/\/v1\/?$/,"").replace(/\/$/,""),key:r}:{error:"No OpenAdapter API key found (set OPENADAPTER_API_KEY or run setup)."}}d(y,"getGateway");async function w(o,r,e){const a=y();if("error"in a)throw new Error(a.error);const t=await fetch(`${a.root}${o}`,{method:"POST",headers:{Authorization:`Bearer ${a.key}`,"Content-Type":"application/json"},body:JSON.stringify(r),signal:e}),n=await t.text();if(!t.ok)throw new Error(`HTTP ${t.status}: ${n.slice(0,200)}`);try{return JSON.parse(n)}catch{return{raw:n}}}d(w,"postJson");const i=d(o=>({content:[{type:"text",text:o}]}),"textResult");function S(o){o.registerTool({name:"search",label:"Web search",description:"Search the web for current information \u2014 docs, error messages, library APIs, best practices. Returns the top results (title, URL, snippet).",promptSnippet:"search: search the web and get the top results",parameters:c.Object({query:c.String({description:"The search query"}),num_results:c.Optional(c.Number({description:"How many results (default 5)"}))}),async execute(r,e,a){try{const t=await w("/v1/tools/search",{query:e.query,num_results:e.num_results??5},a),n=Array.isArray(t?.results)?t.results:[];if(n.length===0)return i(`No results for "${e.query}".`);const p=n.map((s,l)=>{const f=s.title||s.name||s.url||`result ${l+1}`,u=s.url||s.link||"",T=s.snippet||s.description||s.content||"";return`${l+1}. ${f}
+   ${u}
+   ${String(T).slice(0,300)}`}).join(`
+
+`);return i(p)}catch(t){return i(`search failed: ${t.message}`)}},renderCall(r,e){return new m(e.fg("toolTitle",e.bold("search "))+e.fg("muted",String(r.query)),0,0)}}),o.registerTool({name:"fetch_url",label:"Fetch URL",description:"Fetch a web page and return its main content as clean markdown. Use after search to read a specific page (docs, API reference, an article).",promptSnippet:"fetch_url: read a web page as markdown",parameters:c.Object({url:c.String({description:"The URL to fetch"})}),async execute(r,e,a){try{const t=await w("/v1/tools/scrape/markdown",{url:e.url},a),n=t?.markdown??t?.content??t?.raw??"";if(!n)return i(`No content extracted from ${e.url}.`);const p=t?.title?`# ${t.title}
+
+`:"";return i(p+String(n))}catch(t){return i(`fetch_url failed: ${t.message}`)}},renderCall(r,e){return new m(e.fg("toolTitle",e.bold("fetch_url "))+e.fg("muted",String(r.url)),0,0)}}),o.registerTool({name:"doc_parse",label:"Parse document",description:"Parse a local document (PDF, DOCX, PPTX, XLSX, or HTML) into text/markdown so you can read it. Give the file path.",promptSnippet:"doc_parse: extract text from a local PDF/DOCX/PPTX/XLSX/HTML file",parameters:c.Object({path:c.String({description:"Path to the local document file"})}),async execute(r,e,a){try{const t=y();if("error"in t)return i(`doc_parse failed: ${t.error}`);const n=h(e.path),p=new FormData;p.append("file",new Blob([n]),b(e.path));const s=await fetch(`${t.root}/v1/edge/docparse`,{method:"POST",headers:{Authorization:`Bearer ${t.key}`},body:p,signal:a}),l=await s.text();if(!s.ok)return i(`doc_parse failed: HTTP ${s.status}: ${l.slice(0,200)}`);let f=l;try{const u=JSON.parse(l);f=u.markdown??u.text??u.content??l}catch{}return i(String(f))}catch(t){return i(`doc_parse failed: ${t.message}`)}},renderCall(r,e){return new m(e.fg("toolTitle",e.bold("doc_parse "))+e.fg("muted",String(r.path)),0,0)}})}d(S,"default");export{S as default};

package/openadapter/setup.mjs

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+// Koda first-run setup (Phase 1 — paste key).
+//
+// Paste an OpenAdapter API key; Koda fetches the live model list from the
+// gateway, registers OpenAdapter as the default provider, and picks a sensible
+// default coding model — so `koda` just works afterward.
+//
+//   node scripts/setup-openadapter.mjs <sk-cv-key>
+//   OPENADAPTER_API_KEY=sk-cv-... node scripts/setup-openadapter.mjs
+//   node scripts/setup-openadapter.mjs           # prompts for the key
+
+import { readFileSync, writeFileSync, mkdirSync, existsSync, cpSync, readdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+import { createInterface } from "node:readline/promises";
+
+const BASE_URL = (process.env.OPENADAPTER_BASE_URL || "https://api.openadapter.in/v1").replace(/\/$/, "");
+// Honors KODA_CODING_AGENT_DIR (same as the CLI); defaults to ~/.koda/agent
+const AGENT_DIR = process.env.KODA_CODING_AGENT_DIR || join(homedir(), ".koda", "agent");
+
+// Default-model preference (first match wins). glm-5.1 leads: it cleanly builds
+// complex projects from scratch (4-step full pass on the spreadsheet-engine eval)
+// where the DeepSeek reasoners "think-to-a-stop". Exact-id match wins over a
+// substring so we pick the direct `glm-5.1` alias, not 0G-/TEE- variants.
+const PREFER = ["glm-5.1", "kimi-k2.6", "kimi-k2.5", "glm-5", "deepseek-v4", "kimi", "glm", "deepseek", "qwen"];
+
+async function getKey() {
+  const arg = process.argv[2];
+  if (arg && arg.startsWith("sk-")) return arg.trim();
+  if (process.env.OPENADAPTER_API_KEY) return process.env.OPENADAPTER_API_KEY.trim();
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const k = (await rl.question("Paste your OpenAdapter API key (sk-cv-...): ")).trim();
+  rl.close();
+  return k;
+}
+
+function pickDefault(ids) {
+  const low = ids.map((id) => [id, id.toLowerCase()]);
+  for (const p of PREFER) {
+    const exact = low.find(([, l]) => l === p);
+    if (exact) return exact[0];
+    const partial = low.find(([, l]) => l.includes(p));
+    if (partial) return partial[0];
+  }
+  return ids[0];
+}
+
+function mergeJson(path, mutate) {
+  let obj = {};
+  if (existsSync(path)) {
+    try { obj = JSON.parse(readFileSync(path, "utf-8")); } catch { /* start fresh on corrupt */ }
+  }
+  mutate(obj);
+  writeFileSync(path, JSON.stringify(obj, null, 2) + "\n", "utf-8");
+}
+
+const key = await getKey();
+if (!key || !key.startsWith("sk-")) {
+  console.error("✗ No valid OpenAdapter key (expected sk-cv-...).");
+  process.exit(1);
+}
+
+console.log(`→ Fetching models from ${BASE_URL}/models …`);
+let res;
+try {
+  res = await fetch(`${BASE_URL}/models`, { headers: { Authorization: `Bearer ${key}` } });
+} catch (e) {
+  console.error(`✗ Network error: ${e.message}`);
+  process.exit(1);
+}
+if (!res.ok) {
+  console.error(`✗ ${res.status} ${res.statusText}: ${(await res.text()).slice(0, 200)}`);
+  process.exit(1);
+}
+
+const body = await res.json();
+const all = Array.isArray(body.data) ? body.data : [];
+// Koda is a coding (chat) agent — keep chat models, drop image/audio/embedding endpoints.
+const chat = all.filter((m) => (m.endpoint_format || m.model_type) === "chat");
+if (chat.length === 0) {
+  console.error("✗ No chat models returned from the gateway.");
+  process.exit(1);
+}
+
+const models = chat.map((m) => ({
+  id: m.id,
+  name: m.id,
+  input: m.supports_vision ? ["text", "image"] : ["text"],
+  // Generous output budget so the agent can think AND write large files in one
+  // turn. Without this, requests defaulted to ~4096 and big writes truncated
+  // (stop=length) — the model burned the budget thinking and never wrote.
+  // The gateway clamps this down per-provider where needed.
+  maxTokens: 16000,
+}));
+const defaultModel = pickDefault(chat.map((m) => m.id));
+
+mkdirSync(AGENT_DIR, { recursive: true });
+
+mergeJson(join(AGENT_DIR, "models.json"), (cfg) => {
+  cfg.providers = cfg.providers || {};
+  cfg.providers.openadapter = {
+    name: "OpenAdapter",
+    baseUrl: BASE_URL,
+    apiKey: key,
+    api: "openai-completions",
+    models,
+  };
+});
+
+// Auto-load Koda's extensions — absolute paths so they resolve regardless of
+// where `koda` is invoked from:
+//   koda-commands.mjs — /undo, /init, /zenitsu, /plan, /build, /help
+//   koda-todo.ts      — the `todo` planning tool + /todos viewer
+//   koda-web.ts       — search, fetch_url, doc_parse tools
+// Resolve the extensions dir for both layouts: bundled in the npm package
+// (<pkg>/openadapter/{setup.mjs,extensions,skills}) → "./extensions"; or the
+// repo (scripts/setup-openadapter.mjs + ../extensions) → "../extensions".
+const here = dirname(fileURLToPath(import.meta.url));
+const extDir = existsSync(join(here, "extensions")) ? join(here, "extensions") : join(here, "..", "extensions");
+// Register each extension by whichever file actually ships: published builds bundle
+// minified .js (closed-source), the dev repo has .ts source. Pick the existing one.
+const kodaExtensionBases = [
+  "koda-commands",
+  "koda-todo",
+  "koda-web",
+  "koda-memory",
+  "koda-help",
+  "koda-status",
+  "koda-bg",
+  "koda-ask",
+  "koda-vision",
+];
+const kodaExtensions = kodaExtensionBases
+  .map((base) => {
+    for (const ext of [".js", ".mjs", ".ts"]) {
+      const p = join(extDir, base + ext);
+      if (existsSync(p)) return p;
+    }
+    return null;
+  })
+  .filter(Boolean);
+mergeJson(join(AGENT_DIR, "settings.json"), (s) => {
+  s.defaultProvider = "openadapter";
+  s.defaultModel = defaultModel;
+  const exts = new Set([...(Array.isArray(s.extensions) ? s.extensions : []), ...kodaExtensions]);
+  s.extensions = [...exts];
+});
+
+// Install Koda's built-in skills (frontend, debugging, code-review) so they're
+// available out of the box. Each is a SKILL.md dir auto-discovered from ~/.koda/agent/skills.
+const skillsSrc = join(extDir, "..", "skills");
+const skillsDst = join(AGENT_DIR, "skills");
+try {
+  if (existsSync(skillsSrc)) {
+    let n = 0;
+    for (const name of readdirSync(skillsSrc)) {
+      const s = join(skillsSrc, name);
+      if (existsSync(join(s, "SKILL.md"))) {
+        cpSync(s, join(skillsDst, name), { recursive: true });
+        n++;
+      }
+    }
+    if (n) console.log(`✓ Installed ${n} built-in skill(s) → ${skillsDst}`);
+  }
+} catch (e) {
+  console.error(`(built-in skills skipped: ${e.message})`);
+}
+
+console.log(`✓ Registered ${models.length} models from OpenAdapter`);
+console.log(`✓ Default model: openadapter/${defaultModel}`);
+console.log(`✓ Wrote ${join(AGENT_DIR, "models.json")} and settings.json`);
+console.log(`\nDone — run \`koda\` to start.`);

package/openadapter/skills/code-review/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: code-review
+description: Use when reviewing code or a diff — checking changes for correctness, security, error handling, tests, and consistency before they land.
+---
+
+# Code review
+
+Review against what the change is trying to do. Be specific and grounded in the actual code.
+
+## What to check, in priority order
+1. **Correctness** — does it do what it claims? Walk the logic. Hunt edge cases: empty/null, boundaries, concurrency, large inputs, error paths.
+2. **Security** — untrusted input validated? No injection (SQL/shell/path), no secrets in code or logs, authz checks present, safe defaults.
+3. **Error handling** — failures handled, not swallowed; no bare catches that hide problems; resources cleaned up.
+4. **Tests** — is the new behavior covered? Do existing tests still pass? Are the tests meaningful (not asserting trivia)?
+5. **Consistency** — matches the codebase's existing patterns, naming, and style. No unused code, no stray debug logs, no commented-out blocks.
+6. **Clarity** — would the next person understand it? Names say what they mean; non-obvious bits explained.
+
+## How to deliver the review
+- Cite exact `file:line` for each point so it's actionable.
+- **Separate must-fix from nits.** Lead with the things that are actually wrong (bugs, security, broken tests); mark style/preference items clearly as optional.
+- Ground every claim in the code you read — don't speculate about code you haven't opened. If you're unsure something is a real problem, say so rather than asserting it.
+- Acknowledge what's good, briefly. The goal is a better change landing, not a longer list.

package/openadapter/skills/debugging/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: debugging
+description: Use when something is broken, failing, throwing an error, or behaving unexpectedly — to find and fix the root cause instead of guessing.
+---
+
+# Debugging
+
+Don't guess and patch. Find the actual cause, then fix it.
+
+## 1. Reproduce it first
+- Get a reliable, minimal way to trigger the bug before changing anything. If you can't reproduce it, you can't confirm a fix.
+- Capture the exact error message and full stack trace — read them carefully; they usually name the file and line.
+
+## 2. Locate, with evidence
+- grep/read the actual code at the failing site and the values flowing into it. Don't theorize about code you haven't read.
+- Narrow it down: bisect (which change/commit introduced it?), add targeted logging, or build the smallest input that still fails.
+- Form ONE hypothesis at a time and test it. State what you expect vs. what you observe.
+
+## 3. Fix the root cause
+- Fix the underlying cause, not the symptom. A try/catch that swallows the error, or a special-case that hides it, is not a fix.
+- Make the smallest change that addresses the cause; don't refactor unrelated code while debugging.
+
+## 4. Verify
+- Re-run the original reproduction — confirm it's actually gone.
+- Run the project's tests/build to make sure you didn't break something else. Never declare it fixed without re-running and seeing it pass.
+- If there were no tests covering this, consider adding one so it can't regress.
+
+Read before you reason; reproduce before you fix; verify before you claim done.

package/openadapter/skills/frontend/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: frontend
+description: Use when building, changing, or styling a user interface — components, layout, responsive design, accessibility, and making it look polished. For web/React/Vue/Svelte/plain HTML UI work.
+---
+
+# Frontend
+
+Build UI that fits the project and looks intentional. Work in this order.
+
+## 1. Fit the existing project — don't reinvent
+- Detect the stack first: framework (React/Vue/Svelte/plain), styling (Tailwind / CSS modules / styled-components / plain CSS), component library (if any), router, state approach. Read a couple of existing components before writing new ones.
+- **Reuse what's there.** Use the project's existing components, design tokens, spacing scale, and color variables. Never introduce a new UI library or CSS framework unless asked.
+- Match file layout, naming, and import conventions exactly.
+
+## 2. Structure
+- Small, composable components; one responsibility each. Lift state only as far as it needs to go.
+- Keep data-fetching/logic out of presentational components where the codebase already separates them.
+- Type props (TS) or document them; handle the loading, empty, and error states, not just the happy path.
+
+## 3. Make it look good (this is the point)
+- **Hierarchy & spacing:** consistent spacing scale, clear visual hierarchy, generous whitespace. Align things to a grid; don't eyeball one-off margins.
+- **Typography:** limited type sizes/weights, readable line-length and line-height.
+- **Color:** use the existing palette/tokens; enough contrast; a single accent used consistently.
+- **Interactive states:** every interactive element needs hover, focus, active, disabled, and loading states. Don't ship a button with no feedback.
+- **Responsive:** design mobile-first; verify it doesn't break at narrow and wide widths.
+- **Motion:** subtle, fast transitions (≤200ms); never gratuitous.
+
+## 4. Accessibility (not optional)
+- Semantic HTML (`button`, `nav`, `label`, headings in order) before ARIA. Reach for a `div` last.
+- Labels tied to inputs; alt text on meaningful images; visible focus rings; keyboard-operable.
+- Don't rely on color alone to convey meaning.
+
+## 5. Verify it actually renders
+- Start the dev server with **run_background** (not bash — it won't return), then check **bg_output** to confirm it came up and there are no build errors.
+- Open the page (e.g. `open http://localhost:5173`) when showing the user, and sanity-check the states you built.
+- Never claim a UI works without seeing it build/run clean.
+
+Default to doing over describing: read the real components, match them, and verify in the browser.

package/package.json

@@ -0,0 +1,108 @@
+{
+	"name": "@openadapter/koda",
+	"version": "1.0.0-beta.3",
+	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
+	"type": "module",
+	"piConfig": {
+		"name": "koda",
+		"configDir": ".koda"
+	},
+	"bin": {
+		"koda": "dist/cli.js"
+	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./hooks": {
+			"types": "./dist/core/hooks/index.d.ts",
+			"import": "./dist/core/hooks/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"docs",
+		"openadapter",
+		"CHANGELOG.md",
+		"npm-shrinkwrap.json"
+	],
+	"scripts": {
+		"clean": "shx rm -rf dist openadapter",
+		"build": "tsgo -p tsconfig.build.json && shx chmod +x dist/cli.js && npm run copy-assets && npm run copy-openadapter",
+		"copy-openadapter": "shx rm -rf openadapter && shx mkdir -p openadapter && shx cp -r ../../extensions openadapter/extensions && shx cp -r ../../skills openadapter/skills && shx cp ../../scripts/setup-openadapter.mjs openadapter/setup.mjs",
+		"build:binary": "npm --prefix ../tui run build && npm --prefix ../ai run build && npm --prefix ../agent run build && npm run build && bun build --compile ./dist/bun/cli.js ./src/utils/image-resize-worker.ts --outfile dist/koda && npm run copy-binary-assets",
+		"copy-assets": "shx mkdir -p dist/modes/interactive/theme && shx cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && shx mkdir -p dist/modes/interactive/assets && shx cp src/modes/interactive/assets/*.png dist/modes/interactive/assets/ && shx mkdir -p dist/core/export-html/vendor && shx cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && shx cp src/core/export-html/vendor/*.js dist/core/export-html/vendor/",
+		"copy-binary-assets": "shx cp package.json dist/ && shx cp README.md dist/ && shx cp CHANGELOG.md dist/ && shx mkdir -p dist/theme && shx cp src/modes/interactive/theme/*.json dist/theme/ && shx mkdir -p dist/assets && shx cp src/modes/interactive/assets/*.png dist/assets/ && shx mkdir -p dist/export-html/vendor && shx cp src/core/export-html/template.html dist/export-html/ && shx cp src/core/export-html/vendor/*.js dist/export-html/vendor/ && shx cp -r docs dist/ && shx cp -r examples dist/ && shx cp ../../node_modules/@silvia-odwyer/photon-node/photon_rs_bg.wasm dist/",
+		"test": "vitest --run",
+		"shrinkwrap": "node ../../scripts/generate-coding-agent-shrinkwrap.mjs",
+		"prepublishOnly": "npm run clean && npm run build && npm run shrinkwrap",
+		"postbuild": "node ../../scripts/minify-pkg-dist.mjs"
+	},
+	"dependencies": {
+		"@openadapter/koda-agent-core": "1.0.0-beta.3",
+		"@openadapter/koda-ai": "1.0.0-beta.3",
+		"@openadapter/koda-tui": "1.0.0-beta.3",
+		"@silvia-odwyer/photon-node": "0.3.4",
+		"chalk": "5.6.2",
+		"cross-spawn": "7.0.6",
+		"diff": "8.0.4",
+		"glob": "13.0.6",
+		"highlight.js": "10.7.3",
+		"hosted-git-info": "9.0.3",
+		"ignore": "7.0.5",
+		"jiti": "2.7.0",
+		"minimatch": "10.2.5",
+		"proper-lockfile": "4.1.2",
+		"typebox": "1.1.38",
+		"undici": "8.3.0",
+		"yaml": "2.9.0"
+	},
+	"overrides": {
+		"rimraf": "6.1.2",
+		"gaxios": {
+			"rimraf": "6.1.2"
+		}
+	},
+	"optionalDependencies": {
+		"@mariozechner/clipboard": "0.3.9"
+	},
+	"devDependencies": {
+		"@types/cross-spawn": "6.0.6",
+		"@types/diff": "7.0.2",
+		"@types/hosted-git-info": "3.0.5",
+		"@types/ms": "2.1.0",
+		"@types/node": "24.12.4",
+		"@types/proper-lockfile": "4.1.4",
+		"shx": "0.4.0",
+		"typescript": "5.9.3",
+		"vitest": "3.2.4"
+	},
+	"keywords": [
+		"coding-agent",
+		"ai",
+		"llm",
+		"cli",
+		"tui",
+		"agent"
+	],
+	"author": "OpenAdapter",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/claraverse-space/koda.git",
+		"directory": "packages/coding-agent"
+	},
+	"engines": {
+		"node": ">=22.19.0"
+	},
+	"homepage": "https://openadapter.in",
+	"bugs": {
+		"url": "https://github.com/claraverse-space/koda/issues"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}