Agents mono api

.env.docker.example

@@ -26,8 +26,7 @@ SIGNOZ_API_KEY=
 # INKEEP_AGENTS_JWT_SIGNING_SECRET=
 
 # Uncomment and set these for the Manage UI at http://<vm_external_ip>:3000
-# PUBLIC_INKEEP_AGENTS_MANAGE_API_URL=http://<vm_external_ip>:3002
-# PUBLIC_INKEEP_AGENTS_RUN_API_URL=http://<vm_external_ip>:3003
+# PUBLIC_INKEEP_AGENTS_API_URL=http://<vm_external_ip>:3002
 # PUBLIC_INKEEP_AGENTS_RUN_API_BYPASS_SECRET=<copy INKEEP_AGENTS_RUN_API_BYPASS_SECRET>
 # PUBLIC_NANGO_SERVER_URL=http://<vm_external_ip>:3050
 # PUBLIC_NANGO_CONNECT_BASE_URL=http://<vm_external_ip>:3051

.env.example

@@ -26,12 +26,8 @@ INKEEP_AGENTS_RUN_DATABASE_URL=postgresql://appuser:password@localhost:5433/inke
 
 # ============ API ENDPOINTS ============
 # Management API (CRUD operations, configuration)
-INKEEP_AGENTS_MANAGE_API_URL=http://localhost:3002
-PUBLIC_INKEEP_AGENTS_MANAGE_API_URL=http://localhost:3002
-
-# Run API (chat completions, agent execution)
-INKEEP_AGENTS_RUN_API_URL=http://localhost:3003
-PUBLIC_INKEEP_AGENTS_RUN_API_URL=http://localhost:3003
+INKEEP_AGENTS_API_URL=http://localhost:3002
+PUBLIC_INKEEP_AGENTS_API_URL=http://localhost:3002
 
 # ============ TENANT CONFIGURATION ============
 # Default tenant ID for development

.github/composite-actions/cypress-e2e/action.yml

@@ -39,7 +39,7 @@ runs:
 
     - name: Start backend API server
       shell: bash
-      run: pnpm dev --filter='@inkeep/agents-manage-api' & # & means run job in background
+      run: pnpm dev --filter='@inkeep/agents-api' & # & means run job in background
 
     - name: Build dashboard and cookbook monorepo dependencies
       shell: bash

.github/workflows/ci.yml

@@ -86,6 +86,8 @@ jobs:
           OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY || 'sk-test-key-for-ci-testing' }}
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY || 'sk-ant-test-key-for-ci-testing' }}
           NODE_OPTIONS: --max-old-space-size=4096
+          INKEEP_AGENTS_MANAGE_DATABASE_URL: postgresql://appuser:password@localhost:5432/inkeep_agents
+          INKEEP_AGENTS_RUN_DATABASE_URL: postgresql://appuser:password@localhost:5433/inkeep_agents
           CI: true
           HUSKY: 0
 
@@ -201,8 +203,7 @@ jobs:
           pnpm --filter @inkeep/agents-core build
           pnpm --filter @inkeep/agents-manage-mcp build
           pnpm --filter @inkeep/agents-sdk build
-          pnpm --filter @inkeep/agents-manage-api build
-          pnpm --filter @inkeep/agents-run-api build
+          pnpm --filter @inkeep/agents-api build
           pnpm --filter @inkeep/agents-cli build
           pnpm --filter @inkeep/create-agents build
         env:
@@ -222,9 +223,9 @@ jobs:
         env:
           INKEEP_AGENTS_MANAGE_DATABASE_URL: postgresql://appuser:password@localhost:5432/inkeep_agents
           INKEEP_AGENTS_RUN_DATABASE_URL: postgresql://appuser:password@localhost:5433/inkeep_agents
-
-      - name: Run agents-manage-api integration tests
-        run: pnpm --filter @inkeep/agents-manage-api test:integration
+        
+      - name: Run agents-api integration tests
+        run: pnpm --filter @inkeep/agents-api test:integration 
         env:
           INKEEP_AGENTS_MANAGE_DATABASE_URL: postgresql://appuser:password@localhost:5432/inkeep_agents
           INKEEP_AGENTS_RUN_DATABASE_URL: postgresql://appuser:password@localhost:5433/inkeep_agents

.github/workflows/release.yml

@@ -6,8 +6,7 @@ on:
       - ".changeset/**"
       - "packages/**"
       - "agents-cli/**"
-      - "agents-manage-api/**"
-      - "agents-run-api/**"
+      - "agents-api/**"
     branches:
       - main
       - chat-to-edit

.gitignore

@@ -71,10 +71,10 @@ vite.config.d.ts
 .turbo
 
 # Generated workflow bundles
-agents-eval-api/.well-known/
+agents-api/.well-known/
 
 # Workflow runtime data
-agents-eval-api/.workflow-data/
+agents-api/.workflow-data/
 
 # Node compile cache
 node-compile-cache/

Agents.md

@@ -319,25 +319,25 @@ git worktree prune
 - **Agent Discovery**: Agents register capabilities via `/.well-known/{subAgentId}/agent.json` endpoints
 
 ### File Locations
