@vibecontrols/vibe-plugin-tool-git 2026.508.3 → 2026.509.2

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @burdenoff/vibe-plugin-git v1.0.0
+ * @vibecontrols/vibe-plugin-tool-git
  *
  * Visual Git Client via Ungit — reverse-proxied through the VibeControls
  * agent. Manages the Ungit child process lifecycle (install, start, stop)
@@ -8,11 +8,12 @@
  * Registers:
  *   - Elysia routes: /api/ungit/*  (REST API)
  *   - Proxy routes:  /ungit/*      (reverse proxy to ungit)
- *   - CLI command:   vibe ungit {status,install,start,stop}
+ *   - CLI command:   vibe ungit {status,install,start,stop,restart}
  *
- * Install: vibe plugin install @burdenoff/vibe-plugin-git
+ * Migrated to consume `@vibecontrols/plugin-sdk` for the contract,
+ * lifecycle, telemetry, CLI multimode, and redaction helpers.
  */
-import type { VibePlugin } from "./types.js";
-export type { VibePlugin, HostServices, StorageProvider, EventBus, ServiceRegistry, UngitStatus, } from "./types.js";
-export declare const vibePlugin: VibePlugin;
-export default vibePlugin;
+import { type VibePluginFactory } from "@vibecontrols/plugin-sdk";
+export type { UngitStatus, StartBody } from "./types.js";
+export declare const createPlugin: VibePluginFactory;
+export default createPlugin;

package/dist/index.js

@@ -1,6 +1,15 @@
 // @bun
