aai-gateway 1.1.1 → 1.1.3

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as createGatewayServer } from "./server-BNj-vVwq.js";
+import { n as createGatewayServer } from "./server-W20IjmvB.js";
 import { o as AAI_GATEWAY_VERSION, s as logger } from "./acp-DWqg7EhR.js";
 //#region src/cli.ts
 async function main() {

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as GuideService, c as getSkillExecutor, d as getMcpExecutor, i as ImportService, l as AppRegistry, n as createGatewayServer, o as ExecutionCoordinator, r as Gateway, s as SkillExecutor, t as AaiGatewayServer, u as McpExecutor } from "./server-BNj-vVwq.js";
+import { a as GuideService, c as getSkillExecutor, d as getMcpExecutor, i as ImportService, l as AppRegistry, n as createGatewayServer, o as ExecutionCoordinator, r as Gateway, s as SkillExecutor, t as AaiGatewayServer, u as McpExecutor } from "./server-W20IjmvB.js";
 import { t as AaiError } from "./errors-C3N_hrpx.js";
 import { n as getAcpExecutor, s as logger, t as AcpExecutor } from "./acp-DWqg7EhR.js";
 import { a as FileRegistry, c as parseAaiJson } from "./mcp-registry-CuVFEyIP.js";

package/dist/{server-BNj-vVwq.js → server-W20IjmvB.js}

@@ -1116,6 +1116,16 @@ For Skill candidates, also collect:
 - Whether the whole skill directory must be downloaded
 - The source page that shows the download path or repository path
 