-- **Core Agents**: `/execution/src/agents/Agent.ts`, `/inkeep-chat/src/agents/generateTaskHandler.ts`
-- **A2A Communication**: `/execution/src/a2a/`, `/inkeep-chat/src/handlers/executionHandler.ts`
-- **Database Layer**: `/packages/agents-core/src/data-access/` (agents, tasks, conversations, tools)
-- **Builder Patterns**: `/configuration/src/builder/` (agent.ts, graph.ts, tool.ts)
-- **Schemas**: `/packages/agents-core/src/data/db/schema.ts` (Drizzle), `/agents-run-api/src/schemas/` (Zod validation)
-- **Tests**: `/inkeep-chat/src/__tests__/` (unit and integration tests)
-- **UI Components**: `/agents-manage-ui/src/components/` (React components)
-- **UI Pages**: `/agents-manage-ui/src/app/` (Next.js pages and routing)
-- **Documentation**: `/agents-docs/` (Next.js/Fumadocs public documentation site)
-- **Legacy Documentation**: `/docs-legacy/` (internal/development notes)
-- **Examples**: `/agents-cookbook/` for reference implementations
+- **Core Agents**: `agents-api/src/domains/run/agents/Agent.ts`, `agents-api/src/domains/run/agents/generateTaskHandler.ts`
+- **A2A Communication**: `agents-api/src/domains/run/a2a/`, `agents-api/src/domains/run/handlers/executionHandler.ts`
+- **Database Layer**: `packages/agents-core/src/data-access/` (agents, tasks, conversations, tools)
+- **Builder Patterns**: `packages/agents-sdk/src/` (agent.ts, subAgent.ts, tool.ts, project.ts)
+- **Schemas**: `packages/agents-core/src/db/manage/manage-schema.ts`, `packages/agents-core/src/db/run/run-schema.ts` (Drizzle), `packages/agents-core/src/validation/` (Zod validation)
+- **Tests**: `agents-api/src/__tests__/` (unit and integration tests)
+- **UI Components**: `agents-manage-ui/src/components/` (React components)
+- **UI Pages**: `agents-manage-ui/src/app/` (Next.js pages and routing)
+- **Documentation**: `agents-docs/` (Next.js/Fumadocs public documentation site)
+- **Legacy Documentation**: `docs-legacy/` (internal/development notes)
+- **Examples**: `agents-cookbook/` for reference implementations
 
 ## Feature Development Examples
 
 ### Example: Adding a New Feature
 
 #### 1. Unit Test Example
 ```typescript
-// agents-manage-api/src/builder/__tests__/newFeature.test.ts
+// agents-api/src/__tests__/manage/newFeature.test.ts
 import { describe, it, expect, beforeEach } from 'vitest';
 import { NewFeature } from '../newFeature';
 

GEMINI.md

@@ -30,9 +30,8 @@ The project is a monorepo with the following packages:
 
 *   `agents-cli`: A command-line interface for interacting with the agent framework.
 *   `agents-docs`: The documentation website.
-*   `agents-manage-api`: The API for managing agents.
+*   `agents-api`: The API for managing, running and evaluating agents.
 *   `agents-manage-ui`: The UI for the visual builder.
-*   `agents-run-api`: The API for running agents.
 *   `agents-ui`: The UI for the chat widget.
 *   `examples`: Example agent configurations.
 *   `packages/agents-core`: Core functionality of the agent framework.

LICENSE_MANAGEMENT.md

@@ -17,8 +17,7 @@ These are the **authoritative versions** - all changes should be made to these r
 ### Distribution
 The following packages automatically receive copies of both license files:
 - `agents-cli`
-- `agents-manage-api`
-- `agents-run-api`
+- `agents-api`
 - `agents-ui`
 - `packages/agents-core`
 - `packages/agents-sdk`

README.md

@@ -73,11 +73,10 @@ Interested in a managed platform? Sign up for the [Inkeep Cloud waitlist](https:
 
 The Inkeep Agent Platform is composed of several key services and libraries that work together:
 
-- **agents-manage-api**: An API that handles configuration of Agents, Sub Agents, MCP Servers, Credentials, and Projects with a REST API.
-- **agents-manage-ui**: Visual Builder web interface for creating and managing Agents. Writes to the `agents-manage-api`.
-- **agents-sdk**: TypeScript SDK (`@inkeep/agents-sdk`) for declaratively defining Agents and custom tools in code. Writes to `agents-manage-api`.
+- **agents-api**: An API that handles configuration of Agents, Sub Agents, MCP Servers, Credentials, and Projects with a REST API. Additionally, it exposes Agent execution and evaluation. The API tracks conversation state and emits OTEL traces.
+- **agents-manage-ui**: Visual Builder web interface for creating and managing Agents. Writes to the `agents-api`.
+- **agents-sdk**: TypeScript SDK (`@inkeep/agents-sdk`) for declaratively defining Agents and custom tools in code. Writes to `agents-api`.
 - **agents-cli**: Includes various handy utilities, including `inkeep push` and `inkeep pull` which sync your TypeScript SDK code with the Visual Builder.
-- **agents-run-api**: The Runtime API that exposes Agents as APIs and executes Agent conversations. Keeps conversation state and emits OTEL traces.
 - **agents-ui**: A UI component library of chat interfaces for embedding rich, dynamic conversational AI experiences in web apps.
 
 Under the hood, the framework uses the [Vercel AI SDK](https://ai-sdk.dev/docs/introduction) for interfacing with LLM providers, so it's compatible with Vercel's [`useChat`](https://ai-sdk.dev/docs/ai-sdk-ui) hook and other AI primatives.