@aexol/spectral 0.8.2 → 0.8.6

package/dist/extensions/aexol-mcp.js

@@ -1,30 +1,30 @@
 /**
- * Aexol MCP pi extension.
+ * Aexol MCP spectral extension.
  *
  * Loaded by the spectral wrapper via `--extension <abs-path>`. On startup it:
  *   1. Reads ~/.spectral/config.json (writen by `spectral login`).
  *   2. Calls tools/list against the MCP backend once.
  *   3. Reads the local Studio binding (`.aexol/aexol.jsonc`) so remote tools
  *      auto-inherit `teamId` / `projectId` without needing `remote_set_context`.
- *   4. Registers every returned remote tool through pi.registerTool() so the
+ *   4. Registers every returned remote tool through ext.registerTool() so the
  *      model can call them like built-in tools.
  *   5. Registers local binding-management tools (`local_bind_project`,
  *      `local_unbind_project`, `local_get_binding`) so users can bind a
  *      directory to an Aexol Studio project from within the agent.
  *
- * Each registered tool is just a thin proxy: when pi's model invokes it, we
+ * Each registered tool is just a thin proxy: when spectral's model invokes it, we
  * translate the call into a JSON-RPC tools/call POST and unwrap the response
- * into the `{ content: [{ type: "text", text }], details }` shape pi expects.
+ * into the `{ content: [{ type: "text", text }], details }` shape spectral expects.
  *
  * Failure modes are intentionally non-fatal: if config is missing or the
- * backend is unreachable we log a warning and return, leaving pi to start
+ * backend is unreachable we log a warning and return, leaving spectral to start
  * without Aexol tools rather than crashing the whole agent.
  */
 import { getApiUrl, getConfigFile, readConfig } from "../config.js";
 import { AexolMcpClient, AexolMcpError } from "../mcp-client.js";
 import { readStudioBinding, writeStudioBinding, deleteStudioBinding, } from "../studio-binding.js";
 /**
- * Render a backend tool result into a single string for pi.
+ * Render a backend tool result into a single string for ext.
  *
  * The Aexol backend wraps results as `{ content: [{ type: "json", json: ... }] }`
  * but may also send `{ type: "text", text: ... }`. We pick the first content
@@ -96,7 +96,7 @@ function augmentParams(toolName, params) {
     }
     return augmented;
 }
-export default async function aexolMcpExtension(pi) {
+export default async function aexolMcpExtension(ext) {
     const cfg = await readConfig();
     if (!cfg) {
         // Pre-flight in cli.ts should have caught this. Logging is enough.
@@ -153,7 +153,7 @@ export default async function aexolMcpExtension(pi) {
                     // Surface backend tool errors as a textual result, not a thrown
                     // exception. Pi treats this as the tool's natural reply; the model
                     // sees the `[Aexol MCP error] ...` marker and can recover. Throwing
-                    // here would force pi to wrap the message and risk crashing
+                    // here would force spectral to wrap the message and risk crashing
                     // callers that don't expect agent-tool exceptions.
                     const errorText = `[Aexol MCP error] ${text || "Tool reported an error with no message."}`;
                     return {
@@ -168,7 +168,7 @@ export default async function aexolMcpExtension(pi) {
             },
         };
         try {
-            pi.registerTool(definition);
+            ext.registerTool(definition);
             registered++;
         }
         catch (err) {
@@ -181,7 +181,7 @@ export default async function aexolMcpExtension(pi) {
     // binding directly from within the agent, without the user having to drop
     // out to the terminal and run `spectral bind` / `spectral unbind`.
     try {
-        pi.registerTool({
+        ext.registerTool({
             name: "local_bind_project",
             label: "Bind Project",
             description: "Link the current working directory to an Aexol Studio project. " +
@@ -249,7 +249,7 @@ export default async function aexolMcpExtension(pi) {
         process.stderr.write(`[aexol-mcp] Failed to register local_bind_project: ${msg}\n`);
     }
     try {
-        pi.registerTool({
+        ext.registerTool({
             name: "local_unbind_project",
             label: "Unbind Project",
             description: "Remove the Aexol Studio project binding from the current working directory. " +
@@ -301,7 +301,7 @@ export default async function aexolMcpExtension(pi) {
         process.stderr.write(`[aexol-mcp] Failed to register local_unbind_project: ${msg}\n`);
     }
     try {
-        pi.registerTool({
+        ext.registerTool({
             name: "local_get_binding",
             label: "Get Binding",
             description: "Show the current Aexol Studio project binding for this directory. " +

package/dist/extensions/kanban-bridge.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Kanban Bridge spectral extension.
+ *
+ * Registers kanban management tools that allow the coding agent to read,
+ * create, update, and move Kanban tasks on the Aexol Studio board. This
+ * enables task-driven execution — the agent can pick up TODO tasks, work
+ * on them, and move them to DONE.
+ *
+ * Auth is read from ~/.spectral/config.json (same as aexol-mcp).
+ * The Studio project ID comes from the local binding (.aexol/aexol.jsonc),
+ * falling back to an explicit kanban_project_id flag.
+ *
+ * Registered tools:
+ *   - kanban_list          — List all Kanban tasks for the project
+ *   - kanban_get           — Get a single task by ID
+ *   - kanban_create        — Create a new Kanban task
+ *   - kanban_update        — Update a task (title, description, priority, tags)
+ *   - kanban_move          — Move a task between columns (BACKLOG → TODO → IN_PROGRESS → DONE)
+ *   - kanban_next          — Pick the next TODO task and mark it IN_PROGRESS
+ *   - kanban_delete        — Delete a task
+ */
+import type { ExtensionAPI } from "../sdk/coding-agent/index.js";
+export default function kanbanBridgeExtension(ext: ExtensionAPI): Promise<void>;
+//# sourceMappingURL=kanban-bridge.d.ts.map