-var __defProp=Object.defineProperty;var __returnValue=(v)=>v;function __exportSetter(name,newValue){this[name]=__returnValue.bind(null,newValue)}var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0,configurable:!0,set:__exportSetter.bind(all,name)})};var __esm=(fn,res)=>()=>(fn&&(res=fn(fn=0)),res);var __require=import.meta.require;async function isPortAvailable(port){try{return Bun.serve({port,hostname:"127.0.0.1",fetch(){return new Response}}).stop(!0),!0}catch{return!1}}async function findAvailablePort(preferred){let start=preferred??DEFAULT_PORT;if(await isPortAvailable(start))return start;for(let port=DEFAULT_PORT;port<=PORT_RANGE_END;port++){if(port===start)continue;if(await isPortAvailable(port))return port}throw Error(`No available port in range ${DEFAULT_PORT}-${PORT_RANGE_END}`)}async function checkInstallation(){try{let localPath=new URL("../../node_modules/.bin/ungit",import.meta.url).pathname;if(await Bun.file(localPath).exists())return{installed:!0,binaryPath:localPath}}catch{}try{let path=Bun.which("ungit");if(path)return{installed:!0,binaryPath:path}}catch{}return{installed:!1}}async function installUngit(){try{let proc=Bun.spawn(["npm","install","-g","ungit"],{stdout:"pipe",stderr:"pipe"}),exitCode=await proc.exited;if(exitCode!==0){let stderr=await new Response(proc.stderr).text();return{success:!1,error:`npm install -g ungit failed (exit ${exitCode}): ${stderr}`}}return{success:!0}}catch(err){return{success:!1,error:err instanceof Error?err.message:"Installation failed"}}}async function startUngit(options){if(childProcess&&currentPid){if(isProcessAlive(currentPid))return{pid:currentPid,port:currentPort};childProcess=null,currentPid=null}if(isStarting)throw Error("Ungit is already starting");isStarting=!0,lastError=null;try{let port=await findAvailablePort(options?.port),workingDir=options?.workingDir||process.env.HOME||"/",install=await checkInstallation();if(!install.installed||!install.binaryPath)throw Error("Ungit is not installed");let args=[install.binaryPath,"--port",String(port),"--no-b","--ungitBindIp","127.0.0.1","--rootPath","/ungit"],proc=Bun.spawn(args,{stdout:"pipe",stderr:"pipe",cwd:workingDir,env:{...process.env,PORT:void 0}});if(childProcess=proc,currentPort=port,currentWorkingDir=workingDir,currentPid=proc.pid,proc.exited.then((code)=>{if(childProcess===proc){if(childProcess=null,currentPid=null,code!==0&&code!==null)lastError=`Ungit exited with code ${code}`}}),await new Promise((resolve)=>setTimeout(resolve,2000)),!isProcessAlive(proc.pid)){let stderr=await new Response(proc.stderr).text();throw Error(`Ungit failed to start: ${stderr}`)}return{pid:proc.pid,port}}catch(err){throw lastError=err instanceof Error?err.message:"Failed to start",err}finally{isStarting=!1}}async function stopUngit(){if(!childProcess||!currentPid){childProcess=null,currentPid=null;return}let proc=childProcess,pid=currentPid;childProcess=null,currentPid=null,currentPort=null,currentWorkingDir=null,lastError=null;try{process.kill(pid,"SIGTERM")}catch{return}let deadline=Date.now()+5000;while(Date.now()<deadline&&isProcessAlive(pid))await new Promise((resolve)=>setTimeout(resolve,200));if(isProcessAlive(pid))try{process.kill(pid,"SIGKILL")}catch{}try{await proc.exited}catch{}}function getStatus(){let running=Boolean(currentPid&&isProcessAlive(currentPid));if(!running&&childProcess)childProcess=null,currentPid=null;return{installed:!0,running,pid:running?currentPid??void 0:void 0,port:running?currentPort??void 0:void 0,workingDir:running?currentWorkingDir??void 0:void 0,error:lastError??void 0}}function getRunningPort(){if(!currentPid||!isProcessAlive(currentPid))return null;return currentPort}function isProcessAlive(pid){try{return process.kill(pid,0),!0}catch{return!1}}var childProcess=null,currentPort=null,currentWorkingDir=null,currentPid=null,lastError=null,isStarting=!1,DEFAULT_PORT=8448,PORT_RANGE_END=8458;var exports_routes={};__export(exports_routes,{createUngitRoutes:()=>createUngitRoutes});import{Elysia}from"elysia";function createUngitRoutes(_hostServices){return new Elysia({prefix:"/api/ungit"}).get("/status",async()=>{let installInfo=await checkInstallation(),processStatus=getStatus();return{installed:installInfo.installed,installing:isInstalling,running:processStatus.running,pid:processStatus.pid,port:processStatus.port,workingDir:processStatus.workingDir,error:installError||processStatus.error||void 0}}).post("/install",async({set})=>{if(isInstalling)return set.status=409,{error:"Installation already in progress"};let check=await checkInstallation();if(check.installed)return{message:"Ungit is already installed",binaryPath:check.binaryPath};return isInstalling=!0,installError=null,(async()=>{try{let result=await installUngit();if(!result.success)installError=result.error||"Installation failed"}catch(err){installError=err instanceof Error?err.message:"Installation failed"}finally{isInstalling=!1}})(),{message:"Installation started -- poll GET /api/ungit/status"}}).post("/start",async({body,set})=>{let{workingDir,port}=body||{};if(!(await checkInstallation()).installed)return set.status=400,{error:"Ungit is not installed. POST /api/ungit/install first"};try{let result=await startUngit({workingDir,port});return{message:"Ungit started",pid:result.pid,port:result.port,workingDir:workingDir||process.env.HOME||"/"}}catch(err){return set.status=500,{error:err instanceof Error?err.message:"Failed to start"}}}).post("/stop",async()=>{return await stopUngit(),{message:"Ungit stopped"}}).post("/restart",async({body,set})=>{let{workingDir}=body||{};if(!(await checkInstallation()).installed)return set.status=400,{error:"Ungit is not installed"};await stopUngit();try{let result=await startUngit({workingDir});return{message:"Ungit restarted",pid:result.pid,port:result.port,workingDir:workingDir||process.env.HOME||"/"}}catch(err){return set.status=500,{error:err instanceof Error?err.message:"Failed to restart"}}})}var isInstalling=!1,installError=null;var init_routes=()=>{};var exports_proxy={};__export(exports_proxy,{default:()=>proxy_default,createUngitProxy:()=>createUngitProxy});import{Elysia as Elysia2}from"elysia";function generateSessionToken(){let bytes=new Uint8Array(32);return crypto.getRandomValues(bytes),Buffer.from(bytes).toString("base64url")}function createSession(){let token=generateSessionToken(),now=Date.now(),session={token,createdAt:now,expiresAt:now+SESSION_TTL_MS};return sessions.set(token,session),session}function validateSessionToken(token){let session=sessions.get(token);if(!session)return!1;if(Date.now()>session.expiresAt)return sessions.delete(token),!1;return!0}function cleanupSessions(){let now=Date.now();for(let[token,session]of sessions)if(now>session.expiresAt)sessions.delete(token)}function getCookie(cookieHeader,name){if(!cookieHeader)return null;let match=cookieHeader.match(new RegExp(`(?:^|;\\s*)${name}=([^;]*)`));return match?match[1]:null}function isAuthed(request,validateApiKey){let cookieHeader=request.headers.get("cookie"),sessionToken=getCookie(cookieHeader,COOKIE_NAME),apiKeyHeader=request.headers.get("x-agent-api-key"),apiKeyParam=new URL(request.url).searchParams.get("apiKey"),hasValidSession=sessionToken?validateSessionToken(sessionToken):!1,hasValidApiKey=apiKeyHeader!=null&&validateApiKey(apiKeyHeader)||apiKeyParam!=null&&validateApiKey(apiKeyParam);if(!hasValidApiKey&&!hasValidSession){let referer=request.headers.get("referer");if(referer)try{let refKey=new URL(referer).searchParams.get("apiKey");if(refKey&&validateApiKey(refKey))hasValidApiKey=!0}catch{}}return{hasValidSession,hasValidApiKey}}function stripPrefix(pathname){return pathname||"/"}function createUngitProxy(getPort,validateApiKey){return new Elysia2({prefix:"/ungit"}).all("/*",async({request})=>{return handleProxyRequest(request,getPort,validateApiKey)}).all("/",async({request})=>{return handleProxyRequest(request,getPort,validateApiKey)})}async function handleProxyRequest(request,getPort,validateApiKey){let{hasValidSession,hasValidApiKey}=isAuthed(request,validateApiKey);if(!hasValidSession&&!hasValidApiKey)return new Response(JSON.stringify({error:"Unauthorized -- provide a valid API key or session"}),{status:401,headers:{"Content-Type":"application/json"}});let sessionCookieHeader=null;if(!hasValidSession&&hasValidApiKey){let session=createSession();sessionCookieHeader=`${COOKIE_NAME}=${session.token}; Path=/ungit/; HttpOnly; SameSite=None; Secure; Max-Age=${Math.floor(SESSION_TTL_MS/1000)}`}let port=getPort();if(!port)return new Response(JSON.stringify({error:"Ungit is not running"}),{status:503,headers:{"Content-Type":"application/json"}});let response=await handleHttpProxy(request,port);if(sessionCookieHeader){let headers=new Headers(response.headers);return headers.set("Set-Cookie",sessionCookieHeader),new Response(response.body,{status:response.status,statusText:response.statusText,headers})}return response}async function handleHttpProxy(request,port){let url=new URL(request.url),strippedPath=stripPrefix(url.pathname),upstreamUrl=`http://127.0.0.1:${port}${strippedPath}${url.search}`,upstreamHeaders=new Headers,hopByHopHeaders=new Set(["connection","keep-alive","transfer-encoding","te","trailer","upgrade","proxy-authorization","proxy-authenticate"]);request.headers.forEach((value,key)=>{if(!hopByHopHeaders.has(key.toLowerCase()))upstreamHeaders.set(key,value)}),upstreamHeaders.set("Host",`127.0.0.1:${port}`);try{let upstreamResponse=await fetch(upstreamUrl,{method:request.method,headers:upstreamHeaders,body:request.method!=="GET"&&request.method!=="HEAD"?request.body:void 0,redirect:"manual"}),responseHeaders=new Headers;upstreamResponse.headers.forEach((value,key)=>{if(!STRIP_RESPONSE_HEADERS.has(key.toLowerCase()))responseHeaders.set(key,value)});let contentType=upstreamResponse.headers.get("content-type")||"";if(strippedPath==="/ungit/"&&!contentType.includes("text/html")){let body=await upstreamResponse.text();if(body.trimStart().startsWith("<!DOCTYPE")||body.trimStart().startsWith("<html"))return responseHeaders.set("content-type","text/html; charset=utf-8"),responseHeaders.delete("content-length"),new Response(body,{status:upstreamResponse.status,statusText:upstreamResponse.statusText,headers:responseHeaders});return new Response(body,{status:upstreamResponse.status,statusText:upstreamResponse.statusText,headers:responseHeaders})}return new Response(upstreamResponse.body,{status:upstreamResponse.status,statusText:upstreamResponse.statusText,headers:responseHeaders})}catch(err){return new Response(JSON.stringify({error:"Failed to proxy to Ungit",details:err instanceof Error?err.message:"Unknown error"}),{status:502,headers:{"Content-Type":"application/json"}})}}var SESSION_TTL_MS=86400000,COOKIE_NAME="__vibe_ungit_session",sessions,STRIP_RESPONSE_HEADERS,proxy_default;var init_proxy=__esm(()=>{sessions=new Map;setInterval(cleanupSessions,600000);STRIP_RESPONSE_HEADERS=new Set(["x-frame-options","content-security-policy","x-content-type-options"]);proxy_default=createUngitProxy});function isInteractive(){return!!process.stdout.isTTY&&!!process.stdin.isTTY}function pickOutputMode(flags){if(flags.json)return"json";if(flags.plain)return"plain";if(flags.interactive)return"interactive";return"auto"}function isCi(){return!!process.env.CI||!!process.env.NO_COLOR||process.env.TERM==="dumb"}async function runMultimode(opts){let data=await opts.fetchData(),mode=opts.mode??"auto";if(mode==="json"){let shaped=opts.json?opts.json(data):data;process.stdout.write(`${JSON.stringify(shaped,null,2)}
-`);return}if(mode==="plain"){await opts.plain(data);return}if((mode==="interactive"||isInteractive()&&!isCi())&&!!opts.interactive&&opts.interactive)try{await opts.interactive(data);return}catch{}await opts.plain(data)}function maybePrintJson(flags,data){if(!flags.json)return!1;return process.stdout.write(`${JSON.stringify(data,null,2)}
-`),!0}async function loadCore(){return await import("@opentui/core")}async function interactiveDetail(opts){let core=await loadCore(),{createCliRenderer,BoxRenderable,TextRenderable}=core,renderer=await createCliRenderer({exitOnCtrlC:!0,targetFps:30}),ctx=renderer.root.ctx,root=new BoxRenderable(ctx,{width:"100%",height:"100%",flexDirection:"column",backgroundColor:"#0b0d12"}),title=new TextRenderable(ctx,{content:`  ${opts.title}`,fg:"#8be9fd",height:1}),bodyBox=new BoxRenderable(ctx,{width:"100%",flexGrow:1,paddingLeft:2,paddingRight:2,backgroundColor:"#11141c"}),bodyText=new TextRenderable(ctx,{content:`
+var __defProp=Object.defineProperty;var __returnValue=(v)=>v;function __exportSetter(name,newValue){this[name]=__returnValue.bind(null,newValue)}var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0,configurable:!0,set:__exportSetter.bind(all,name)})};var __esm=(fn,res)=>()=>(fn&&(res=fn(fn=0)),res);var __require=import.meta.require;async function isPortAvailable(port){try{return Bun.serve({port,hostname:"127.0.0.1",fetch(){return new Response}}).stop(!0),!0}catch{return!1}}async function findAvailablePort(preferred){let start=preferred??DEFAULT_PORT;if(await isPortAvailable(start))return start;for(let port=DEFAULT_PORT;port<=PORT_RANGE_END;port++){if(port===start)continue;if(await isPortAvailable(port))return port}throw Error(`No available port in range ${DEFAULT_PORT}-${PORT_RANGE_END}`)}async function checkInstallation(){try{let localPath=new URL("../../node_modules/.bin/ungit",import.meta.url).pathname;if(await Bun.file(localPath).exists())return{installed:!0,binaryPath:localPath}}catch{}try{let path=Bun.which("ungit");if(path)return{installed:!0,binaryPath:path}}catch{}return{installed:!1}}async function installUngit(){try{let proc=Bun.spawn(["npm","install","-g","ungit"],{stdout:"pipe",stderr:"pipe"}),exitCode=await proc.exited;if(exitCode!==0){let stderr=await new Response(proc.stderr).text();return{success:!1,error:`npm install -g ungit failed (exit ${exitCode}): ${stderr}`}}return{success:!0}}catch(err){return{success:!1,error:err instanceof Error?err.message:"Installation failed"}}}async function startUngit(options){if(childProcess&&currentPid){if(isProcessAlive(currentPid))return{pid:currentPid,port:currentPort};childProcess=null,currentPid=null}if(isStarting)throw Error("Ungit is already starting");isStarting=!0,lastError=null;try{let port=await findAvailablePort(options?.port),workingDir=options?.workingDir||process.env.HOME||"/",install=await checkInstallation();if(!install.installed||!install.binaryPath)throw Error("Ungit is not installed");let args=[install.binaryPath,"--port",String(port),"--no-b","--ungitBindIp","127.0.0.1","--rootPath","/ungit"],proc=Bun.spawn(args,{stdout:"pipe",stderr:"pipe",cwd:workingDir,env:{...process.env,PORT:void 0}});if(childProcess=proc,currentPort=port,currentWorkingDir=workingDir,currentPid=proc.pid,proc.exited.then((code)=>{if(childProcess===proc){if(childProcess=null,currentPid=null,code!==0&&code!==null)lastError=`Ungit exited with code ${code}`}}),await new Promise((resolve)=>setTimeout(resolve,2000)),!isProcessAlive(proc.pid)){let stderr=await new Response(proc.stderr).text();throw Error(`Ungit failed to start: ${stderr}`)}return{pid:proc.pid,port}}catch(err){throw lastError=err instanceof Error?err.message:"Failed to start",err}finally{isStarting=!1}}async function stopUngit(){if(!childProcess||!currentPid){childProcess=null,currentPid=null;return}let proc=childProcess,pid=currentPid;childProcess=null,currentPid=null,currentPort=null,currentWorkingDir=null,lastError=null;try{process.kill(pid,"SIGTERM")}catch{return}let deadline=Date.now()+5000;while(Date.now()<deadline&&isProcessAlive(pid))await new Promise((resolve)=>setTimeout(resolve,200));if(isProcessAlive(pid))try{process.kill(pid,"SIGKILL")}catch{}try{await proc.exited}catch{}}function getStatus(){let running=Boolean(currentPid&&isProcessAlive(currentPid));if(!running&&childProcess)childProcess=null,currentPid=null;return{installed:!0,running,pid:running?currentPid??void 0:void 0,port:running?currentPort??void 0:void 0,workingDir:running?currentWorkingDir??void 0:void 0,error:lastError??void 0}}function getRunningPort(){if(!currentPid||!isProcessAlive(currentPid))return null;return currentPort}function isProcessAlive(pid){try{return process.kill(pid,0),!0}catch{return!1}}var childProcess=null,currentPort=null,currentWorkingDir=null,currentPid=null,lastError=null,isStarting=!1,DEFAULT_PORT=8448,PORT_RANGE_END=8458;import{Elysia as Elysia2}from"elysia";var RoutesBuilder=class{constructor(pluginName,hostServices){this.pluginName=pluginName,this.hostServices=hostServices}pluginName;hostServices;prefix;apiKeyResolver;errorHandlerEnabled=!1;loggingEnabled=!1;withPrefix(prefix){return this.prefix=prefix,this}withAuth(getApiKey){return this.apiKeyResolver=getApiKey,this}withErrorHandler(){return this.errorHandlerEnabled=!0,this}withLogging(){return this.loggingEnabled=!0,this}build(){let opts=this.prefix?{prefix:this.prefix}:void 0,app=new Elysia2(opts);if(this.apiKeyResolver){let resolver=this.apiKeyResolver;app.onBeforeHandle(async({request,set})=>{let supplied=request.headers.get("x-api-key"),expected=await resolver();if(!supplied||supplied!==expected)return set.status=401,{error:"unauthorized"};return})}if(this.errorHandlerEnabled){let pluginName=this.pluginName,logger=this.hostServices?.logger;app.onError(({error,set})=>{let message=error instanceof Error?error.message:String(error);return logger?.error?.(pluginName,"route error",{message}),set.status=500,{error:message}})}if(this.loggingEnabled){let pluginName=this.pluginName,logger=this.hostServices?.logger;app.onRequest(({request})=>{logger?.debug?.(pluginName,"request",{method:request.method,url:request.url})})}return app}};var init_routes=()=>{};var exports_routes={};__export(exports_routes,{createUngitRoutes:()=>createUngitRoutes});function createUngitRoutes(hostServices){return new RoutesBuilder("ungit",hostServices).withPrefix("/api/ungit").withErrorHandler().build().get("/status",async()=>{let installInfo=await checkInstallation(),processStatus=getStatus();return{installed:installInfo.installed,installing:isInstalling,running:processStatus.running,pid:processStatus.pid,port:processStatus.port,workingDir:processStatus.workingDir,error:installError||processStatus.error||void 0}}).post("/install",async({set})=>{if(isInstalling)return set.status=409,{error:"Installation already in progress"};let check=await checkInstallation();if(check.installed)return{message:"Ungit is already installed",binaryPath:check.binaryPath};return isInstalling=!0,installError=null,(async()=>{try{let result=await installUngit();if(!result.success)installError=result.error||"Installation failed"}catch(err){installError=err instanceof Error?err.message:"Installation failed"}finally{isInstalling=!1}})(),{message:"Installation started -- poll GET /api/ungit/status"}}).post("/start",async({body,set})=>{let{workingDir,port}=body||{};if(!(await checkInstallation()).installed)return set.status=400,{error:"Ungit is not installed. POST /api/ungit/install first"};try{let result=await startUngit({workingDir,port});return{message:"Ungit started",pid:result.pid,port:result.port,workingDir:workingDir||process.env.HOME||"/"}}catch(err){return set.status=500,{error:err instanceof Error?err.message:"Failed to start"}}}).post("/stop",async()=>{return await stopUngit(),{message:"Ungit stopped"}}).post("/restart",async({body,set})=>{let{workingDir}=body||{};if(!(await checkInstallation()).installed)return set.status=400,{error:"Ungit is not installed"};await stopUngit();try{let result=await startUngit({workingDir});return{message:"Ungit restarted",pid:result.pid,port:result.port,workingDir:workingDir||process.env.HOME||"/"}}catch(err){return set.status=500,{error:err instanceof Error?err.message:"Failed to restart"}}})}var isInstalling=!1,installError=null;var init_routes2=__esm(()=>{init_routes()});var exports_proxy={};__export(exports_proxy,{default:()=>proxy_default,createUngitProxy:()=>createUngitProxy});import{Elysia as Elysia3}from"elysia";function generateSessionToken(){let bytes=new Uint8Array(32);return crypto.getRandomValues(bytes),Buffer.from(bytes).toString("base64url")}function createSession(){let token=generateSessionToken(),now=Date.now(),session={token,createdAt:now,expiresAt:now+SESSION_TTL_MS};return sessions.set(token,session),session}function validateSessionToken(token){let session=sessions.get(token);if(!session)return!1;if(Date.now()>session.expiresAt)return sessions.delete(token),!1;return!0}function cleanupSessions(){let now=Date.now();for(let[token,session]of sessions)if(now>session.expiresAt)sessions.delete(token)}function getCookie(cookieHeader,name){if(!cookieHeader)return null;let match=cookieHeader.match(new RegExp(`(?:^|;\\s*)${name}=([^;]*)`));return match?match[1]:null}function isAuthed(request,validateApiKey){let cookieHeader=request.headers.get("cookie"),sessionToken=getCookie(cookieHeader,COOKIE_NAME),apiKeyHeader=request.headers.get("x-agent-api-key"),apiKeyParam=new URL(request.url).searchParams.get("apiKey"),hasValidSession=sessionToken?validateSessionToken(sessionToken):!1,hasValidApiKey=apiKeyHeader!=null&&validateApiKey(apiKeyHeader)||apiKeyParam!=null&&validateApiKey(apiKeyParam);if(!hasValidApiKey&&!hasValidSession){let referer=request.headers.get("referer");if(referer)try{let refKey=new URL(referer).searchParams.get("apiKey");if(refKey&&validateApiKey(refKey))hasValidApiKey=!0}catch{}}return{hasValidSession,hasValidApiKey}}function stripPrefix(pathname){return pathname||"/"}function createUngitProxy(getPort,validateApiKey){return new Elysia3({prefix:"/ungit"}).all("/*",async({request})=>{return handleProxyRequest(request,getPort,validateApiKey)}).all("/",async({request})=>{return handleProxyRequest(request,getPort,validateApiKey)})}async function handleProxyRequest(request,getPort,validateApiKey){let{hasValidSession,hasValidApiKey}=isAuthed(request,validateApiKey);if(!hasValidSession&&!hasValidApiKey)return new Response(JSON.stringify({error:"Unauthorized -- provide a valid API key or session"}),{status:401,headers:{"Content-Type":"application/json"}});let sessionCookieHeader=null;if(!hasValidSession&&hasValidApiKey){let session=createSession();sessionCookieHeader=`${COOKIE_NAME}=${session.token}; Path=/ungit/; HttpOnly; SameSite=None; Secure; Max-Age=${Math.floor(SESSION_TTL_MS/1000)}`}let port=getPort();if(!port)return new Response(JSON.stringify({error:"Ungit is not running"}),{status:503,headers:{"Content-Type":"application/json"}});let response=await handleHttpProxy(request,port);if(sessionCookieHeader){let headers=new Headers(response.headers);return headers.set("Set-Cookie",sessionCookieHeader),new Response(response.body,{status:response.status,statusText:response.statusText,headers})}return response}async function handleHttpProxy(request,port){let url=new URL(request.url),strippedPath=stripPrefix(url.pathname),upstreamUrl=`http://127.0.0.1:${port}${strippedPath}${url.search}`,upstreamHeaders=new Headers,hopByHopHeaders=new Set(["connection","keep-alive","transfer-encoding","te","trailer","upgrade","proxy-authorization","proxy-authenticate"]);request.headers.forEach((value,key)=>{if(!hopByHopHeaders.has(key.toLowerCase()))upstreamHeaders.set(key,value)}),upstreamHeaders.set("Host",`127.0.0.1:${port}`);try{let upstreamResponse=await fetch(upstreamUrl,{method:request.method,headers:upstreamHeaders,body:request.method!=="GET"&&request.method!=="HEAD"?request.body:void 0,redirect:"manual"}),responseHeaders=new Headers;upstreamResponse.headers.forEach((value,key)=>{if(!STRIP_RESPONSE_HEADERS.has(key.toLowerCase()))responseHeaders.set(key,value)});let contentType=upstreamResponse.headers.get("content-type")||"";if(strippedPath==="/ungit/"&&!contentType.includes("text/html")){let body=await upstreamResponse.text();if(body.trimStart().startsWith("<!DOCTYPE")||body.trimStart().startsWith("<html"))return responseHeaders.set("content-type","text/html; charset=utf-8"),responseHeaders.delete("content-length"),new Response(body,{status:upstreamResponse.status,statusText:upstreamResponse.statusText,headers:responseHeaders});return new Response(body,{status:upstreamResponse.status,statusText:upstreamResponse.statusText,headers:responseHeaders})}return new Response(upstreamResponse.body,{status:upstreamResponse.status,statusText:upstreamResponse.statusText,headers:responseHeaders})}catch(err){return new Response(JSON.stringify({error:"Failed to proxy to Ungit",details:err instanceof Error?err.message:"Unknown error"}),{status:502,headers:{"Content-Type":"application/json"}})}}var SESSION_TTL_MS=86400000,COOKIE_NAME="__vibe_ungit_session",sessions,STRIP_RESPONSE_HEADERS,proxy_default;var init_proxy=__esm(()=>{sessions=new Map;setInterval(cleanupSessions,600000);STRIP_RESPONSE_HEADERS=new Set(["x-frame-options","content-security-policy","x-content-type-options"]);proxy_default=createUngitProxy});import{Elysia}from"elysia";function createLifecycleHooks(spec){let{name,onInit,onShutdown,telemetryEventName,skipPlatforms}=spec;return{onServerStart:async(_app,hostServices)=>{if(skipPlatforms&&skipPlatforms.includes(process.platform)){process.stderr.write(`[${name}] skipping init on unsupported platform '${process.platform}'
+`);return}if(onInit)await onInit(hostServices);if(telemetryEventName)hostServices.telemetry?.emit(telemetryEventName,{plugin:name})},onServerStop:async(hostServices)=>{if(onShutdown)await onShutdown(hostServices)}}}function pickOutputMode(flags){if(flags.json)return"json";if(flags.plain)return"plain";if(flags.interactive)return"interactive";return"auto"}function isCi(){return!!process.env.CI||!!process.env.NO_COLOR||process.env.TERM==="dumb"}function stdoutIsTty(){return Boolean(process.stdout.isTTY)}async function runMultimode(opts){let data=await opts.fetchData(),mode=opts.mode??"auto";if(mode==="json"){let shaped=opts.json?opts.json(data):data;process.stdout.write(`${JSON.stringify(shaped,null,2)}
+`);return}if(mode==="plain"){await opts.plain(data);return}if((mode==="interactive"||stdoutIsTty()&&!isCi())&&!!opts.interactive&&opts.interactive)try{await opts.interactive(data);return}catch{}await opts.plain(data)}function maybePrintJson(flags,data){if(!flags.json)return!1;return process.stdout.write(`${JSON.stringify(data,null,2)}
+`),!0}var SENSITIVE_KEY_RE=/(token|secret|password|apikey|api_key|key|auth|credential|email)/i;function redact(value){return redactInner(value)}function redactInner(value){if(value===null||value===void 0)return value;if(Array.isArray(value))return value.map(redactInner);if(typeof value==="object"){let out={};for(let[k,v]of Object.entries(value)){if(SENSITIVE_KEY_RE.test(k)){out[k]="[redacted]";continue}out[k]=redactInner(v)}return out}return value}var TelemetryEmitter=class{constructor(pluginName,pluginVersion,hostServices){this.pluginName=pluginName,this.pluginVersion=pluginVersion,this.hostServices=hostServices}pluginName;pluginVersion;hostServices;emit(eventName,payload){let target=this.hostServices?.telemetry;if(!target)return;target.emit(eventName,{plugin:this.pluginName,version:this.pluginVersion,timestamp:new Date().toISOString(),...payload??{}})}emitReady(context){this.emit(`${this.pluginName}.ready`,context)}emitError(error,context){this.emit(`${this.pluginName}.error`,{message:error.message,...context??{}})}emitEvent(type,payload){this.emit(type,payload)}};async function loadCore(){return await import("@opentui/core")}async function interactiveDetail(opts){let core=await loadCore(),{createCliRenderer,BoxRenderable,TextRenderable}=core,renderer=await createCliRenderer({exitOnCtrlC:!0,targetFps:30}),ctx=renderer.root.ctx,root=new BoxRenderable(ctx,{width:"100%",height:"100%",flexDirection:"column",backgroundColor:"#0b0d12"}),title=new TextRenderable(ctx,{content:`  ${opts.title}`,fg:"#8be9fd",height:1}),bodyBox=new BoxRenderable(ctx,{width:"100%",flexGrow:1,paddingLeft:2,paddingRight:2,backgroundColor:"#11141c"}),bodyText=new TextRenderable(ctx,{content:`
 ${opts.body}
-`,fg:"#cdd6f4"}),footer=new TextRenderable(ctx,{content:`  ${opts.footer??"q to quit"}`,fg:"#6c7086",height:1});bodyBox.add(bodyText),root.add(title),root.add(bodyBox),root.add(footer),renderer.root.add(root),await new Promise((resolve)=>{let cleanup=()=>{try{renderer.destroy()}catch{}resolve()};renderer.keyInput.on("keypress",(key)=>{if(key.name==="escape"||key.name==="q"||key.name==="return")cleanup()})})}var SECRET_RX=/(token|secret|password|apikey|api_key)/i;function redact(value){if(value===null||value===void 0)return value;if(Array.isArray(value))return value.map(redact);if(typeof value!=="object")return value;let out={};for(let[k,v]of Object.entries(value))out[k]=SECRET_RX.test(k)?"[redacted]":redact(v);return out}var AGENT_BASE_URL=process.env.VIBE_AGENT_URL??"http://localhost:3005",API_KEY=process.env.VIBE_AGENT_API_KEY??"";async function apiFetch(urlPath,options){return fetch(`${AGENT_BASE_URL}${urlPath}`,{...options,headers:{"Content-Type":"application/json","x-agent-api-key":API_KEY,...options?.headers}})}var agentApiKey=null,vibePlugin={capabilities:{storage:"rw",subprocess:!0,audit:!0,telemetry:!0},name:"ungit",version:"1.0.0",description:"Visual Git Client (Ungit)",tags:["frontend","integration"],hasUI:!0,cliCommand:"ungit",apiPrefix:"/api/ungit",publicPaths:["/ungit/"],async onServerStart(app,hostServices){hostServices?.telemetry?.emit("tool.ready",{provider:"git"});let{createUngitRoutes:createUngitRoutes2}=await Promise.resolve().then(() => (init_routes(),exports_routes));app.use(createUngitRoutes2(hostServices));try{agentApiKey=app.decorator?.apiKey??null}catch{agentApiKey=process.env.AGENT_API_KEY??null}let{createUngitProxy:createUngitProxy2}=await Promise.resolve().then(() => (init_proxy(),exports_proxy));app.use(createUngitProxy2(()=>getRunningPort(),(key)=>{if(!agentApiKey)return!1;return key===agentApiKey})),console.log("  Plugin 'ungit' registered routes: /api/ungit, /ungit")},async onServerStop(){await stopUngit(),console.log("  Plugin 'ungit' stopped")},onCliSetup(program){let cmd=program.command("ungit").description("Visual Git Client (Ungit)");cmd.command("status").description("Show Ungit status").option("--json","Emit JSON").option("--plain","Force plain text output").action(async(opts)=>{await runMultimode({mode:pickOutputMode(opts),fetchData:async()=>{return await(await apiFetch("/api/ungit/status")).json()},plain:(data)=>{console.log(JSON.stringify(data,null,2))},interactive:async(data)=>{await interactiveDetail({title:"ungit \u2014 status",body:JSON.stringify(data,null,2)})},json:(data)=>redact(data)})}),cmd.command("install").description("Install Ungit globally via npm").option("--json","Emit JSON").action(async(opts)=>{if(!opts.json)console.log("Installing Ungit...");let data=await(await apiFetch("/api/ungit/install",{method:"POST"})).json();if(maybePrintJson(opts,{ok:!0,action:"install",result:data}))return;console.log(JSON.stringify(data,null,2))}),cmd.command("start").description("Start Ungit").option("--dir <dir>","Working directory for git operations").option("--port <port>","Port to bind to").option("--json","Emit JSON").action(async(opts)=>{let body={};if(opts.dir)body.workingDir=opts.dir;if(opts.port)body.port=parseInt(opts.port,10);let data=await(await apiFetch("/api/ungit/start",{method:"POST",body:JSON.stringify(body)})).json();if(maybePrintJson(opts,{ok:!0,action:"start",result:data}))return;console.log(JSON.stringify(data,null,2))}),cmd.command("stop").description("Stop Ungit").option("--json","Emit JSON").action(async(opts)=>{let data=await(await apiFetch("/api/ungit/stop",{method:"POST"})).json();if(maybePrintJson(opts,{ok:!0,action:"stop",result:data}))return;console.log(JSON.stringify(data,null,2))}),cmd.command("restart").description("Restart Ungit with optional new working directory").option("--dir <dir>","New working directory").option("--json","Emit JSON").action(async(opts)=>{let body={};if(opts.dir)body.workingDir=opts.dir;let data=await(await apiFetch("/api/ungit/restart",{method:"POST",body:JSON.stringify(body)})).json();if(maybePrintJson(opts,{ok:!0,action:"restart",result:data}))return;console.log(JSON.stringify(data,null,2))})}},src_default=vibePlugin;export{vibePlugin,src_default as default};
+`,fg:"#cdd6f4"}),footer=new TextRenderable(ctx,{content:`  ${opts.footer??"q to quit"}`,fg:"#6c7086",height:1});bodyBox.add(bodyText),root.add(title),root.add(bodyBox),root.add(footer),renderer.root.add(root),await new Promise((resolve)=>{let cleanup=()=>{try{renderer.destroy()}catch{}resolve()};renderer.keyInput.on("keypress",(key)=>{if(key.name==="escape"||key.name==="q"||key.name==="return")cleanup()})})}var AGENT_BASE_URL=process.env.VIBE_AGENT_URL??"http://localhost:3005",API_KEY=process.env.VIBE_AGENT_API_KEY??"";async function apiFetch(urlPath,options){return fetch(`${AGENT_BASE_URL}${urlPath}`,{...options,headers:{"Content-Type":"application/json","x-agent-api-key":API_KEY,...options?.headers}})}var agentApiKey=null,PLUGIN_NAME="ungit",PLUGIN_VERSION="2026.509.2",createPlugin=(_ctx)=>{let lifecycle=createLifecycleHooks({name:PLUGIN_NAME,telemetryEventName:"tool.ready",onInit:async(hostServices)=>{new TelemetryEmitter(PLUGIN_NAME,PLUGIN_VERSION,hostServices).emitEvent("tool.ready",{provider:"git"})}});return{capabilities:{storage:"rw",subprocess:!0,audit:!0,telemetry:!0},name:PLUGIN_NAME,version:PLUGIN_VERSION,description:"Visual Git Client (Ungit)",tags:["frontend","integration"],hasUI:!0,cliCommand:"ungit",apiPrefix:"/api/ungit",publicPaths:["/ungit/"],async onServerStart(app,hostServices){await lifecycle.onServerStart(app,hostServices);let elysiaApp=app,{createUngitRoutes:createUngitRoutes2}=await Promise.resolve().then(() => (init_routes2(),exports_routes));elysiaApp.use(createUngitRoutes2(hostServices));try{agentApiKey=elysiaApp.decorator?.apiKey??null}catch{agentApiKey=process.env.AGENT_API_KEY??null}let{createUngitProxy:createUngitProxy2}=await Promise.resolve().then(() => (init_proxy(),exports_proxy));elysiaApp.use(createUngitProxy2(()=>getRunningPort(),(key)=>{if(!agentApiKey)return!1;return key===agentApiKey})),process.stdout.write(`  Plugin 'ungit' registered routes: /api/ungit, /ungit
+`)},async onServerStop(){await stopUngit(),process.stdout.write(`  Plugin 'ungit' stopped
+`)},onCliSetup(programArg){let cmd=programArg.command("ungit").description("Visual Git Client (Ungit)");cmd.command("status").description("Show Ungit status").option("--json","Emit JSON").option("--plain","Force plain text output").action(async(opts)=>{await runMultimode({mode:pickOutputMode(opts),fetchData:async()=>{return await(await apiFetch("/api/ungit/status")).json()},plain:(data)=>{process.stdout.write(`${JSON.stringify(data,null,2)}
+`)},interactive:async(data)=>{await interactiveDetail({title:"ungit \u2014 status",body:JSON.stringify(data,null,2)})},json:(data)=>redact(data)})}),cmd.command("install").description("Install Ungit globally via npm").option("--json","Emit JSON").action(async(opts)=>{if(!opts.json)process.stdout.write(`Installing Ungit...
+`);let data=await(await apiFetch("/api/ungit/install",{method:"POST"})).json();if(maybePrintJson(opts,{ok:!0,action:"install",result:data}))return;process.stdout.write(`${JSON.stringify(data,null,2)}
+`)}),cmd.command("start").description("Start Ungit").option("--dir <dir>","Working directory for git operations").option("--port <port>","Port to bind to").option("--json","Emit JSON").action(async(opts)=>{let body={};if(opts.dir)body.workingDir=opts.dir;if(opts.port)body.port=parseInt(opts.port,10);let data=await(await apiFetch("/api/ungit/start",{method:"POST",body:JSON.stringify(body)})).json();if(maybePrintJson(opts,{ok:!0,action:"start",result:data}))return;process.stdout.write(`${JSON.stringify(data,null,2)}
+`)}),cmd.command("stop").description("Stop Ungit").option("--json","Emit JSON").action(async(opts)=>{let data=await(await apiFetch("/api/ungit/stop",{method:"POST"})).json();if(maybePrintJson(opts,{ok:!0,action:"stop",result:data}))return;process.stdout.write(`${JSON.stringify(data,null,2)}
+`)}),cmd.command("restart").description("Restart Ungit with optional new working directory").option("--dir <dir>","New working directory").option("--json","Emit JSON").action(async(opts)=>{let body={};if(opts.dir)body.workingDir=opts.dir;let data=await(await apiFetch("/api/ungit/restart",{method:"POST",body:JSON.stringify(body)})).json();if(maybePrintJson(opts,{ok:!0,action:"restart",result:data}))return;process.stdout.write(`${JSON.stringify(data,null,2)}
+`)})}}},src_default=createPlugin;export{src_default as default,createPlugin};

