Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
3 changes: 1 addition & 2 deletions .env.docker.example
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
8 changes: 2 additions & 6 deletions .env.example
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion .github/composite-actions/cypress-e2e/action.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
7 changes: 3 additions & 4 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -201,8 +201,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:
Expand All @@ -217,8 +216,8 @@ jobs:
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
Expand Down
3 changes: 1 addition & 2 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,7 @@ on:
- ".changeset/**"
- "packages/**"
- "agents-cli/**"
- "agents-manage-api/**"
- "agents-run-api/**"
- "agents-api/**"
branches:
- main
- chat-to-edit
Expand Down
4 changes: 2 additions & 2 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -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/
Expand Down
24 changes: 12 additions & 12 deletions Agents.md
Original file line number Diff line number Diff line change
Expand Up @@ -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';

Expand Down
3 changes: 1 addition & 2 deletions GEMINI.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
3 changes: 1 addition & 2 deletions LICENSE_MANAGEMENT.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`
Expand Down
7 changes: 3 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Loading
Loading