@inkeep/agents-cli 0.0.0-dev-20251012022558 → 0.0.0-dev-20251012052609

package/README.md

@@ -1,6 +1,6 @@
 # Inkeep CLI
 
-A command-line interface for managing and interacting with Inkeep Agent Framework graphs.
+A command-line interface for managing and interacting with Inkeep Agent Frameworks.
 
 ## Installation & Setup
 
@@ -257,14 +257,14 @@ inkeep list-graphs --project my-project-id --agents-manage-api-url http://api.ex
 inkeep list-graphs --project my-project-id --tenant-id my-tenant-id
 
 # Using config file
-inkeep list-graphs --project my-project-id --config ./my-config.ts
+inkeep list-agents --project my-project-id --config ./my-config.ts
 ```
 
 Output:
 
 ```
 ┌─────────────────────────┬────────────────────┬───────────────┬───────────┐
-│ Graph ID                │ Name               │ Default Agent │ Created   │
+│ Agent ID                │ Name               │ Default Agent │ Created   │
 ├─────────────────────────┼────────────────────┼───────────────┼───────────┤
 │ customer-support-graph  │ Customer Support   │ router        │ 1/15/2025 │
 │ qa-assistant           │ QA Assistant       │ qa-agent      │ 1/14/2025 │
@@ -295,40 +295,36 @@ inkeep push --project my-project-id --tenant-id my-tenant-id
 **Features:**
 
 - Automatically injects tenant ID and API URL from `inkeep.config.ts`
-- Validates exactly one AgentGraph is exported
+- Validates exactly one Agent is exported
 - Warns about dangling resources (unreferenced agents/tools)
 - Shows graph summary after successful push
 - Handles graph initialization automatically
 
-**Graph files:** Define your graphs in your project (e.g., `graphs/*.graph.ts`). The CLI pushes the project containing those graphs.
+**Agent files:** Define your agents in your project (e.g., `agents/*.ts`). The CLI pushes the project containing those agents.
 
 **Example graph configuration:**
 
 ```javascript
-// customer-support.graph.ts
-import { agent, agentGraph, tool } from "@inkeep/agents-manage-api/builder";
+// customer-support.agent.ts
+import { agent, subAgent, tool } from "@inkeep/agents-sdk";
 
-const assistantAgent = agent({
+const assistantSubAgent = subAgent({
   id: "assistant",
   name: "Assistant",
-  instructions: "Help users with their questions",
-  tools: {
-    search: searchTool,
-  },
+  prompt: "Help users with their questions",
+  canUse: () => [searchTool],
   // No tenantId needed - injected by CLI
 });
 
-// Must export exactly one graph
-export const graph = agentGraph({
+// Must export exactly one agent
+export const myAgent = agent({
   id: "my-assistant",
-  name: "My Assistant Graph",
-  defaultSubAgent: assistantAgent,
-  agents: {
-    assistant: assistantAgent,
-  },
+  name: "My Assistant",
+  defaultSubAgent: assistantSubAgent,
+  subAgents: () => [assistantSubAgent],
   // No tenantId or apiUrl needed - CLI injects from config
 });
-// No graph.init() call - CLI handles initialization
+// No agent.init() call - CLI handles initialization
 ```
 
 ### `inkeep chat [graph-id]`
@@ -370,17 +366,17 @@ inkeep chat --config ./my-config.ts
 Start MCP (Model Context Protocol) servers defined in a graph file.
 
 ```bash
-# Start MCP servers from a TypeScript graph file
-inkeep mcp start examples/agent-configurations/graph.graph.ts
+# Start MCP servers from a TypeScript agent file
+inkeep mcp start examples/agent-configurations/weather-agent.ts
 
 # Start from compiled JavaScript
-inkeep mcp start dist/examples/agent-configurations/graph.graph.js
+inkeep mcp start dist/examples/agent-configurations/weather-agent.js
 
 # Run in detached mode
-inkeep mcp start graph.graph.ts --detached
+inkeep mcp start my-agent.ts --detached
 
 # Show verbose output
-inkeep mcp start graph.graph.ts --verbose
+inkeep mcp start my-agent.ts --verbose
 ```
 
 **Features:**
@@ -461,14 +457,14 @@ inkeep init
 > **⚠️ WARNING: MCP commands shown below are not yet implemented.**
 > This section shows planned functionality that is not available in the current version.
 
-1. **Create a graph with MCP tools** (`my-graph.graph.ts`)
+1. **Create an agent with MCP tools** (`my-agent.ts`)
 
 ```typescript
 import {
   agent,
-  agentGraph,
+  subAgent,
   mcpServer,
-} from "@inkeep/agents-manage-api/builder";
+} from "@inkeep/agents-sdk";
 
 // Define MCP servers (tools)
 const randomNumberServer = mcpServer({
@@ -483,23 +479,20 @@ const weatherServer = mcpServer({
   serverUrl: "https://api.weather.example.com/mcp",
 });
 
-// Define agents
-const assistantAgent = agent({
+// Define sub-agents
+const assistantSubAgent = subAgent({
   id: "assistant",
   name: "Assistant",
-  instructions: "Help users with various tasks",
-  tools: {
-    random: randomNumberServer,
-    weather: weatherServer,
-  },
+  prompt: "Help users with various tasks",
+  canUse: () => [randomNumberServer, weatherServer],
 });
 
-// Export the graph
-export const graph = agentGraph({
+// Export the agent
+export const myAgent = agent({
   id: "my-assistant",
   name: "My Assistant",
-  defaultSubAgent: assistantAgent,
-  agents: { assistant: assistantAgent },
+  defaultSubAgent: assistantSubAgent,
+  subAgents: () => [assistantSubAgent],
 });
 
 // Export servers for MCP management
@@ -510,7 +503,7 @@ export const servers = [randomNumberServer, weatherServer];
 
 ```bash
 # Start MCP servers (works with TypeScript directly!)
-inkeep mcp start my-graph.graph.ts
+inkeep mcp start my-agent.ts
 
 # In another terminal, start chatting
 inkeep chat my-assistant