package/dist/extensions/kanban-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kanban-bridge.d.ts","sourceRoot":"","sources":["../../src/extensions/kanban-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,8BAA8B,CAAC;AAixBjF,wBAA8B,qBAAqB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCpF"}

package/dist/extensions/kanban-bridge.js

@@ -1,5 +1,5 @@
 /**
- * Kanban Bridge pi extension.
+ * Kanban Bridge spectral extension.
  *
  * Registers kanban management tools that allow the coding agent to read,
  * create, update, and move Kanban tasks on the Aexol Studio board. This
@@ -636,7 +636,7 @@ const kanbanDeleteTool = {
 // ---------------------------------------------------------------------------
 // Extension entry point
 // ---------------------------------------------------------------------------
-export default async function kanbanBridgeExtension(pi) {
+export default async function kanbanBridgeExtension(ext) {
     const tools = [
         kanbanListTool,
         kanbanGetTool,
@@ -649,7 +649,7 @@ export default async function kanbanBridgeExtension(pi) {
     let registered = 0;
     for (const tool of tools) {
         try {
-            pi.registerTool(tool);
+            ext.registerTool(tool);
             registered++;
         }
         catch (err) {

package/dist/extensions/openrouter-attribution.d.ts

@@ -0,0 +1,12 @@
+/**
+ * OpenRouter App Attribution extension.
+ *
+ * Adds HTTP headers required by OpenRouter's app attribution system so that
+ * Aexol / Spectral appears in OpenRouter rankings, analytics, and model
+ * "Apps" tabs. Without these headers our usage is anonymous to OpenRouter.
+ *
+ * @see https://openrouter.ai/docs/app-attribution
+ */
+import type { ExtensionAPI } from "../sdk/coding-agent/index.js";
+export default function openrouterAttributionExtension(ext: ExtensionAPI): void;
+//# sourceMappingURL=openrouter-attribution.d.ts.map

package/dist/extensions/openrouter-attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter-attribution.d.ts","sourceRoot":"","sources":["../../src/extensions/openrouter-attribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,CAAC,OAAO,UAAU,8BAA8B,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAU9E"}

package/dist/extensions/openrouter-attribution.js

@@ -7,8 +7,8 @@
  *
  * @see https://openrouter.ai/docs/app-attribution
  */
