@vibecontrols/vibe-plugin-ai-copilot 2026.601.1

package/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 Burdenoff Consultancy Services Private Limited,
+                   Algoshred Technologies Private Limited,
+                   and all its sister companies.
+
+Maintainer: Vignesh T.V <https://github.com/tvvignesh>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,69 @@
+# @vibecontrols/vibe-plugin-ai-copilot
+
+<!-- VIBECONTROLS_OSS_BODY_START -->
+
+> GitHub Copilot CLI for the agent runtime.
+
+## Install
+
+```bash
+vibe plugin install @vibecontrols/vibe-plugin-ai-copilot
+```
+
+Or install the npm package directly into an existing project that hosts the VibeControls agent:
+
+```bash
+bun add @vibecontrols/vibe-plugin-ai-copilot
+# or
+npm install @vibecontrols/vibe-plugin-ai-copilot
+```
+
+## How it works
+
+AI **providers** implement the `AIProvider` contract from `@vibecontrols/vibe-plugin-ai` (meta). Once installed and registered, the agent can route prompts, hooks and MCP requests through this provider alongside any others you have configured. The meta plugin handles fan-out, provider selection and capability negotiation.
+
+This package is a **provider** registered against the `@vibecontrols/vibe-plugin-ai` meta plugin. Install the meta plugin first; this provider plugs into it.
+
+## Upstream
+
+- **GitHub Copilot CLI** — <https://github.com/github/copilot-cli>
+
+## More
+
+- npm: <https://www.npmjs.com/package/@vibecontrols/vibe-plugin-ai-copilot>
+- Source: <https://github.com/algoshred/vibe-plugin-ai-copilot>
+- Plugin contract / SDK: <https://github.com/algoshred/vibecontrols-plugin-sdk>
+- Plugin catalogue: <https://vibecontrols.com/plugins/ai-copilot>
+
+<!-- VIBECONTROLS_OSS_BODY_END -->
+
+<!-- VIBECONTROLS_OSS_FOOTER_START -->
+
+---
+
+## About VibeControls
+
+**VibeControls** is the agentic engineering mission control for AI-native teams. Vibe-plugins extend the VibeControls agent with new providers, tools, sessions, tunnels, storage backends, and security stages.
+
+- Website: <https://vibecontrols.com>
+- Documentation: <https://docs.vibecontrols.com>
+- Plugin SDK: <https://github.com/algoshred/vibecontrols-plugin-sdk>
+- All plugins: <https://github.com/algoshred?q=vibe-plugin-&type=all>
+
+## Credits
+
+This plugin builds on the following upstream open-source projects. All trademarks and copyrights remain with their respective owners.
+
+- **GitHub Copilot CLI** — <https://github.com/github/copilot-cli>
+
+## License
+
+Released under the [MIT License](./LICENSE).
+
+Copyright (c) 2026 Burdenoff Consultancy Services Private Limited, Algoshred Technologies Private Limited, and all its sister companies.
+
+Maintainer: **Vignesh T.V** — <https://github.com/tvvignesh>
+
+**Note**: this plugin is open source under MIT. The `@vibecontrols/agent` runtime that loads and orchestrates plugins is **closed source** and proprietary to Burdenoff Consultancy Services Pvt. Ltd. If you want a fully self-hostable agent, please open an issue or contact the maintainer.
+
+<!-- VIBECONTROLS_OSS_FOOTER_END -->

package/dist/index.d.ts

