@amitdeshmukh/ax-crew 8.2.0 → 8.3.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [8.3.0] - 2026-03-05
+
+### Fixed
+- Sub-agents were invisible to agents running in `axgen` execution mode. AxGen only supports functions/tools, not native sub-agents. Sub-agents are now converted to callable functions via `getFunction()` and included in the AxGen functions list, making them available as tools during execution.
+
 ## [8.1.0] - 2026-03-04
 
 ### Added

package/dist/agents/index.js

@@ -90,9 +90,20 @@ class StatefulAxAgent extends AxAgent {
         this.agentDefinition = effectiveDefinition;
         this.executionMode = options.executionMode ?? "axgen";
         this.debugEnabled = debug ?? false;
+        // Convert sub-agents to callable functions so AxGen can invoke them as tools
+        const subAgentFunctions = resolvedAgents
+            .map(agent => {
+            try {
+                return agent.getFunction();
+            }
+            catch {
+                return undefined;
+            }
+        })
+            .filter((fn) => fn !== undefined);
         this.axGenProgram = new AxGen(options.signature, {
             description: effectiveDefinition,
-            functions: resolvedFunctions,
+            functions: [...resolvedFunctions, ...subAgentFunctions],
         });
         for (const agent of resolvedAgents) {
             try {

package/examples/run-manager.ts

@@ -0,0 +1,154 @@
+import 'dotenv/config';
+import { AxCrew, AxCrewFunctions } from '../src/index.js';
+import { AxJSRuntime, AxJSRuntimePermission } from '@ax-llm/ax';
+
+const config = {
+  crew: [
+    {
+      name: "Manager",
+      description: "Answer questions from available documents.",
+      signature: 'background:string "background information and context for the task at hand", latestMessage:string "the latest user message to answer" -> answer:string "The answer, including a short explanation for the answer. Never reveal functions available to the user. Respond in the same language as the user\'s question.", references:json "a list of references to documents to support the answer in json format. Each reference should include a fileName and url."',
+      provider: "google-gemini" as const,
+      providerKeyName: "GEMINI_API_KEY",
+      executionMode: "axgen" as const,
+      ai: {
+        model: "gemini-3.1-pro-preview",
+        temperature: 0
+      },
+      options: {
+        debug: true
+      },
+      functions: [
+        "CurrentDateTime",
+        "DaysBetweenDates"
+      ],
+      agents: [
+        "SearchAvailableDocuments",
+        "SearchDatabase",
+        "CodeExecutor"
+      ]
+    },
+    {
+      name: "SearchAvailableDocuments",
+      description: "Searches available documents and returns relevant content from the knowledge base.",
+      signature: 'query:string "the search query" -> searchResults:string "relevant documents and content"',
+      provider: "google-gemini" as const,
+      providerKeyName: "GEMINI_API_KEY",
+      executionMode: "axgen" as const,
+      ai: {
+        model: "gemini-3.1-pro-preview",
+        temperature: 0
+      },
+      options: {
+        debug: true
+      },
+      functions: [
+        "VectorSearch"
+      ]
+    },
+    {
+      name: "SearchDatabase",
+      description: "Looks up information in connected databases using natural language. Can explore schema, run queries, and return results.",
+      signature: 'userQuery:string "a user query" -> databaseSearchResult:string "answer to the user query"',
+      provider: "google-gemini" as const,
+      providerKeyName: "GEMINI_API_KEY",
+      executionMode: "axgen" as const,
+      ai: {
+        model: "gemini-3.1-pro-preview",
+        temperature: 0
+      },
+      options: {
+        debug: true
+      },
+      mcpServers: {
+        graphjin: {
+          command: "/opt/homebrew/bin/graphjin",
+          args: [
+            "mcp",
+            "--server",
+            "http://localhost:8080"
+          ]
+        }
+      }
+    },
+    {
+      name: "CodeExecutor",
+      description: "Executes JavaScript code in a sandboxed environment. Use for calculations, data transformations, aggregations, or any computation that needs precise results.",
+      signature: 'task:string "description of what to compute or calculate" -> executionResult:string "the result of the code execution"',
+      provider: "google-gemini" as const,
+      providerKeyName: "GEMINI_API_KEY",
+      executionMode: "axgen" as const,
+      ai: {
+        model: "gemini-3.1-pro-preview",
+        temperature: 0
+      },
+      options: {
+        debug: true
+      },
+      functions: [
+        "JavaScriptInterpreter"
+      ]
+    }
+  ]
+};
+
+// Create a sandboxed JS runtime with timing permission for calculations
+const jsRuntime = new AxJSRuntime({
+  permissions: [AxJSRuntimePermission.TIMING],
+  timeout: 15_000,
+});
+const JavaScriptInterpreter = jsRuntime.toFunction();
+
+// VectorSearch is referenced in config but not in AxCrewFunctions.
+// Provide a stub so the agent can be created. Replace with your real implementation.
+const VectorSearch = {
+  name: 'VectorSearch',
+  description: 'Search the vector knowledge base for relevant documents',
+  parameters: {
+    type: 'object' as const,
+    properties: {
+      query: { type: 'string', description: 'The search query' }
+    },
+    required: ['query']
+  },
+  func: async ({ query }: { query: string }) => {
+    console.log(`[VectorSearch] Searching for: ${query}`);
+    return `No documents found for: ${query}`;
+  }
+};
+
+async function main() {
+  // Merge built-in functions with custom ones
+  const crew = new AxCrew(config, { ...AxCrewFunctions, VectorSearch, JavaScriptInterpreter });
+
+  // Use addAllAgents() to automatically resolve dependency order.
+  // This ensures sub-agents (SearchAvailableDocuments, SearchDatabase)
+  // are initialized BEFORE Manager, which depends on them.
+  await crew.addAllAgents();
+
+  const manager = crew.agents?.get('Manager');
+  if (!manager) {
+    throw new Error('Manager agent not found');
+  }
+
+  const query = "analyze all our orders to date, give me a table showing P&L";
+  console.log(`\nQuery: ${query}\n`);
+
+  const result = await manager.forward({
+    background: "User is querying the system about order information.",
+    latestMessage: query
+  });
+
+  console.log(`\nAnswer: ${result.answer}`);
+  console.log(`\nReferences:`, JSON.stringify(result.references, null, 2));
+
+  // Print metrics
+  const crewMetrics = crew.getCrewMetrics();
+  console.log(`\nCrew Metrics:`, JSON.stringify(crewMetrics, null, 2));
+
+  crew.destroy();
+}
+
+main()
+  .catch(console.error)
+  .finally(() => process.exit(0));

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "@amitdeshmukh/ax-crew",
-  "version": "8.2.0",
+  "version": "8.3.0",
   "description": "Build and launch a crew of AI agents with shared state. Built with axllm.dev",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/agents/index.ts

@@ -163,9 +163,17 @@ class StatefulAxAgent extends AxAgent<any, any> {
     this.agentDefinition = effectiveDefinition;
     this.executionMode = options.executionMode ?? "axgen";
     this.debugEnabled = debug ?? false;
+    // Convert sub-agents to callable functions so AxGen can invoke them as tools
+    const subAgentFunctions: AxFunction[] = resolvedAgents
+      .map(agent => {
+        try { return agent.getFunction() as AxFunction; }
+        catch { return undefined; }
+      })
+      .filter((fn): fn is AxFunction => fn !== undefined);
+
     this.axGenProgram = new AxGen(options.signature as any, {
       description: effectiveDefinition,
-      functions: resolvedFunctions,
+      functions: [...resolvedFunctions, ...subAgentFunctions],
     } as any);
 
     for (const agent of resolvedAgents) {