+## How to Search Efficiently
+
+Web pages like GitHub repositories and registry listings can be very large. Use these strategies to save tokens:
+
+1. **Small pages**: Read directly if the page is short.
+2. **Large pages with grep support**: If your web/fetch tool supports content filtering (e.g. grep, query, selector), use it to extract only the relevant sections (install config, package name, command examples).
+3. **Large pages without grep support**: Fetch the page to a temporary file, then use shell \`grep\` to search for relevant keywords.
+4. **GitHub repos**: Prefer reading \`README.md\` raw content directly. For registry repos with many entries, grep for the tool name or category instead of reading the full file list.
+5. **Expand keywords before searching**: Don't rely on a single keyword. Think of synonyms, related terms, and alternative names. For example, when searching for a "web search" tool, also try "search engine", "google", "bing", "brave", "websearch", "web-search", etc. This avoids missing results due to naming variations.
+
 ## How to Evaluate Candidates
 
 When comparing candidates, consider:
@@ -1406,7 +1416,7 @@ function buildGatewayToolDefinitions() {
 	return [
 		{
 			name: "aai:exec",
-			description: "Execute a tool. Read the guide first (e.g. app:*, mcp:import) — it contains the full schema.",
+			description: "Execute any AAI tool action. Read the guide first (call app:*, mcp:import, skill:import, or search:discover) — it contains the required schema and parameters.",
 			inputSchema: {
 				type: "object",
 				properties: {
@@ -1429,7 +1439,7 @@ function buildGatewayToolDefinitions() {
 		},
 		{
 			name: "mcp:import",
-			description: "Call this to import an MCP server. Returns the import workflow and parameters.",
+			description: "Import an MCP server as a new app. Call this first to get the import guide, then use aai:exec to perform the import.",
 			inputSchema: {
 				type: "object",
 				properties: {
@@ -1520,7 +1530,7 @@ function buildGatewayToolDefinitions() {
 		},
 		{
 			name: "skill:import",
-			description: "Call this to import a skill. Returns the import workflow and parameters.",
+			description: "Import a local skill as a new app. Call this first to get the import guide, then use aai:exec to perform the import.",
 			inputSchema: {
 				type: "object",
 				properties: { path: {
@@ -1533,7 +1543,7 @@ function buildGatewayToolDefinitions() {
 		},
 		{
 			name: "listAllAaiApps",
-			description: "List all apps available to the current agent, excluding AAI Gateway built-in management tools.",
+			description: "List imported apps (MCP servers and skills) for the current agent. This does not include built-in tools like search:discover, mcp:import, or skill:import — those are always available.",
 			inputSchema: {
 				type: "object",
 				properties: {},
@@ -1584,7 +1594,7 @@ function buildGatewayToolDefinitions() {
 		},
 		{
 			name: SEARCH_DISCOVER_TOOL_NAME,
-			description: "Call this to search for MCP servers or skills. Returns search instructions.",
+			description: "Find and install new tools. Call this when the user wants to search for, discover, or add MCP servers or skills.",
 			inputSchema: searchDiscoverInputSchema,
 			listInputSchema: buildGuideOnlyInputSchema()
 		}
@@ -2931,6 +2941,8 @@ var Gateway = class {
 		if (toolName === "disableApp") return this.handleDisableApp(args, caller);
 		if (toolName === "enableApp") return this.handleEnableApp(args, caller);
 		if (toolName === "removeApp") return this.handleRemoveApp(args, caller);
+		if (toolName === "mcp:import") return this.handleMcpImport(parseMcpImportArguments(args), args, caller);
+		if (toolName === "skill:import") return this.handleSkillImport(parseSkillImportArguments(args), args, caller);
 		throw new AaiError("UNKNOWN_TOOL", `Unknown tool: ${toolName}`);
 	}
 	async resolveManagedApp(appId, caller) {
@@ -3062,6 +3074,13 @@ function buildMissingEnvVarsResult(err) {
 * Thin protocol layer — handles MCP request/response serialization
 * and delegates all business logic to Gateway (core/gateway.ts).
 */
+var TOOLS_CHANGING_OPERATIONS = new Set([
+	"mcp:import",
+	"skill:import",
+	"disableApp",
+	"enableApp",
+	"removeApp"
+]);
 var AaiGatewayServer = class {
 	server;
 	gateway = new Gateway();
@@ -3101,24 +3120,11 @@ var AaiGatewayServer = class {
 			if (name.startsWith("app:")) return this.toCallToolResult(await this.gateway.handleAppGuide(name.slice(4), caller));
 			if (name === "aai:exec") {
 				const payload = args;
-				return this.toCallToolResult(await this.gateway.handleExec(extra.requestId, payload.app, payload.tool, payload.args ?? {}, caller));
-			}
-			if (name === "mcp:import") {
-				const rawMap = args;
-				if (!rawMap || Object.keys(rawMap).length === 0) return this.toCallToolResult(this.gateway.handleGatewayToolGuide(name));
-				const parsed = parseMcpImportArguments(rawMap);
-				const result = await this.gateway.handleMcpImport(parsed, rawMap, caller);
-				if (!result.isError) await this.notifyToolsListChanged();
-				return this.toCallToolResult(result);
-			}
-			if (name === "skill:import") {
-				const rawMap = args;
-				if (!rawMap || Object.keys(rawMap).length === 0) return this.toCallToolResult(this.gateway.handleGatewayToolGuide(name));
-				const parsed = parseSkillImportArguments(rawMap);
-				const result = await this.gateway.handleSkillImport(parsed, rawMap, caller);
-				if (!result.isError) await this.notifyToolsListChanged();
+				const result = await this.gateway.handleExec(extra.requestId, payload.app, payload.tool, payload.args ?? {}, caller);
+				if (TOOLS_CHANGING_OPERATIONS.has(payload.tool) && !result.isError) await this.notifyToolsListChanged();
 				return this.toCallToolResult(result);
 			}
+			if (name === "mcp:import" || name === "skill:import") return this.toCallToolResult(this.gateway.handleGatewayToolGuide(name));
 			if (name === "search:discover" || name === "listAllAaiApps" || name === "disableApp" || name === "enableApp" || name === "removeApp") {
 				const toolArgs = args ?? {};
 				let result;
@@ -3182,4 +3188,4 @@ async function createGatewayServer() {
 //#endregion
 export { GuideService as a, getSkillExecutor as c, getMcpExecutor as d, ImportService as i, AppRegistry as l, createGatewayServer as n, ExecutionCoordinator as o, Gateway as r, SkillExecutor as s, AaiGatewayServer as t, McpExecutor as u };
 
-//# sourceMappingURL=server-BNj-vVwq.js.map
+//# sourceMappingURL=server-W20IjmvB.js.map