@aws/nx-plugin-mcp 1.0.0-rc.36 → 1.0.0-rc.37

package/docs/guides/connection/agentcore-gateway-mcp.mdx

@@ -102,7 +102,7 @@ resource "aws_bedrockagentcore_gateway_target" "my_mcp_server" {
   target_configuration {
     mcp {
       mcp_server {
-        endpoint = "https://bedrock-agentcore.${local.aws_region}.amazonaws.com/runtimes/${urlencode(module.my_mcp_server.agent_core_runtime_arn)}/invocations?qualifier=DEFAULT"
+        endpoint = module.my_mcp_server.invocation_url
       }
     }
   }

package/docs/guides/connection/react-py-agent.mdx

@@ -122,11 +122,8 @@ function ChatComponent() {
     },
   }));
 
-  const handleSend = (message: string) => {
-    invoke.mutate({
-      prompt: message,
-      sessionId: 'my-session',
-    });
+  const handleSend = (prompt: string) => {
+    invoke.mutate({ prompt });
   };
 
   return (
@@ -154,12 +151,9 @@ function ChatComponent() {
   const client = useMyAgentClient();
   const [chunks, setChunks] = useState<StreamChunk[]>([]);
 
-  const handleSend = async (message: string) => {
+  const handleSend = async (prompt: string) => {
     setChunks([]);
-    for await (const chunk of client.invoke({
-      prompt: message,
-      sessionId: 'my-session',
-    })) {
+    for await (const chunk of client.invoke({ prompt })) {
       setChunks((prev) => [...prev, chunk]);
     }
   };

package/docs/guides/connection/react-ts-agent.mdx

@@ -93,7 +93,7 @@ function ChatComponent() {
 
   const subscription = useSubscription(
     trpc.invoke.subscriptionOptions(
-      { message: 'What can you help me with?' },
+      { prompt: 'What can you help me with?' },
       {
         enabled: true,
         onStarted: () => {
@@ -135,9 +135,9 @@ function ChatComponent() {
   const client = useMyAgentAgentClient();
   const [messages, setMessages] = useState<string[]>([]);
 
-  const sendMessage = (message: string) => {
+  const sendMessage = (prompt: string) => {
     const subscription = client.invoke.subscribe(
-      { message },
+      { prompt },
       {
         onData: (token) => {
           setMessages((prev) => [...prev, token]);

package/docs/guides/py-agent.mdx

@@ -302,13 +302,13 @@ The agent's invocation endpoint uses [Pydantic](https://docs.pydantic.dev/) mode
 
 #### Defining Input Models
 
-The default `InvokeInput` model accepts a message.
+The default `InvokeInput` model accepts a prompt.
 
 ```python
 from pydantic import BaseModel
 
 class InvokeInput(BaseModel):
-    message: str
+    prompt: str
 ```
 
 You can extend this model to include any additional fields your agent needs.
@@ -493,7 +493,7 @@ To invoke an Agent running locally via the `<your-agent-name>-serve` target, you
 
 ```bash
 curl -N -X POST http://localhost:8081/invocations \
-  -d '{"message": "what is 3 + 5?"}' \
+  -d '{"prompt": "what is 3 + 5?"}' \
   -H "Content-Type: application/json"
 ```
 
@@ -514,7 +514,7 @@ For IAM Authentication, the request must be signed using AWS Signature Version 4
 ```bash
 acurl <region> bedrock-agentcore -N -X POST \
 'https://bedrock-agentcore.<region>.amazonaws.com/runtimes/<url-encoded-arn>/invocations' \
--d '{"message": "what is 3 + 5?"}' \
+-d '{"prompt": "what is 3 + 5?"}' \
 -H 'Content-Type: application/json'
 ```
 
@@ -530,7 +530,7 @@ For Cognito Authentication, pass the Cognito Access Token in the `Authorization`
 
 ```bash
 curl -N -X POST 'https://bedrock-agentcore.<region>.amazonaws.com/runtimes/<url-encoded-arn>/invocations' \
-  -d '{"message": "what is 3 + 5?"}' \
+  -d '{"prompt": "what is 3 + 5?"}' \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer <access-token>"
 ```

package/docs/guides/ts-agent.mdx

@@ -362,7 +362,7 @@ import { AgentClient } from '../packages/<project>/src/agent/client.js';
 
 const client = AgentClient.local({ url: 'http://localhost:8081/ws' });
 
-client.invoke.subscribe({ message: 'what is 1 plus 1?' }, { onData: console.log });
+client.invoke.subscribe({ prompt: 'what is 1 plus 1?' }, { onData: console.log });
 ```
 
 :::tip[Quick Testing]
@@ -396,7 +396,7 @@ const client = AgentClient.withIamAuth({
   agentRuntimeArn: 'arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/my-agent',
 });
 
-client.invoke.subscribe({ message: 'what is 1 plus 1?' }, {
+client.invoke.subscribe({ prompt: 'what is 1 plus 1?' }, {
   onData: (message) => console.log(message),
   onError: (error) => console.error(error),
   onComplete: () => console.log('Done'),
@@ -419,7 +419,7 @@ const client = AgentClient.withJwtAuth({
   accessTokenProvider: async () => `<access-token>`,
 });
 
-client.invoke.subscribe({ message: 'what is 1 plus 1?' }, {
+client.invoke.subscribe({ prompt: 'what is 1 plus 1?' }, {
   onData: console.log,
 });
 ```

package/docs/snippets/agent/runtime-arn.mdx

@@ -61,4 +61,25 @@ The Bedrock AgentCore Runtime dataplane URL for invoking the agent is as follows
 https://bedrock-agentcore.<region>.amazonaws.com/runtimes/<url-encoded-arn>/invocations
 ```
 
+:::tip[Invocation URL]
+Your infrastructure can also output the full invocation URL directly, with the ARN encoding handled for you:
+
+<Infrastructure>
+<Fragment slot="cdk">
+```ts
+new CfnOutput(this, 'AgentUrl', {
+  value: agent.invocationUrl,
+});
+```
+</Fragment>
+<Fragment slot="terraform">
+```terraform
+output "agent_url" {
+  value = module.my_project_agent.invocation_url
+}
+```
+</Fragment>
+</Infrastructure>
+:::
+
 The exact way to invoke this URL depends upon the authentication method used.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws/nx-plugin-mcp",
-  "version": "1.0.0-rc.36",
+  "version": "1.0.0-rc.37",
   "repository": {
     "type": "git",
     "url": "https://github.com/awslabs/nx-plugin-for-aws.git",