package/dist/routes.d.ts

@@ -9,160 +9,10 @@
  *   POST /start    - Start Ungit with optional working directory and port
  *   POST /stop     - Stop the Ungit process
  *   POST /restart  - Restart Ungit with optional new working directory
+ *
+ * Built on `RoutesBuilder` from `@vibecontrols/plugin-sdk/routes` —
+ * concerns like prefix, error handler, and logging fold through the SDK.
  */
-import { Elysia } from "elysia";
-import type { HostServices } from "./types.js";
-export declare function createUngitRoutes(_hostServices: HostServices): Elysia<"/api/ungit", {
-    decorator: {};
-    store: {};
-    derive: {};
-    resolve: {};
-}, {
-    typebox: {};
-    error: {};
-}, {
-    schema: {};
-    standaloneSchema: {};
-    macro: {};
-    macroFn: {};
-    parser: {};
-    response: {};
-}, {
-    api: {
-        ungit: {
-            status: {
-                get: {
-                    body: unknown;
-                    params: {};
-                    query: unknown;
-                    headers: unknown;
-                    response: {
-                        200: {
-                            installed: boolean;
-                            installing: boolean;
-                            running: boolean;
-                            pid: number | undefined;
-                            port: number | undefined;
-                            workingDir: string | undefined;
-                            error: string | undefined;
-                        };
-                    };
-                };
-            };
-        };
-    };
-} & {
-    api: {
-        ungit: {
-            install: {
-                post: {
-                    body: unknown;
-                    params: {};
-                    query: unknown;
-                    headers: unknown;
-                    response: {
-                        200: {
-                            error: string;
-                            message?: undefined;
-                            binaryPath?: undefined;
-                        } | {
-                            message: string;
-                            binaryPath: string | undefined;
-                            error?: undefined;
-                        } | {
-                            message: string;
-                            error?: undefined;
-                            binaryPath?: undefined;
-                        };
-                    };
-                };
-            };
-        };
-    };
-} & {
-    api: {
-        ungit: {
-            start: {
-                post: {
-                    body: unknown;
-                    params: {};
-                    query: unknown;
-                    headers: unknown;
-                    response: {
-                        200: {
-                            error: string;
-                            message?: undefined;
-                            pid?: undefined;
-                            port?: undefined;
-                            workingDir?: undefined;
-                        } | {
-                            message: string;
-                            pid: number;
-                            port: number;
-                            workingDir: string;
-                            error?: undefined;
-                        };
-                    };
-                };
-            };
-        };
-    };
-} & {
-    api: {
-        ungit: {
-            stop: {
-                post: {
-                    body: unknown;
-                    params: {};
-                    query: unknown;
-                    headers: unknown;
-                    response: {
-                        200: {
-                            message: string;
-                        };
-                    };
-                };
-            };
-        };
-    };
-} & {
-    api: {
-        ungit: {
-            restart: {
-                post: {
-                    body: unknown;
-                    params: {};
-                    query: unknown;
-                    headers: unknown;
-                    response: {
-                        200: {
-                            error: string;
-                            message?: undefined;
-                            pid?: undefined;
-                            port?: undefined;
-                            workingDir?: undefined;
-                        } | {
-                            message: string;
-                            pid: number;
-                            port: number;
-                            workingDir: string;
-                            error?: undefined;
-                        };
-                    };
-                };
-            };
-        };
-    };
-}, {
-    derive: {};
-    resolve: {};
-    schema: {};
-    standaloneSchema: {};
-    response: {};
-}, {
-    derive: {};
-    resolve: {};
-    schema: {};
-    standaloneSchema: {};
-    response: {};
-}>;
+import type { Elysia } from "elysia";
+import type { HostServices } from "@vibecontrols/plugin-sdk/contract";
+export declare function createUngitRoutes(hostServices: HostServices): Elysia;