-export default function openrouterAttributionExtension(pi) {
-    pi.registerProvider("openrouter", {
+export default function openrouterAttributionExtension(ext) {
+    ext.registerProvider("openrouter", {
         headers: {
             "HTTP-Referer": "https://aexol.ai",
             "X-OpenRouter-Title": "Aexol",

package/dist/extensions/spectral-vision-fallback.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Spectral Vision Extension
+ *
+ * Automatically switches to a vision-capable model for image processing
+ * when images are attached. This allows non-vision models to "see" images
+ * and saves main agent context by using a potentially smaller/cheaper
+ * vision model for image understanding.
+ *
+ * Logic:
+ *   - If the main model supports vision natively, images pass through
+ *     directly — no interception, no text descriptions.
+ *   - When the main model does NOT support vision, falls back to the
+ *     admin-configured default vision model (isVisionDefault flag from
+ *     backend via SettingsManager) for image descriptions.
+ *   - If no admin default is configured, falls back to the best
+ *     available vision-capable model by provider priority.
+ *
+ * Hooks into the `context` event to intercept ALL images before they reach
+ * the LLM (covers user-attached images and tool-result images alike).
+ */
+import type { ExtensionAPI } from "../sdk/coding-agent/index.js";
+export default function spectralVisionExtension(ext: ExtensionAPI): void;
+//# sourceMappingURL=spectral-vision-fallback.d.ts.map

package/dist/extensions/spectral-vision-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spectral-vision-fallback.d.ts","sourceRoot":"","sources":["../../src/extensions/spectral-vision-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAuNjE,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAmFvE"}

package/dist/extensions/spectral-vision-fallback.js

@@ -7,14 +7,13 @@
  * vision model for image understanding.
  *
  * Logic:
- *   - ALWAYS intercepts images (even when main model supports vision),
- *     replacing them with text descriptions.
- *   - Prefers the admin-configured default vision model (isVisionDefault
- *     flag from backend via SettingsManager) for image descriptions.
- *   - Falls back to the main model for vision if no admin default is
- *     configured and the main model supports images.
- *   - If neither is available, falls back to the first available
- *     vision-capable model by provider priority.
+ *   - If the main model supports vision natively, images pass through
+ *     directly — no interception, no text descriptions.
+ *   - When the main model does NOT support vision, falls back to the
+ *     admin-configured default vision model (isVisionDefault flag from
+ *     backend via SettingsManager) for image descriptions.
+ *   - If no admin default is configured, falls back to the best
+ *     available vision-capable model by provider priority.
  *
  * Hooks into the `context` event to intercept ALL images before they reach
  * the LLM (covers user-attached images and tool-result images alike).
@@ -47,24 +46,25 @@ function getAdminVisionModel(ctx) {
  * Resolve the best vision model to use for image descriptions.
  *
  * Priority:
- *   1. Admin-configured default vision model (isVisionDefault from backend)
- *   2. Current main model if it supports images
+ *   1. Current main model if it supports images — passthrough, no interception
+ *   2. Admin-configured default vision model (isVisionDefault from backend)
  *   3. Best available vision model by provider priority
  *   4. First available vision model
  */
 function resolveVisionModel(ctx) {
-    // 1. Admin-configured default vision model (always preferred)
+    // 1. If the main model supports vision natively, skip interception entirely
+    //    and let the main model process images directly.
+    const currentModel = ctx.model;
+    if (currentModel?.input.includes("image") && ctx.modelRegistry.hasConfiguredAuth(currentModel)) {
+        process.stderr.write(`[spectral-vision] Main model supports vision — passing images through natively (${currentModel.provider}/${currentModel.id})\n`);
+        return undefined;
+    }
+    // 2. Admin-configured default vision model (fallback for non-vision main models)
     const adminModel = getAdminVisionModel(ctx);
     if (adminModel) {
         process.stderr.write(`[spectral-vision] Using admin-configured default: ${adminModel.provider}/${adminModel.id}\n`);
         return adminModel;
     }
-    // 2. Current main model if it supports images
-    const currentModel = ctx.model;
-    if (currentModel?.input.includes("image") && ctx.modelRegistry.hasConfiguredAuth(currentModel)) {
-        process.stderr.write(`[spectral-vision] Using main model for vision: ${currentModel.provider}/${currentModel.id}\n`);
-        return currentModel;
-    }
     // 3. Fall back to best available vision model by provider priority
     const allModels = ctx.modelRegistry.getAll();
     const visionModels = allModels.filter((m) => m.input.includes("image") && ctx.modelRegistry.hasConfiguredAuth(m));
@@ -177,18 +177,21 @@ async function describeImages(visionModel, content, contextText, ctx) {
 // ---------------------------------------------------------------------------
 // Extension entry point
 // ---------------------------------------------------------------------------
-export default function spectralVisionExtension(pi) {
+export default function spectralVisionExtension(ext) {
     let visionModel;
-    pi.on("session_start", (_event, ctx) => {
+    ext.on("session_start", (_event, ctx) => {
         visionModel = resolveVisionModel(ctx);
         if (visionModel) {
             process.stderr.write(`[spectral-vision] Ready — using ${visionModel.provider}/${visionModel.id} for image descriptions.\n`);
         }
+        else if (ctx.model?.input.includes("image")) {
+            process.stderr.write(`[spectral-vision] Ready — main model ${ctx.model.provider}/${ctx.model.id} handles vision natively, passthrough enabled.\n`);
+        }
         else {
             process.stderr.write("[spectral-vision] No vision model with auth configured. Image description disabled.\n");
         }
     });
-    pi.on("context", async (event, ctx) => {
+    ext.on("context", async (event, ctx) => {
         const messages = event.messages;
         // Check if any message contains images
         let totalImages = 0;
@@ -198,11 +201,17 @@ export default function spectralVisionExtension(pi) {
         if (totalImages === 0)
             return;
         // Re-resolve vision model each time images are encountered.
-        // This ensures automatic switching to the admin-configured default
-        // vision model even when the main model supports vision.
+        // If the main model supports vision natively, resolveVisionModel
+        // returns undefined and we pass images through without interception.
         visionModel = resolveVisionModel(ctx);
         if (!visionModel) {
-            process.stderr.write("[spectral-vision] No vision model available, images will be omitted\n");
+            // Check if we're in passthrough mode (main model has native vision)
+            if (ctx.model?.input.includes("image")) {
+                process.stderr.write(`[spectral-vision] Passthrough — ${totalImages} image(s) flowing to main model natively\n`);
+            }
+            else {
+                process.stderr.write("[spectral-vision] No vision model available, images will be omitted\n");
+            }
             return;
         }
         process.stderr.write(`[spectral-vision] Describing ${totalImages} image(s) with ${visionModel.provider}/${visionModel.id}...\n`);

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @aexol/spectral — Public API for extension authors.
+ *
+ * Import types and utilities from this package when writing .spectral extensions.
+ *
+ * ## Quick Start
+ *
+ * ```ts
+ * import type { ExtensionAPI, ToolDefinition } from "@aexol/spectral";
+ *
+ * export default function activate(ext: ExtensionAPI): void {
+ *   ext.registerTool({
+ *     name: "my_tool",
+ *     label: "My Tool",
+ *     description: "Does something useful.",
+ *     parameters: { type: "object", properties: {}, additionalProperties: false },
+ *     async execute(_id, params) {
+ *       return { content: [{ type: "text", text: "Done!" }], details: {} };
+ *     },
+ *   });
+ * }
+ * ```
+ *
+ * ## Event Handling
+ *
+ * ```ts
+ * import type { ExtensionAPI, BeforeAgentStartEvent } from "@aexol/spectral";
+ *
+ * export default function activate(ext: ExtensionAPI): void {
+ *   ext.on("before_agent_start", (event, ctx) => {
+ *     // inspect or modify the system prompt
+ *     return { systemPrompt: event.systemPrompt + "\nExtra instructions..." };
+ *   });
+ * }
+ * ```
+ */
+export type { ExtensionAPI, ToolDefinition } from "./sdk/coding-agent/index.js";
+export type { AfterProviderResponseEvent, AgentEndEvent, AgentStartEvent, BashToolCallEvent, BashToolResultEvent, BeforeAgentStartEvent, BeforeProviderRequestEvent, ContextEvent, CustomToolCallEvent, CustomToolResultEvent, EditToolCallEvent, EditToolResultEvent, ExtensionEvent, FindToolCallEvent, FindToolResultEvent, GrepToolCallEvent, GrepToolResultEvent, InputEvent, LsToolCallEvent, LsToolResultEvent, MessageEndEvent, MessageStartEvent, MessageUpdateEvent, ModelSelectEvent, ReadToolCallEvent, ReadToolResultEvent, ResourcesDiscoverEvent, SessionBeforeCompactEvent, SessionBeforeForkEvent, SessionBeforeSwitchEvent, SessionBeforeTreeEvent, SessionCompactEvent, SessionEvent, SessionShutdownEvent, SessionStartEvent, SessionTreeEvent, ToolCallEvent, ToolExecutionEndEvent, ToolExecutionStartEvent, ToolExecutionUpdateEvent, ToolResultEvent, TurnEndEvent, TurnStartEvent, UserBashEvent, WriteToolCallEvent, WriteToolResultEvent, } from "./sdk/coding-agent/index.js";
+export type { BeforeAgentStartEventResult, BeforeProviderRequestEventResult, ContextEventResult, InputEventResult, ResourcesDiscoverResult, SessionBeforeCompactResult, SessionBeforeForkResult, SessionBeforeSwitchResult, SessionBeforeTreeResult, ToolCallEventResult, UserBashEventResult, } from "./sdk/coding-agent/index.js";
+export type { ExtensionCommandContext, ExtensionContext, ReplacedSessionContext, } from "./sdk/coding-agent/index.js";
+export type { ProviderConfig, ProviderModelConfig, } from "./sdk/coding-agent/index.js";
+export { defineTool } from "./sdk/coding-agent/index.js";
+export { isBashToolResult, isEditToolResult, isFindToolResult, isGrepToolResult, isLsToolResult, isReadToolResult, isToolCallEventType, isWriteToolResult, } from "./sdk/coding-agent/index.js";
+export type { AgentToolResult, AgentToolUpdateCallback, BuildSystemPromptOptions, CompactOptions, ExecOptions, ExecResult, InputSource, ToolExecutionMode, } from "./sdk/coding-agent/index.js";
+export type { Extension, ExtensionActions, ExtensionError, ExtensionFactory, ExtensionFlag, ExtensionHandler, ExtensionRuntime, ExtensionShortcut, ExtensionUIContext, LoadExtensionsResult, RegisteredCommand, RegisteredTool, ResolvedCommand, ToolInfo, } from "./sdk/coding-agent/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAMH,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAMhF,YAAY,EACV,0BAA0B,EAC1B,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAMrC,YAAY,EACV,2BAA2B,EAC3B,gCAAgC,EAChC,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAMrC,YAAY,EACV,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AAMrC,YAAY,EACV,cAAc,EACd,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAMzD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AAMrC,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,EACX,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AAMrC,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,QAAQ,GACT,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,44 @@
+/**
+ * @aexol/spectral — Public API for extension authors.
+ *
+ * Import types and utilities from this package when writing .spectral extensions.
+ *
+ * ## Quick Start
+ *
+ * ```ts
+ * import type { ExtensionAPI, ToolDefinition } from "@aexol/spectral";
+ *
+ * export default function activate(ext: ExtensionAPI): void {
+ *   ext.registerTool({
+ *     name: "my_tool",
+ *     label: "My Tool",
+ *     description: "Does something useful.",
+ *     parameters: { type: "object", properties: {}, additionalProperties: false },
+ *     async execute(_id, params) {
+ *       return { content: [{ type: "text", text: "Done!" }], details: {} };
+ *     },
+ *   });
+ * }
+ * ```
+ *
+ * ## Event Handling
+ *
+ * ```ts
+ * import type { ExtensionAPI, BeforeAgentStartEvent } from "@aexol/spectral";
+ *
+ * export default function activate(ext: ExtensionAPI): void {
+ *   ext.on("before_agent_start", (event, ctx) => {
+ *     // inspect or modify the system prompt
+ *     return { systemPrompt: event.systemPrompt + "\nExtra instructions..." };
+ *   });
+ * }
+ * ```
+ */
+// ---------------------------------------------------------------------------
+// Tool definition helpers.
+// ---------------------------------------------------------------------------
+export { defineTool } from "./sdk/coding-agent/index.js";
+// ---------------------------------------------------------------------------
+// Type guards for tool result events.
+// ---------------------------------------------------------------------------
+export { isBashToolResult, isEditToolResult, isFindToolResult, isGrepToolResult, isLsToolResult, isReadToolResult, isToolCallEventType, isWriteToolResult, } from "./sdk/coding-agent/index.js";

package/dist/mcp/agent-dir.d.ts

@@ -0,0 +1,3 @@
+export declare function getAgentDir(): string;
+export declare function getAgentPath(...segments: string[]): string;
+//# sourceMappingURL=agent-dir.d.ts.map

package/dist/mcp/agent-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-dir.d.ts","sourceRoot":"","sources":["../../src/mcp/agent-dir.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,IAAI,MAAM,CAYpC;AAED,wBAAgB,YAAY,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAE1D"}

package/dist/mcp/commands.d.ts

@@ -0,0 +1,9 @@
+import type { ExtensionAPI, ExtensionContext } from "../sdk/coding-agent/index.js";
+import type { McpExtensionState } from "./state.js";
+import type { McpConfig } from "./types.js";
+export declare function showStatus(state: McpExtensionState, ctx: ExtensionContext): Promise<void>;
+export declare function showTools(state: McpExtensionState, ctx: ExtensionContext): Promise<void>;
+export declare function reconnectServers(state: McpExtensionState, ctx: ExtensionContext, targetServer?: string): Promise<void>;
+export declare function authenticateServer(serverName: string, config: McpConfig, ctx: ExtensionContext): Promise<void>;
+export declare function showSetupStatus(state: McpExtensionState, ext: ExtensionAPI, ctx: ExtensionContext, configOverridePath?: string): Promise<void>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/mcp/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/mcp/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AASzD,wBAAsB,UAAU,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsC/F;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB9F;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,gBAAgB,EACrB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAiDf;AAED,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBpJ"}

package/dist/mcp/commands.js

@@ -131,7 +131,7 @@ export async function authenticateServer(serverName, config, ctx) {
         ctx.ui.notify(`Failed to authenticate "${serverName}": ${message}`, "error");
     }
 }
-export async function showSetupStatus(state, pi, ctx, configOverridePath) {
+export async function showSetupStatus(state, ext, ctx, configOverridePath) {
     // Show MCP status first, then check for shared-config discovery hints
     await showStatus(state, ctx);
     if (!ctx.hasUI)

package/dist/mcp/config.d.ts

@@ -0,0 +1,78 @@
+import type { McpConfig, ServerEntry, ImportKind, ServerProvenance } from "./types.js";
+interface ConfigSourceSpec {
+    id: "shared-global" | "spectral-global" | "shared-project" | "spectral-project";
+    label: string;
+    readPath: string;
+    writePath: string;
+    kind: "user" | "project" | "import";
+    importKind?: string;
+    shared: boolean;
+    scope: "global" | "project";
+}
+export interface ConfigDiscoveryPath {
+    label: string;
+    path: string;
+    exists: boolean;
+}
+export interface DiscoveredImportConfig {
+    kind: ImportKind;
+    path: string;
+}
+export interface ConfigDiscoverySource extends ConfigDiscoveryPath {
+    id: ConfigSourceSpec["id"];
+    scope: ConfigSourceSpec["scope"];
+    kind: "shared" | "spectral";
+    serverCount: number;
+}
+export interface ImportConfigSummary extends DiscoveredImportConfig {
+    serverCount: number;
+}
+export interface RepoPromptDiscovery {
+    configured: boolean;
+    configuredPath?: string;
+    executablePath?: string;
+    targetPath?: string;
+    serverName?: string;
+    entry?: ServerEntry;
+}
+export interface McpDiscoverySummary {
+    sources: ConfigDiscoverySource[];
+    imports: ImportConfigSummary[];
+    hasAnyConfig: boolean;
+    hasAnyDetectedPaths: boolean;
+    hasSharedServers: boolean;
+    hasSpectralOwnedServers: boolean;
+    totalServerCount: number;
+    fingerprint: string;
+    repoPrompt: RepoPromptDiscovery;
+}
+export interface ConfigWritePreview {
+    path: string;
+    existed: boolean;
+    changed: boolean;
+    beforeText: string;
+    afterText: string;
+    diffText: string;
+}
+export declare function getSpectralGlobalConfigPath(overridePath?: string): string;
+export declare function getGenericGlobalConfigPath(): string;
+export declare function getProjectConfigPath(cwd?: string): string;
+export declare function getProjectSpectralConfigPath(cwd?: string): string;
+export declare function getConfigDiscoveryPaths(overridePath?: string): ConfigDiscoveryPath[];
+export declare function findAvailableImportConfigs(cwd?: string): DiscoveredImportConfig[];
+export declare function getMcpDiscoverySummary(overridePath?: string, cwd?: string): McpDiscoverySummary;
+export declare function loadMcpConfig(overridePath?: string): McpConfig;
+export declare function previewCompatibilityImports(importKinds: ImportKind[], overridePath?: string): ConfigWritePreview;
+export declare function ensureCompatibilityImports(importKinds: ImportKind[], overridePath?: string): {
+    path: string;
+    added: ImportKind[];
+};
+export declare function buildStarterProjectConfig(): McpConfig;
+export declare function previewStarterProjectConfig(cwd?: string): ConfigWritePreview;
+export declare function writeStarterProjectConfig(cwd?: string): string;
+export declare function previewSharedServerEntry(filePath: string, serverName: string, entry: ServerEntry): ConfigWritePreview;
+export declare function writeSharedServerEntry(filePath: string, serverName: string, entry: ServerEntry): string;
+export declare function getServerProvenance(overridePath?: string): Map<string, ServerProvenance>;
+export declare function writeDirectToolsConfig(changes: Map<string, true | string[] | false>, provenance: Map<string, ServerProvenance>, fullConfig: McpConfig): void;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/mcp/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/mcp/config.ts"],"names":[],"mappings":"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"}

package/dist/mcp/config.js

@@ -22,7 +22,7 @@ const IMPORT_PATHS = {
     windsurf: [join(homedir(), ".windsurf", "mcp.json")],
     vscode: [".vscode/mcp.json"],
 };
-export function getPiGlobalConfigPath(overridePath) {
+export function getSpectralGlobalConfigPath(overridePath) {
     return overridePath ? resolve(overridePath) : getAgentPath("mcp.json");
 }
 export function getGenericGlobalConfigPath() {
@@ -31,7 +31,7 @@ export function getGenericGlobalConfigPath() {
 export function getProjectConfigPath(cwd = process.cwd()) {
     return resolve(cwd, PROJECT_CONFIG_NAME);
 }
-export function getProjectPiConfigPath(cwd = process.cwd()) {
+export function getProjectSpectralConfigPath(cwd = process.cwd()) {
     return resolve(cwd, PROJECT_MCP_CONFIG_NAME);
 }
 export function getConfigDiscoveryPaths(overridePath) {
@@ -60,7 +60,7 @@ export function getMcpDiscoverySummary(overridePath, cwd = process.cwd()) {
             path: source.readPath,
             exists: existsSync(source.readPath),
             scope: source.scope,
-            kind: source.shared ? "shared" : "pi",
+            kind: source.shared ? "shared" : "spectral",
             serverCount: loaded ? Object.keys(loaded.mcpServers).length : 0,
         };
     });
@@ -78,7 +78,7 @@ export function getMcpDiscoverySummary(overridePath, cwd = process.cwd()) {
         .filter((value) => value !== null);
     const totalServerCount = sources.reduce((sum, source) => sum + source.serverCount, 0);
     const hasSharedServers = sources.some((source) => source.kind === "shared" && source.serverCount > 0);
-    const hasPiOwnedServers = sources.some((source) => source.kind === "pi" && source.serverCount > 0);
+    const hasSpectralOwnedServers = sources.some((source) => source.kind === "spectral" && source.serverCount > 0);
     const hasAnyDetectedPaths = sources.some((source) => source.exists) || imports.length > 0;
     const hasAnyConfig = totalServerCount > 0 || imports.some((entry) => entry.serverCount > 0) || hasAnyDetectedPaths;
     const summaryWithoutRepoPrompt = {
@@ -87,7 +87,7 @@ export function getMcpDiscoverySummary(overridePath, cwd = process.cwd()) {
         hasAnyConfig,
         hasAnyDetectedPaths,
         hasSharedServers,
-        hasPiOwnedServers,
+        hasSpectralOwnedServers,
         totalServerCount,
     };
     const fingerprint = JSON.stringify({
@@ -111,9 +111,9 @@ export function loadMcpConfig(overridePath) {
     return config;
 }
 function getConfigSources(overridePath, cwd = process.cwd()) {
-    const userPath = getPiGlobalConfigPath(overridePath);
+    const userPath = getSpectralGlobalConfigPath(overridePath);
     const projectPath = getProjectConfigPath(cwd);
-    const projectPiPath = getProjectPiConfigPath(cwd);
+    const projectSpectralPath = getProjectSpectralConfigPath(cwd);
     const sources = [];
     if (GENERIC_GLOBAL_CONFIG_PATH !== userPath) {
         sources.push({
@@ -128,7 +128,7 @@ function getConfigSources(overridePath, cwd = process.cwd()) {
         });
     }
     sources.push({
-        id: "pi-global",
+        id: "spectral-global",
         label: "Pi global override",
         readPath: userPath,
         writePath: userPath,
@@ -147,12 +147,12 @@ function getConfigSources(overridePath, cwd = process.cwd()) {
             scope: "project",
         });
     }
-    if (projectPiPath !== userPath && projectPiPath !== projectPath) {
+    if (projectSpectralPath !== userPath && projectSpectralPath !== projectPath) {
         sources.push({
-            id: "pi-project",
+            id: "spectral-project",
             label: "project Pi override",
-            readPath: projectPiPath,
-            writePath: projectPiPath,
+            readPath: projectSpectralPath,
+            writePath: projectSpectralPath,
             kind: "project",
             shared: false,
             scope: "project",
@@ -412,7 +412,7 @@ function detectRepoPrompt(summary, cwd = process.cwd()) {
     };
 }
 export function previewCompatibilityImports(importKinds, overridePath) {
-    const targetPath = getPiGlobalConfigPath(overridePath);
+    const targetPath = getSpectralGlobalConfigPath(overridePath);
     const raw = readRawConfigObject(targetPath);
     const currentImports = Array.isArray(raw.imports) ? raw.imports.filter((value) => typeof value === "string") : [];
     const merged = [...new Set([...currentImports, ...importKinds])];
@@ -421,7 +421,7 @@ export function previewCompatibilityImports(importKinds, overridePath) {
     return buildConfigWritePreview(targetPath, nextRaw);
 }
 export function ensureCompatibilityImports(importKinds, overridePath) {
-    const targetPath = getPiGlobalConfigPath(overridePath);
+    const targetPath = getSpectralGlobalConfigPath(overridePath);
     const raw = readRawConfigObject(targetPath);
     const currentImports = Array.isArray(raw.imports) ? raw.imports.filter((value) => typeof value === "string") : [];
     const merged = [...new Set([...currentImports, ...importKinds])];
@@ -469,7 +469,7 @@ export function writeSharedServerEntry(filePath, serverName, entry) {
 }
 export function getServerProvenance(overridePath) {
     const provenance = new Map();
-    const userPath = getPiGlobalConfigPath(overridePath);
+    const userPath = getSpectralGlobalConfigPath(overridePath);
     for (const source of getConfigSources(overridePath)) {
         const loaded = readValidatedConfig(source.readPath, `MCP config from ${source.readPath}`);
         if (!loaded)