@vpxa/aikit 0.1.23 → 0.1.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vpxa/aikit",
3
- "version": "0.1.23",
3
+ "version": "0.1.24",
4
4
  "type": "module",
5
5
  "description": "Local-first AI developer toolkit — knowledge base, code analysis, context management, and developer tools for LLM agents",
6
6
  "license": "MIT",
@@ -66,10 +66,11 @@ function buildToolsYaml(toolRole) {
66
66
  function copilotModel(agentName) {
67
67
  const models = COPILOT_MODELS[agentName];
68
68
  if (!models) return 'Auto (copilot)';
69
+ // NOTE: Model array syntax (e.g. [model1, model2]) is experimental and
70
+ // requires a VS Code experiment flag to be enabled. For now, we always
71
+ // emit the primary (first) model as a plain string.
69
72
  if (Array.isArray(models)) {
70
- if (models.length === 0) return 'Auto (copilot)';
71
- if (models.length === 1) return models[0];
72
- return `[${models.join(', ')}]`;
73
+ return models[0] || 'Auto (copilot)';
73
74
  }
74
75
  return models;
75
76
  }
@@ -7,6 +7,12 @@
7
7
  *
8
8
  * Naming convention for variants: {Role}-Alpha, {Role}-Beta, {Role}-Gamma, {Role}-Delta
9
9
  * These are abstract labels — the actual model behind each is defined HERE.
10
+ *
11
+ * NOTE (Experimental): VS Code supports a model array syntax (e.g. [model1, model2])
12
+ * for agent files, but it requires an experiment flag to be enabled. Until the flag
13
+ * is generally available, adapters should emit only the first (primary) model as a
14
+ * plain string. The full fallback arrays are retained here so adapters can switch to
15
+ * array output when the flag is GA.
10
16
  */
11
17
 
12
18
  export const COPILOT_MODELS = {
@@ -2,7 +2,7 @@
2
2
  description: 'Primary architecture reviewer'
3
3
  argument-hint: "Files, PR, or subsystem to architecture-review"
4
4
  tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [GPT-5.4 (copilot), Auto (copilot)]
5
+ model: GPT-5.4 (copilot)
6
6
  ---
7
7
 
8
8
  # Architect-Reviewer-Alpha - The Structural Guardian
@@ -2,7 +2,7 @@
2
2
  description: 'Architecture reviewer variant — different LLM perspective for dual review'
3
3
  argument-hint: "Files, PR, or subsystem to architecture-review"
4
4
  tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [Claude Opus 4.6 (copilot), Auto (copilot)]
5
+ model: Claude Opus 4.6 (copilot)
6
6
  ---
7
7
 
8
8
  # Architect-Reviewer-Beta - The Structural Guardian
@@ -2,7 +2,7 @@
2
2
  description: 'Primary code reviewer'
3
3
  argument-hint: "File path, PR, or code to review"
4
4
  tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [GPT-5.4 (copilot), Auto (copilot)]
5
+ model: GPT-5.4 (copilot)
6
6
  ---
7
7
 
8
8
  # Code-Reviewer-Alpha - The Quality Guardian
@@ -2,7 +2,7 @@
2
2
  description: 'Code reviewer variant — different LLM perspective for dual review'
3
3
  argument-hint: "File path, PR, or code to review"
4
4
  tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [Claude Opus 4.6 (copilot), Auto (copilot)]
5
+ model: Claude Opus 4.6 (copilot)
6
6
  ---
7
7
 
8
8
  # Code-Reviewer-Beta - The Quality Guardian
@@ -2,7 +2,7 @@
2
2
  description: 'Expert debugger that diagnoses issues, traces errors, and provides solutions'
3
3
  argument-hint: "Error message, stack trace, or description of issue"
4
4
  tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalSelection, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, search/changes, search/codebase, search/usages, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [Claude Opus 4.6 (copilot), GPT-5.4 (copilot), GPT-5.3-Codex (copilot), Auto (copilot)]
5
+ model: Claude Opus 4.6 (copilot)
6
6
  ---
7
7
 
8
8
  # Debugger - The Problem Solver
@@ -2,7 +2,7 @@
2
2
  description: 'Documentation specialist that creates and maintains comprehensive project documentation'
3
3
  argument-hint: "Component, API, feature, or area to document"
4
4
  tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [GPT-5.4 (copilot), Gemini 3.1 Pro (Preview) (copilot), Auto (copilot)]
5
+ model: GPT-5.4 (copilot)
6
6
  ---
7
7
 
8
8
  # Documenter - The Knowledge Keeper
@@ -2,7 +2,7 @@
2
2
  description: 'Rapid codebase exploration to find files, usages, dependencies, and structural context'
3
3
  argument-hint: "Find files, usages, and context related to: {topic or goal}"
4
4
  tools: [read/problems, read/readFile, search/changes, search/codebase, search/usages, search/fileSearch, search/listDirectory, search/textSearch, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [Gemini 3 Flash (Preview) (copilot), Claude Haiku 4.5 (copilot), Auto (copilot)]
5
+ model: Gemini 3 Flash (Preview) (copilot)
6
6
  ---
7
7
 
8
8
  # Explorer - The Rapid Scout
@@ -2,7 +2,7 @@
2
2
  description: 'UI/UX specialist for React, styling, responsive design, and frontend implementation'
3
3
  argument-hint: "UI component, styling task, or frontend feature"
4
4
  tools: [execute/createAndRunTask, execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, todo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [Gemini 3.1 Pro (Preview) (copilot), GPT-5.4 (copilot), GPT-5.3-Codex (copilot), Auto (copilot)]
5
+ model: Gemini 3.1 Pro (Preview) (copilot)
6
6
  ---
7
7
 
8
8
  # Frontend - The UI Specialist
@@ -2,7 +2,7 @@
2
2
  description: 'Persistent implementation agent that writes code following TDD practices until all tasks are complete'
3
3
  argument-hint: "Implementation task, feature, or phase from plan"
4
4
  tools: [execute/createAndRunTask, execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, todo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [GPT-5.4 (copilot), Gemini 3.1 Pro (Preview) (copilot), GPT-5.3-Codex (copilot), Auto (copilot)]
5
+ model: GPT-5.4 (copilot)
6
6
  ---
7
7
 
8
8
  # Implementer - The Code Builder
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  description: 'Master conductor that orchestrates the full development lifecycle: Planning → Implementation → Review → Recovery → Commit'
3
3
  tools: [vscode/memory, vscode/runCommand, vscode/switchAgent, execute/killTerminal, execute/createAndRunTask, execute/runInTerminal, read/terminalSelection, read/terminalLastCommand, read/problems, read/readFile, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, todo, search/searchSubagent, search/textSearch, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, vscode/askQuestions, vscode/resolveMemoryFileUri, aikit/*]
4
- model: [Claude Opus 4.6 (copilot), GPT-5.4 (copilot), Auto (copilot)]
4
+ model: Claude Opus 4.6 (copilot)
5
5
  ---
6
6
 
7
7
  # Orchestrator - The Master Conductor
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  description: 'Autonomous planner that researches codebases and writes comprehensive TDD implementation plans'
3
3
  tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, todo, search/searchSubagent, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
4
- model: [Claude Opus 4.6 (copilot), GPT-5.4 (copilot), Auto (copilot)]
4
+ model: Claude Opus 4.6 (copilot)
5
5
  ---
6
6
 
7
7
  # Planner - The Strategic Architect
@@ -2,7 +2,7 @@
2
2
  description: 'Code refactoring specialist that improves structure, readability, and maintainability'
3
3
  argument-hint: "Code, component, or pattern to refactor"
4
4
  tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [GPT-5.4 (copilot), GPT-5.3-Codex (copilot), Auto (copilot)]
5
+ model: GPT-5.4 (copilot)
6
6
  ---
7
7
 
8
8
  # Refactor - The Code Sculptor
@@ -2,7 +2,7 @@
2
2
  description: 'Primary deep research agent — also serves as default Researcher'
3
3
  argument-hint: "Research question, problem statement, or subsystem to investigate"
4
4
  tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [Claude Opus 4.6 (copilot), Auto (copilot)]
5
+ model: Claude Opus 4.6 (copilot)
6
6
  ---
7
7
 
8
8
  # Researcher-Alpha - The Context Gatherer
@@ -2,7 +2,7 @@
2
2
  description: 'Research variant — pragmatic analysis with focus on trade-offs and edge cases'
3
3
  argument-hint: "Research question, problem statement, or subsystem to investigate"
4
4
  tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [Claude Sonnet 4.6 (copilot), Auto (copilot)]
5
+ model: Claude Sonnet 4.6 (copilot)
6
6
  ---
7
7
 
8
8
  # Researcher-Beta - The Context Gatherer
@@ -2,7 +2,7 @@
2
2
  description: 'Research variant — implementation feasibility and performance implications'
3
3
  argument-hint: "Research question, problem statement, or subsystem to investigate"
4
4
  tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [Gemini 3.1 Pro (Preview) (copilot), Auto (copilot)]
5
+ model: Gemini 3.1 Pro (Preview) (copilot)
6
6
  ---
7
7
 
8
8
  # Researcher-Delta - The Context Gatherer
@@ -2,7 +2,7 @@
2
2
  description: 'Research variant — broad pattern matching across domains and technologies'
3
3
  argument-hint: "Research question, problem statement, or subsystem to investigate"
4
4
  tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [GPT-5.4 (copilot), Auto (copilot)]
5
+ model: GPT-5.4 (copilot)
6
6
  ---
7
7
 
8
8
  # Researcher-Gamma - The Context Gatherer
@@ -2,7 +2,7 @@
2
2
  description: 'Security specialist that analyzes code for vulnerabilities and compliance'
3
3
  argument-hint: "Code, feature, or component to security review"
4
4
  tools: [execute/runInTerminal, read/problems, read/readFile, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
5
- model: [Claude Opus 4.6 (copilot), GPT-5.4 (copilot), Auto (copilot)]
5
+ model: Claude Opus 4.6 (copilot)
6
6
  ---
7
7
 
8
8
  # Security - The Vulnerability Hunter