Bugfix/project base model required (#429)

* added base models required for projects

* updated changeset

* updated tests

* updated quickstart

Author: tim-inkeep

.changeset/wise-signs-behave.md

@@ -0,0 +1,7 @@
+---
+"@inkeep/create-agents": patch
+"@inkeep/agents-core": patch
+"@inkeep/agents-manage-api": patch
+---
+
+updated base model

agents-manage-api/src/__tests__/routes/crud/projectFull.test.ts

@@ -131,6 +131,12 @@ describe('Project Full CRUD Routes - Integration Tests', () => {
         id: projectId,
         name: 'Minimal Project',
         description: 'Minimal test project',
+        models: {
+          base: {
+            model: 'claude-sonnet-4',
+            providerOptions: {},
+          },
+        },
         graphs: {},
         tools: {}, // Required field
       };

agents-manage-api/src/__tests__/routes/crud/projects.test.ts

@@ -12,6 +12,12 @@ describe('Project CRUD Routes - Integration Tests', () => {
     id: `test-project${suffix.toLowerCase().replace(/\s+/g, '-')}-${nanoid(6)}`,
     name: `Test Project${suffix}`,
     description: `Test Description${suffix}`,
+    models: {
+      base: {
+        model: 'claude-sonnet-4',
+        providerOptions: {},
+      },
+    },
   });
 
   // Helper function to create a project and return its ID
@@ -307,6 +313,12 @@ describe('Project CRUD Routes - Integration Tests', () => {
         body: JSON.stringify({
           id: 'test-id',
           description: 'Test description',
+          models: {
+            base: {
+              model: 'claude-sonnet-4',
+              providerOptions: {},
+            },
+          },
         }),
       });
       expect(res1.status).toBe(400);
@@ -317,6 +329,12 @@ describe('Project CRUD Routes - Integration Tests', () => {
         body: JSON.stringify({
           id: 'test-id',
           name: 'Test name',
+          models: {
+            base: {
+              model: 'claude-sonnet-4',
+              providerOptions: {},
+            },
+          },
         }),
       });
       expect(res2.status).toBe(400);
@@ -327,9 +345,43 @@ describe('Project CRUD Routes - Integration Tests', () => {
         body: JSON.stringify({
           name: 'Test name',
           description: 'Test description',
+          models: {
+            base: {
+              model: 'claude-sonnet-4',
+              providerOptions: {},
+            },
+          },
         }),
       });
       expect(res3.status).toBe(400);
+
+      // Missing models
+      const res4 = await makeRequest(`/tenants/${tenantId}/projects`, {
+        method: 'POST',
+        body: JSON.stringify({
+          id: 'test-id',
+          name: 'Test name',
+          description: 'Test description',
+        }),
+      });
+      expect(res4.status).toBe(400);
+
+      // Missing base model within models
+      const res5 = await makeRequest(`/tenants/${tenantId}/projects`, {
+        method: 'POST',
+        body: JSON.stringify({
+          id: 'test-id',
+          name: 'Test name',
+          description: 'Test description',
+          models: {
+            structuredOutput: {
+              model: 'claude-sonnet-4',
+              providerOptions: {},
+            },
+          },
+        }),
+      });
+      expect(res5.status).toBe(400);
     });
   });
 

packages/agents-core/src/__tests__/data-access/projectFull.test.ts