@@ -0,0 +1,100 @@
+/**
+ * vibe-plugin-copilot
+ *
+ * GitHub Copilot AI agent provider for VibeControls Agent.
+ * CLI-only provider — spawns the CLI binary for prompt execution.
+ */
+import type { VibePlugin, ProfileContext } from "@vibecontrols/plugin-sdk";
+type ProviderMode = "sdk" | "cli";
+type AISessionStatus = "active" | "idle" | "processing" | "error" | "terminated";
+type AILogType = "input" | "output" | "thinking" | "event" | "error" | "metadata";
+interface AISessionConfig {
+    name: string;
+    agentType: string;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+    systemPrompt?: string;
+    workingDirectory?: string;
+    providerConfig?: Record<string, unknown>;
+}
+interface AISession {
+    id: string;
+    name: string;
+    status: AISessionStatus;
+    agentType: string;
+    provider: string;
+    config: AISessionConfig;
+    stats: AIUsageStats;
+    createdAt: string;
+    updatedAt: string;
+}
+interface AIContext {
+    id: string;
+    type: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+interface AIResponse {
+    content: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    durationMs: number;
+    metadata?: Record<string, unknown>;
+}
+interface AIStreamChunk {
+    type: "text" | "thinking" | "error" | "done";
+    content: string;
+    tokensUsed?: number;
+}
+interface AILog {
+    id: string;
+    sessionId: string;
+    type: AILogType;
+    content: string;
+    tokenCount?: number;
+    model?: string;
+    durationMs?: number;
+    createdAt: string;
+}
+interface AILogFilter {
+    types?: AILogType[];
+    startDate?: string;
+    endDate?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+interface AIUsageStats {
+    inputTokens: number;
+    outputTokens: number;
+    requestCount: number;
+    estimatedCostUsd: number;
+}
+interface AIAgentProvider {
+    readonly name: string;
+    createSession(config: AISessionConfig): Promise<AISession>;
+    sendPrompt(sessionId: string, prompt: string, context?: AIContext[]): Promise<AIResponse>;
+    streamPrompt?(sessionId: string, prompt: string, context?: AIContext[], onChunk?: (chunk: AIStreamChunk) => void): Promise<AIResponse>;
+    getSessionLogs(sessionId: string, filter?: AILogFilter): Promise<AILog[]>;
+    getUsageStats(sessionId: string): Promise<AIUsageStats>;
+    configureSession(sessionId: string, config: Partial<AISessionConfig>): Promise<void>;
+    destroySession(sessionId: string): Promise<void>;
+    listSessions(): Promise<AISession[]>;
+    getSessionStatus(sessionId: string): Promise<AISessionStatus>;
+    healthCheck(): Promise<{
+        ok: boolean;
+        message?: string;
+    }>;
+    getCapabilities?(): Record<string, boolean>;
+    getMode?(): ProviderMode;
+    setMode?(_mode: ProviderMode): void;
+}
+type CopilotVibePlugin = VibePlugin & {
+    providers?: {
+        ai?: AIAgentProvider;
+    };
+};
+export declare const createPlugin: (_ctx: ProfileContext) => CopilotVibePlugin;
+export {};

package/dist/index.js

@@ -0,0 +1,8 @@
+// @bun
+import{Elysia as Elysia2}from"elysia";import{Elysia}from"elysia";function createLifecycleHooks(spec){let{name,onInit,onShutdown,onNuke,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)},onNuke:async(hostServices,ctx)=>{if(onNuke)return onNuke(hostServices,ctx)}}}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)}},BoundLogger=class{constructor(logger,source){this.logger=logger,this.source=source}logger;source;info(message,meta){this.logger?.info?.(this.source,message,meta)}warn(message,meta){this.logger?.warn?.(this.source,message,meta)}error(message,meta){this.logger?.error?.(this.source,message,meta)}debug(message,meta){this.logger?.debug?.(this.source,message,meta)}};var CONTEXT_PROVIDER_TYPE="context",REGISTRY_KEY=Symbol.for("@vibecontrols/plugin-sdk:contextProviders@1");function getRegistry(){let slots=globalThis,existing=slots[REGISTRY_KEY];if(existing)return existing;let created=new Map;return slots[REGISTRY_KEY]=created,created}function registerContextProvider(provider,hostServices){if(!provider||typeof provider.name!=="string"||provider.name.length===0)throw Error("ContextProvider.name is required");if(typeof provider.getContext!=="function")throw Error("ContextProvider.getContext must be a function");getRegistry().set(provider.name,provider),hostServices?.serviceRegistry?.registerProvider?.(CONTEXT_PROVIDER_TYPE,provider,provider.name)}function listContextProviders(){return Array.from(getRegistry().values())}function getContextProvider(name){return getRegistry().get(name)}var ProviderRegistry=class{constructor(hostServices){this.hostServices=hostServices}hostServices;registerContextProvider(provider){registerContextProvider(provider,this.hostServices)}listContextProviders(){return listContextProviders()}getContextProvider(name){return getContextProvider(name)}getServiceRegistry(){return this.hostServices?.serviceRegistry}registerProvider(type,name,provider){this.hostServices?.serviceRegistry?.registerProvider?.(type,provider,name)}getProvider(type,name){let reg=this.hostServices?.serviceRegistry;if(!reg)return;if(name===void 0)return reg.getProvider?.(type);if(reg.getProviderByName)return reg.getProviderByName(type,name);if(!reg.listProvidersForType)return;if(!(reg.listProvidersForType(type)??[]).some((entry)=>typeof entry==="string"?entry===name:entry.pluginName===name))return;return reg.getProvider?.(type)}listProviders(type){return(this.hostServices?.serviceRegistry?.listProvidersForType?.(type)??[]).map((entry)=>typeof entry==="string"?entry:entry.pluginName)}withCliContribution(contribution){let contributors=this.hostServices?.cliContributors;if(!contributors)return;for(let section of contribution.statusSections??[])contributors.addStatusSection?.(section);for(let check of contribution.doctorChecks??[])contributors.addDoctorCheck?.(check)}};var PROVIDER_NAME="copilot",CLI_COMMAND="gh";function platformExeName(base){return process.platform==="win32"?`${base}.exe`:base}function resolveCliBin(){let found=typeof Bun<"u"&&typeof Bun.which==="function"?Bun.which(CLI_COMMAND,{PATH:process.env.PATH}):null;if(found)return found;return platformExeName(CLI_COMMAND)}var CLI_BIN=resolveCliBin(),DISPLAY="GitHub Copilot",API_PREFIX=`/api/ai-${PROVIDER_NAME}`,SUPPORTED_MODES=["cli"],PREREQ_NAME="gh-copilot",CLI_INSTALL_COMMAND=["gh","extension","install","github/gh-copilot"];class ProviderImpl{name=PROVIDER_NAME;sessions=new Map;logIngester=null;hostServices=null;logger=null;setHostServices(hs){this.hostServices=hs,this.logger=new BoundLogger(hs.logger,`${PROVIDER_NAME}-provider`);let registry=new ProviderRegistry(hs);this.logIngester=registry.getProvider("ai","log-ingester")??null}async createSession(config){let id=config.providerConfig?.sessionId||crypto.randomUUID(),now=new Date().toISOString(),existing=this.sessions.get(id);if(existing)return existing.status="active",existing.updatedAt=now,{id,name:existing.config.name,status:"active",agentType:existing.config.agentType,provider:PROVIDER_NAME,config:existing.config,stats:existing.stats,createdAt:existing.createdAt,updatedAt:now};let session={id,config,status:"active",stats:{inputTokens:0,outputTokens:0,requestCount:0,estimatedCostUsd:0},createdAt:now,updatedAt:now};return this.sessions.set(id,session),{id,name:config.name,status:"active",agentType:config.agentType,provider:PROVIDER_NAME,config,stats:session.stats,createdAt:now,updatedAt:now}}async sendPrompt(sessionId,prompt,context){let session=this.sessions.get(sessionId);if(!session)throw Error(`Session ${sessionId} not found`);if(session.status==="terminated")throw Error("Session is terminated");session.status="processing",session.updatedAt=new Date().toISOString();let startTime=Date.now(),fullPrompt=prompt;if(context?.length)fullPrompt=prompt+`
+
+`+context.map((c)=>`--- Context (${c.type}): ---
+${c.content}`).join(`
+
+`);this.logIngester?.append({sessionId,type:"input",content:prompt});try{let args=CLI_ARGS_FN(session.config,fullPrompt),proc=Bun.spawn([CLI_BIN,...args],{stdout:"pipe",stderr:"pipe",cwd:session.config.workingDirectory||process.cwd(),timeout:300000}),stdout=await new Response(proc.stdout).text(),stderr=await new Response(proc.stderr).text(),exitCode=await proc.exited,durationMs=Date.now()-startTime;if(exitCode!==0&&!stdout)throw Error(`${DISPLAY} exited with code ${exitCode}: ${stderr}`);let content=stdout.trim()||stderr.trim(),inputTokens=Math.ceil(fullPrompt.length/4),outputTokens=Math.ceil(content.length/4);return session.stats.inputTokens+=inputTokens,session.stats.outputTokens+=outputTokens,session.stats.requestCount+=1,session.status="active",session.updatedAt=new Date().toISOString(),this.logIngester?.append({sessionId,type:"output",content,tokenCount:outputTokens,model:"default",durationMs}),{content,model:"default",inputTokens,outputTokens,durationMs,metadata:{exitCode,provider:PROVIDER_NAME,mode:"cli"}}}catch(err){session.status="error",session.updatedAt=new Date().toISOString();let errorMsg=err instanceof Error?err.message:"Unknown error";throw this.logIngester?.append({sessionId,type:"error",content:errorMsg}),err}}async getSessionLogs(_sessionId,_filter){return[]}async getUsageStats(sessionId){return this.sessions.get(sessionId)?.stats??{inputTokens:0,outputTokens:0,requestCount:0,estimatedCostUsd:0}}async configureSession(sessionId,config){let s=this.sessions.get(sessionId);if(s)Object.assign(s.config,config),s.updatedAt=new Date().toISOString()}async destroySession(sessionId){let s=this.sessions.get(sessionId);if(s)s.status="terminated",s.updatedAt=new Date().toISOString()}async listSessions(){return Array.from(this.sessions.values()).map((s)=>({id:s.id,name:s.config.name,status:s.status,agentType:s.config.agentType,provider:PROVIDER_NAME,config:s.config,stats:s.stats,createdAt:s.createdAt,updatedAt:s.updatedAt}))}async getSessionStatus(sessionId){return this.sessions.get(sessionId)?.status??"terminated"}async healthCheck(){let version=getCliVersion();return version?{ok:!0,message:`${DISPLAY} ${version}`}:{ok:!1,message:`${DISPLAY} GitHub CLI extension not available`}}getCapabilities(){return{streaming:!1,vision:!1,fileAttachments:!1,toolUse:!1,mcpSupport:!1,voiceMode:!1,cancelSupport:!0,modelListing:!1}}getSupportedModes(){return[...SUPPORTED_MODES]}getDisplayName(){return DISPLAY}getPrereqApiPrefix(){return API_PREFIX}getMode(){return"cli"}setMode(mode){if(mode!=="cli")throw Error(`${DISPLAY} only supports CLI mode`)}log(level,msg){this.logger?.[level](msg)}}function CLI_ARGS_FN(_config,prompt){return["copilot","explain",prompt]}function getCliVersion(){try{let proc=Bun.spawnSync([CLI_BIN,"copilot","--help"],{timeout:5000,stdout:"pipe",stderr:"pipe"});if(proc.exitCode===0)return proc.stdout.toString().trim().split(/\r?\n/)[0]||"gh copilot"}catch{}return null}function createPrereqsRoutes(){return new Elysia2({prefix:"/prereqs"}).get("/status",()=>{let version=getCliVersion();return{satisfied:Boolean(version),missing:version?[]:[{name:PREREQ_NAME,kind:"manual",requiresSudo:!1,description:`${DISPLAY} GitHub CLI extension for CLI mode`}]}}).post("/install",()=>{if(getCliVersion())return{ok:!0,installed:[PREREQ_NAME],pendingSudo:[],errors:[]};let proc=Bun.spawnSync(CLI_INSTALL_COMMAND,{timeout:120000,stdout:"pipe",stderr:"pipe"});if(proc.exitCode===0)return{ok:!0,installed:[PREREQ_NAME],pendingSudo:[],errors:[]};return{ok:!1,installed:[],pendingSudo:[],errors:[{name:PREREQ_NAME,message:proc.stderr.toString().trim()||`Run manually: ${CLI_INSTALL_COMMAND.join(" ")}`}]}})}var PLUGIN_NAME=PROVIDER_NAME,PLUGIN_VERSION="1.0.0",provider=new ProviderImpl,lifecycle=createLifecycleHooks({name:PLUGIN_NAME,telemetryEventName:"ai.provider.ready",onInit:(hostServices)=>{provider.setHostServices(hostServices),new TelemetryEmitter(PLUGIN_NAME,PLUGIN_VERSION,hostServices).emit("ai.provider.ready",{provider:PLUGIN_NAME})},onShutdown:()=>{for(let[id]of provider.sessions)provider.destroySession(id).catch(()=>{})}}),createPlugin=(_ctx)=>({capabilities:{secrets:"read",subprocess:!0,gateway:!1,telemetry:!0},name:PLUGIN_NAME,version:PLUGIN_VERSION,description:`${DISPLAY} AI agent provider for VibeControls`,tags:["provider","integration"],apiPrefix:API_PREFIX,prerequisites:[{name:PREREQ_NAME,kind:"manual",requiresSudo:!1}],providers:{ai:provider},createRoutes:()=>createPrereqsRoutes(),onServerStart:lifecycle.onServerStart,onServerStop:lifecycle.onServerStop});export{createPlugin};

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@vibecontrols/vibe-plugin-ai-copilot",
+  "version": "2026.601.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "description": "GitHub Copilot AI agent provider for VibeControls Agent",
+  "engines": {
+    "bun": ">=1.3.14"
+  },
+  "author": {
+    "name": "Vignesh T.V",
+    "url": "https://github.com/tvvignesh"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun --minify-syntax --minify-whitespace --external elysia && tsc --emitDeclarationOnly --declaration --outDir ./dist",
+    "dev": "tsc --watch",
+    "lint": "eslint ./src",
+    "format": "bunx prettier . --write",
+    "format:check": "bunx prettier . --check",
+    "type:check": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "prebuild": "bun run clean",
+    "prepublishOnly": "bun run build",
+    "sanity": "bun run format:check && bun run lint && bun run type:check && bun run build"
+  },
+  "dependencies": {
+    "@vibecontrols/plugin-sdk": "2026.601.1",
+    "elysia": "^1.3.0",
+    "openai": "^4.80.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^22.0.0",
+    "bun-types": "^1.3.9",
+    "eslint": "^9.30.1",
+    "globals": "^17.3.0",
+    "prettier": "^3.6.2",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.56.0"
+  },
+  "peerDependencies": {
+    "@vibecontrols/agent": ">=2.0.0",
+    "@vibecontrols/vibe-plugin-ai": "2026.509.1"
+  },
+  "peerDependenciesMeta": {
+    "@vibecontrols/agent": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "vibecontrols",
+    "vibe",
+    "vibe-plugin",
+    "copilot",
+    "ai",
+    "bun"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/algoshred/vibe-plugin-ai-copilot.git"
+  },
+  "bugs": {
+    "url": "https://github.com/algoshred/vibe-plugin-ai-copilot/issues"
+  },
+  "homepage": "https://vibecontrols.com",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist/**/*",
+    "!dist/**/*.map",
+    "README.md",
+    "LICENSE"
+  ],
+  "overrides": {
+    "lodash": ">=4.17.21",
+    "lodash-es": ">=4.17.21",
+    "dompurify": ">=3.3.4",
+    "fast-xml-parser": ">=4.5.5",
+    "@xmldom/xmldom": ">=0.8.12",
+    "swiper": ">=12.1.2",
+    "brace-expansion": ">=1.1.13",
+    "follow-redirects": ">=1.15.12",
+    "smol-toml": ">=1.6.1",
+    "axios": ">=1.15.0",
+    "flatted": ">=3.4.1",
+    "yaml": ">=2.8.3",
+    "picomatch": ">=2.3.2",
+    "immutable": ">=3.8.3",
+    "minimatch": ">=3.1.3"
+  }
+}