package/dist/types.d.ts

@@ -1,57 +1,10 @@
 /**
- * Type declarations for the vibe-plugin-git (Ungit) plugin.
+ * Domain models for the vibe-plugin-tool-git (Ungit) plugin.
  *
- * All interfaces are defined locally so the plugin does not hard-import
- * from the core agent package.  At runtime the host agent injects concrete
- * implementations via HostServices.
+ * Plugin contract types (VibePlugin / HostServices / PluginCapabilities /
+ * StorageProvider / ServiceRegistry) are imported from
+ * `@vibecontrols/plugin-sdk` — do NOT redeclare them here.
  */
-import type { Elysia } from "elysia";
-import type { Command } from "commander";
-export interface StorageProvider {
-    get(namespace: string, key: string): Promise<string | null>;
-    set(namespace: string, key: string, value: string): Promise<void>;
-    delete(namespace: string, key: string): Promise<boolean>;
-    keys(namespace: string): Promise<string[]>;
-}
-export interface EventBus {
-    emit(event: string, payload: unknown): void;
-    on(event: string, handler: (payload: unknown) => void): void;
-    off(event: string, handler: (payload: unknown) => void): void;
-}
-export interface ServiceRegistry {
-    get<T = unknown>(name: string): T | undefined;
-}
-export interface HostServices {
-    telemetry?: {
-        emit: (name: string, payload?: Record<string, unknown>) => void;
-    };
-    storage: StorageProvider;
-    eventBus?: EventBus;
-    serviceRegistry?: ServiceRegistry;
-}
-export interface PluginCapabilities {
-    storage?: "none" | "read" | "rw";
-    secrets?: "none" | "read" | "rw";
-    gateway?: boolean;
-    broadcast?: boolean;
-    subprocess?: boolean;
-    audit?: boolean;
-    telemetry?: boolean;
-}
-export interface VibePlugin {
-    capabilities?: PluginCapabilities;
-    name: string;
-    version: string;
-    description?: string;
-    tags?: string[];
-    hasUI?: boolean;
-    cliCommand?: string;
-    apiPrefix?: string;
-    publicPaths?: string[];
-    onCliSetup?: (program: Command) => void | Promise<void>;
-    onServerStart?: (app: Elysia, hostServices: HostServices) => void | Promise<void>;
-    onServerStop?: () => void | Promise<void>;
-}
 export interface UngitStatus {
     installed: boolean;
     running: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecontrols/vibe-plugin-tool-git",
-  "version": "2026.508.3",
+  "version": "2026.509.2",
   "main": "./dist/index.js",
   "type": "module",
   "engines": {
@@ -35,6 +35,7 @@
   "license": "SEE LICENSE IN LICENSE",
   "description": "Visual Git Client (Ungit) — reverse-proxied through the VibeControls agent",
   "dependencies": {
+    "@vibecontrols/plugin-sdk": "2026.509.1",
     "ungit": "^1.5.28"
   },
   "devDependencies": {

package/dist/utils/multimode.d.ts

@@ -1,66 +0,0 @@
-/**
- * Multi-mode output dispatcher.
- *
- * Every read-style command (list/show/status/dashboard) should funnel its
- * output through `runMultimode`. The data is fetched ONCE by `fetchData`,
- * then handed to one of three renderers:
- *
- *   • interactive — opentui UI (default in TTY when an interactive renderer
- *     is provided AND @opentui/core imports cleanly)
- *   • plain       — ANSI text written to stdout (the legacy / pipe-friendly
- *     output)
- *   • json        — `JSON.stringify(data, null, 2)` to stdout (or a
- *     custom shaper) — friendly for jq/scripting
- *
- * Mutating commands (start/stop/install/...) typically don't need this —
- * they print progress and exit. They MAY still call `runMultimode` to emit
- * a result object in JSON when `--json` is set; see `pickOutputMode`.
- *
- * The selection rules:
- *
- *   ┌─────────────────────┬──────────────────────────────────────────────┐
- *   │ explicit --json     │ json renderer (or default JSON.stringify)    │
- *   │ explicit --plain    │ plain renderer                               │
- *   │ stdout is not a TTY │ plain renderer                               │
- *   │ NO_COLOR, CI=true   │ plain renderer                               │
- *   │ no interactive fn   │ plain renderer                               │
- *   │ otherwise           │ interactive renderer (falls back to plain    │
- *   │                     │ if @opentui/core fails to import)            │
- *   └─────────────────────┴──────────────────────────────────────────────┘
- */
-export type OutputMode = "auto" | "interactive" | "plain" | "json";
-export interface OutputFlags {
-    json?: boolean;
-    plain?: boolean;
-    interactive?: boolean;
-}
-export interface MultimodeOptions<T> {
-    /** Pure data fetcher. Called once. */
-    fetchData: () => Promise<T> | T;
-    /** Plain-text renderer. Required — every command needs a pipe-friendly fallback. */
-    plain: (data: T) => void | Promise<void>;
-    /**
-     * Optional opentui renderer. Only used when stdout is a TTY and opentui
-     * imports cleanly. If omitted or it fails, we fall back to `plain`.
-     */
-    interactive?: (data: T) => Promise<void>;
-    /**
-     * Optional JSON shaper. Defaults to `JSON.stringify(data, null, 2)`.
-     * Override when you need to redact secrets or reshape for scripting.
-     */
-    json?: (data: T) => unknown;
-    /** Output mode (resolved from CLI flags by `pickOutputMode`). */
-    mode?: OutputMode;
-}
-/**
- * Resolve the desired output mode from CLI flags. The caller should pass the
- * merged opts of the local command + the global program (since `--json`
- * lives on the program level too).
- */
-export declare function pickOutputMode(flags: OutputFlags): OutputMode;
-export declare function runMultimode<T>(opts: MultimodeOptions<T>): Promise<void>;
-/**
- * Convenience: emit the data shape as JSON (used by mutating commands that
- * still want a `--json` opt-in for scripting). Returns true if it printed.
- */
-export declare function maybePrintJson(flags: OutputFlags, data: unknown): boolean;