@@ -129,6 +129,12 @@ describe('projectFull data access', () => {
         id: projectId,
         name: 'Minimal Project',
         description: '',
+        models: {
+          base: {
+            model: 'claude-sonnet-4',
+            providerOptions: {},
+          },
+        },
         graphs: {},
         tools: {},
         createdAt: new Date().toISOString(),

packages/agents-core/src/__tests__/data-access/projects.test.ts

@@ -611,6 +611,12 @@ describe('Projects Data Access', () => {
         id: testProjectId1,
         name: 'New Project',
         description: 'A new test project',
+        models: {
+          base: {
+            model: 'claude-sonnet-4',
+            providerOptions: {},
+          },
+        },
       };
 
       const expectedProject = {

packages/agents-core/src/__tests__/integration/data-access/tools.test.ts

@@ -25,6 +25,12 @@ const createProjectData = ({ suffix = '' }: { suffix?: string } = {}) => {
     id: `test-project-${suffix}-${timestamp}-${randomId}`,
     name: `Test Project ${suffix}`,
     description: `Test project ${suffix} for tools integration tests`,
+    models: {
+      base: {
+        model: 'claude-sonnet-4',
+        providerOptions: {},
+      },
+    },
   };
 };
 

packages/agents-core/src/__tests__/validation/fullProjectSchema.test.ts

@@ -6,6 +6,12 @@ describe('FullProjectDefinitionSchema', () => {
     id: 'test-project',
     name: 'Test Project',
     description: 'A test project for validation',
+    models: {
+      base: {
+        model: 'claude-sonnet-4',
+        providerOptions: {},
+      },
+    },
     stopWhen: {
       transferCountIs: 10,
       stepCountIs: 50,
@@ -55,6 +61,12 @@ describe('FullProjectDefinitionSchema', () => {
       id: 'minimal-project',
       name: 'Minimal Project',
       description: '',
+      models: {
+        base: {
+          model: 'claude-sonnet-4',
+          providerOptions: {},
+        },
+      },
       graphs: {},
       tools: {},
     };
@@ -63,7 +75,7 @@ describe('FullProjectDefinitionSchema', () => {
     expect(result.success).toBe(true);
   });
 
-  it('should require id, name, graphs, and tools fields', () => {
+  it('should require id, name, models, graphs, and tools fields', () => {
     const invalidProject = {
       description: 'Missing required fields',
     };
@@ -75,6 +87,7 @@ describe('FullProjectDefinitionSchema', () => {
         expect.arrayContaining([
           expect.objectContaining({ path: ['id'] }),
           expect.objectContaining({ path: ['name'] }),
+          expect.objectContaining({ path: ['models'] }),
           expect.objectContaining({ path: ['graphs'] }),
           expect.objectContaining({ path: ['tools'] }),
         ])
@@ -125,6 +138,12 @@ describe('FullProjectDefinitionSchema', () => {
       id: 'test-project',
       name: 'Test Project',
       description: 'A test project',
+      models: {
+        base: {
+          model: 'claude-sonnet-4',
+          providerOptions: {},
+        },
+      },
       graphs: {},
       tools: {},
       // credentialReferences omitted

packages/agents-core/src/data-access/projectFull.ts

@@ -976,11 +976,18 @@ export const getFullProject =
         await Promise.all(graphPromises);
       }
 
+      // Ensure project has required models configuration
+      if (!project.models) {
+        throw new Error(
+          `Project ${project.id} is missing required models configuration. Please update the project to include a base model.`
+        );
+      }
+
       const fullProjectDefinition: FullProjectDefinition = {
         id: project.id,
         name: project.name,
         description: project.description,
-        models: project.models || undefined,
+        models: project.models,
         stopWhen: project.stopWhen || undefined,
         graphs,
         tools: projectTools,

packages/agents-core/src/validation/schemas.ts

@@ -709,7 +709,7 @@ export const RemovedResponseSchema = z.object({
 export const ProjectSelectSchema = createSelectSchema(projects);
 export const ProjectInsertSchema = createInsertSchema(projects)
   .extend({
-    models: ProjectModelSchema.optional(),
+    models: ProjectModelSchema,
     stopWhen: StopWhenSchema.optional(),
   })
   .omit({

packages/create-agents/src/utils.ts

@@ -37,10 +37,10 @@ export const defaultAnthropicModelConfigurations = {
     model: 'anthropic/claude-sonnet-4-20250514',
   },
   structuredOutput: {
-    model: 'anthropic/claude-3-5-haiku-20241022',
+    model: 'anthropic/claude-sonnet-4-20250514',
   },
   summarizer: {
-    model: 'anthropic/claude-3-5-haiku-20241022',
+    model: 'anthropic/claude-sonnet-4-20250514',
   },
 };
 
@@ -126,7 +126,7 @@ export const createAgents = async (
   // Project ID is already determined above based on template/customProjectId logic
 
   // If keys aren't provided via CLI args, prompt for provider selection and keys
-  if (!anthropicKey && !openAiKey) {
+  if (!anthropicKey && !openAiKey && !googleKey) {
     const providerChoice = await p.select({
       message: 'Which AI provider would you like to use?',
       options: [
@@ -205,6 +205,12 @@ export const createAgents = async (
     defaultModelSettings = defaultGoogleModelConfigurations;
   }
 
+  // Ensure models are always configured - fail if none were set
+  if (Object.keys(defaultModelSettings).length === 0) {
+    p.cancel('Cannot continue without a model configuration for project. Please provide an API key for at least one AI provider.');
+    process.exit(1);
+  }
+
   const s = p.spinner();
   s.start('Creating directory structure...');