@amitdeshmukh/ax-crew 8.1.0 → 8.3.0

package/.claude/settings.local.json

@@ -2,7 +2,10 @@
   "permissions": {
     "allow": [
       "Bash(npm test:*)",
-      "Bash(git push:*)"
+      "Bash(git push:*)",
+      "Bash(git status:*)",
+      "Bash(node:*)",
+      "Bash(npm version:*)"
     ]
   }
 }

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/README.md

@@ -50,7 +50,7 @@ const config = {
   crew: [{
     name: "Planner",
     description: "Creates a plan to complete a task",
-    executionMode: "axagent", // "axagent" | "axgen"
+    executionMode: "axgen", // "axagent" | "axgen"
     signature: "task:string \"a task to be completed\" -> plan:string \"a plan to execute the task\"",
     provider: "google-gemini",
     providerKeyName: "GEMINI_API_KEY",
@@ -127,7 +127,7 @@ Key TypeScript features:
 - **Functions (tools)**: Register callable functions via a registry and reference by name in agent `functions`.
 - **State**: `crew.state.set/get/getAll()` shared across all agents.
 - **Persona**: Use `definition` (preferred) or `prompt` to set the system program. If both are present, `definition` wins.
-- **Execution mode**: Set `executionMode` to `axagent` (default) or `axgen` per agent.
+- **Execution mode**: Set `executionMode` to `axgen` (default) or `axagent` per agent.
 - **Streaming**: Use `streamingForward()` for token streams.
 - **Metrics**: Per‑agent `getMetrics()` + crew‑level `getCrewMetrics()` snapshots.
 
@@ -190,8 +190,8 @@ Add either field to any agent config. The chosen value becomes the Ax agent's un
 
 Each agent can run in one of two execution modes supported by AxLLM:
 
-- `axagent` (default): Uses AxAgent capabilities.
-- `axgen`: Uses AxGen capabilities.
+- `axgen` (default): Uses AxGen capabilities.
+- `axagent`: Uses AxAgent capabilities.
 
 Set mode in config:
 

package/dist/agents/agentConfig.js

@@ -174,7 +174,7 @@ const parseAgentConfig = async (agentName, crewConfig, functions, state, options
             // Add MCP functions to functions
             ...mcpFunctions
         ];
-        const executionMode = agentConfigData.executionMode === 'axgen' ? 'axgen' : 'axagent';
+        const executionMode = agentConfigData.executionMode === 'axagent' ? 'axagent' : 'axgen';
         // Return AI instance and Agent parameters
         return {
             ai: aiInstance,

package/dist/agents/index.js

@@ -88,11 +88,22 @@ class StatefulAxAgent extends AxAgent {
         this.axai = ai;
         this.agentName = options.name;
         this.agentDefinition = effectiveDefinition;
-        this.executionMode = options.executionMode ?? "axagent";
+        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.1.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/agentConfig.ts

@@ -208,7 +208,7 @@ const parseAgentConfig = async (
     ];
 
     const executionMode: AgentExecutionMode =
-      agentConfigData.executionMode === 'axgen' ? 'axgen' : 'axagent';
+      agentConfigData.executionMode === 'axagent' ? 'axagent' : 'axgen';
     
     // Return AI instance and Agent parameters
     return {

package/src/agents/index.ts

@@ -161,11 +161,19 @@ class StatefulAxAgent extends AxAgent<any, any> {
     this.axai = ai;
     this.agentName = options.name;
     this.agentDefinition = effectiveDefinition;
-    this.executionMode = options.executionMode ?? "axagent";
+    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) {