feat(gateway): add create commands

package.json

@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@aws-sdk/client-bedrock-agentcore": "^3.1092.0",
-    "@aws-sdk/client-bedrock-agentcore-control": "^3.1079.0",
+    "@aws-sdk/client-bedrock-agentcore-control": "^3.1102.0",
     "@aws-sdk/client-iam": "^3.1080.0",
     "@smithy/core": "3.29.3",
     "@tanstack/react-query": "^5.101.2",

src/core/gateway.tsx

@@ -1,24 +1,50 @@
 import {
+  CreateGatewayCommand,
+  CreateGatewayRuleCommand,
+  CreateGatewayTargetCommand,
   GetGatewayCommand,
   GetGatewayRuleCommand,
   GetGatewayTargetCommand,
   ListGatewayRulesCommand,
   ListGatewaysCommand,
   ListGatewayTargetsCommand,
+  type CreateGatewayResponse,
+  type CreateGatewayRuleResponse,
+  type CreateGatewayTargetResponse,
   type GetGatewayResponse,
   type GetGatewayRuleResponse,
   type GetGatewayTargetResponse,
   type ListGatewayRulesResponse,
   type ListGatewaysResponse,
   type ListGatewayTargetsResponse,
 } from "@aws-sdk/client-bedrock-agentcore-control";
-import type { CoreGatewayClient } from "../handlers/gateway/types";
+import type {
+  CoreGatewayClient,
+  CreateGatewayInput,
+  CreateGatewayRuleInput,
+  CreateGatewayTargetInput,
+} from "../handlers/gateway/types";
 import type { AwsClients, CoreOptions } from "./types";
 import { toClientConfig } from "./utils";
 
 export class GatewayClient implements CoreGatewayClient {
   constructor(private readonly clients: AwsClients) {}
 
+  async createGateway(
+    input: CreateGatewayInput,
+    options: CoreOptions,
+  ): Promise<CreateGatewayResponse> {
+    const control = this.clients.control(toClientConfig(options));
+    const { protocol, roleArn, ...request } = input;
+    return control.send(
+      new CreateGatewayCommand({
+        ...request,
+        roleArn,
+        ...(protocol === "mcp" ? { protocolType: "MCP" as const } : {}),
+      }),
+    );
+  }
+
   async getGateway(id: string, options: CoreOptions): Promise<GetGatewayResponse> {
     return this.clients
       .control(toClientConfig(options))
@@ -63,6 +89,15 @@ export class GatewayClient implements CoreGatewayClient {
     );
   }
 
+  async createGatewayTarget(
+    input: CreateGatewayTargetInput,
+    options: CoreOptions,
+  ): Promise<CreateGatewayTargetResponse> {
+    return this.clients
+      .control(toClientConfig(options))
+      .send(new CreateGatewayTargetCommand(input));
+  }
+
   async getGatewayRule(
     gatewayId: string,
     ruleId: string,
@@ -90,4 +125,11 @@ export class GatewayClient implements CoreGatewayClient {
       }),
     );
   }
+
+  async createGatewayRule(
+    input: CreateGatewayRuleInput,
+    options: CoreOptions,
+  ): Promise<CreateGatewayRuleResponse> {
+    return this.clients.control(toClientConfig(options)).send(new CreateGatewayRuleCommand(input));
+  }
 }

src/core/index.tsx

@@ -101,7 +101,7 @@ export class CoreClient implements AwsClients {
   }
 
   // iam returns the IAM client for `config`, creating and caching it on first
-  // use (used to provision default harness execution roles).
+  // use (used to provision default execution roles).
   iam(config: ClientConfig): IAMClient {
     const key = cacheKey(config);
     let client = this.iamClients.get(key);

src/handlers/gateway/__fixtures__/create/CreateGatewayCommand.7f678b79455bc400.json

@@ -0,0 +1,17 @@
+{
+  "gatewayArn": "arn:aws:bedrock-agentcore:us-east-1:685197708687:gateway/agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "gatewayId": "agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "createdAt": {
+    "$date": "2026-08-06T17:25:41.425Z"
+  },
+  "updatedAt": {
+    "$date": "2026-08-06T17:25:41.425Z"
+  },
+  "status": "CREATING",
+  "name": "agentcore-cli-gateway-create-fixture",
+  "authorizerType": "NONE",
+  "gatewayUrl": "https://agentcore-cli-gateway-create-fixture-bkf6yayfce.gateway.bedrock-agentcore.us-east-1.amazonaws.com",
+  "description": "Disposable Gateway Create fixture",
+  "roleArn": "arn:aws:iam::685197708687:role/AgentCoreGateway-agentcore-cli-gateway-create-fix-f0aa3f799a4b",
+  "workloadIdentityDetails": {}
+}

src/handlers/gateway/__fixtures__/create/CreateGatewayRuleCommand.d87304453bfe9534.json

@@ -0,0 +1,19 @@
+{
+  "ruleId": "93d59ee8-8a9b-4535-9f11-df7006241fed",
+  "gatewayArn": "arn:aws:bedrock-agentcore:us-east-1:685197708687:gateway/agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "priority": 10,
+  "actions": [
+    {
+      "routeToTarget": {
+        "staticRoute": {
+          "targetName": "http-fixture"
+        }
+      }
+    }
+  ],
+  "createdAt": {
+    "$date": "2026-08-06T17:25:57.672Z"
+  },
+  "status": "CREATING",
+  "description": "Disposable Gateway Rule Create fixture"
+}

src/handlers/gateway/__fixtures__/create/CreateGatewayTargetCommand.22512d9b9027f76a.json

@@ -0,0 +1,35 @@
+{
+  "gatewayArn": "arn:aws:bedrock-agentcore:us-east-1:685197708687:gateway/agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "targetId": "U4ADV7VNSV",
+  "createdAt": {
+    "$date": "2026-08-06T17:25:52.273Z"
+  },
+  "updatedAt": {
+    "$date": "2026-08-06T17:25:52.273Z"
+  },
+  "status": "CREATING",
+  "name": "web-search-fixture",
+  "targetConfiguration": {
+    "mcp": {
+      "connector": {
+        "source": {
+          "connectorId": "web-search"
+        },
+        "configurations": [
+          {
+            "name": "WebSearch",
+            "parameterValues": {
+              "maxResults": 10
+            }
+          }
+        ]
+      }
+    }
+  },
+  "credentialProviderConfigurations": [
+    {
+      "credentialProviderType": "GATEWAY_IAM_ROLE"
+    }
+  ],
+  "description": "Disposable Gateway Connector Create fixture"
+}

src/handlers/gateway/__fixtures__/create/CreateGatewayTargetCommand.93c8d0503a636294.json

@@ -0,0 +1,20 @@
+{
+  "gatewayArn": "arn:aws:bedrock-agentcore:us-east-1:685197708687:gateway/agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "targetId": "VZ7M0WBGJF",
+  "createdAt": {
+    "$date": "2026-08-06T17:25:46.743Z"
+  },
+  "updatedAt": {
+    "$date": "2026-08-06T17:25:46.743Z"
+  },
+  "status": "CREATING",
+  "name": "http-fixture",
+  "targetConfiguration": {
+    "http": {
+      "passthrough": {
+        "endpoint": "https://example.com",
+        "protocolType": "CUSTOM"
+      }
+    }
+  }
+}

src/handlers/gateway/__fixtures__/create/GetGatewayCommand.5ff84cafc95022b4.json

@@ -0,0 +1,19 @@
+{
+  "gatewayArn": "arn:aws:bedrock-agentcore:us-east-1:685197708687:gateway/agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "gatewayId": "agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "createdAt": {
+    "$date": "2026-08-06T17:25:41.425Z"
+  },
+  "updatedAt": {
+    "$date": "2026-08-06T17:25:42.396Z"
+  },
+  "status": "READY",
+  "name": "agentcore-cli-gateway-create-fixture",
+  "authorizerType": "NONE",
+  "gatewayUrl": "https://agentcore-cli-gateway-create-fixture-bkf6yayfce.gateway.bedrock-agentcore.us-east-1.amazonaws.com",
+  "description": "Disposable Gateway Create fixture",
+  "roleArn": "arn:aws:iam::685197708687:role/AgentCoreGateway-agentcore-cli-gateway-create-fix-f0aa3f799a4b",
+  "workloadIdentityDetails": {
+    "workloadIdentityArn": "arn:aws:bedrock-agentcore:us-east-1:685197708687:workload-identity-directory/default/workload-identity/agentcore-cli-gateway-create-fixture-bkf6yayfce"
+  }
+}

src/handlers/gateway/__fixtures__/create/GetGatewayRuleCommand.9a6bd6a64eebb5df.json

@@ -0,0 +1,22 @@
+{
+  "ruleId": "93d59ee8-8a9b-4535-9f11-df7006241fed",
+  "gatewayArn": "arn:aws:bedrock-agentcore:us-east-1:685197708687:gateway/agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "priority": 10,
+  "actions": [
+    {
+      "routeToTarget": {
+        "staticRoute": {
+          "targetName": "http-fixture"
+        }
+      }
+    }
+  ],
+  "createdAt": {
+    "$date": "2026-08-06T17:25:57.672Z"
+  },
+  "status": "ACTIVE",
+  "description": "Disposable Gateway Rule Create fixture",
+  "updatedAt": {
+    "$date": "2026-08-06T17:25:57.672Z"
+  }
+}

src/handlers/gateway/__fixtures__/create/GetGatewayTargetCommand.3855b58e8bc470ab.json

@@ -0,0 +1,35 @@
+{
+  "gatewayArn": "arn:aws:bedrock-agentcore:us-east-1:685197708687:gateway/agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "targetId": "U4ADV7VNSV",
+  "createdAt": {
+    "$date": "2026-08-06T17:25:52.273Z"
+  },
+  "updatedAt": {
+    "$date": "2026-08-06T17:25:53.039Z"
+  },
+  "status": "READY",
+  "name": "web-search-fixture",
+  "targetConfiguration": {
+    "mcp": {
+      "connector": {
+        "source": {
+          "connectorId": "web-search"
+        },
+        "configurations": [
+          {
+            "name": "WebSearch",
+            "parameterValues": {
+              "maxResults": 10
+            }
+          }
+        ]
+      }
+    }
+  },
+  "credentialProviderConfigurations": [
+    {
+      "credentialProviderType": "GATEWAY_IAM_ROLE"
+    }
+  ],
+  "description": "Disposable Gateway Connector Create fixture"
+}

src/handlers/gateway/__fixtures__/create/GetGatewayTargetCommand.91cea07923c15ff.json

@@ -0,0 +1,20 @@
+{
+  "gatewayArn": "arn:aws:bedrock-agentcore:us-east-1:685197708687:gateway/agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "targetId": "VZ7M0WBGJF",
+  "createdAt": {
+    "$date": "2026-08-06T17:25:46.743Z"
+  },
+  "updatedAt": {
+    "$date": "2026-08-06T17:25:47.390Z"
+  },
+  "status": "READY",
+  "name": "http-fixture",
+  "targetConfiguration": {
+    "http": {
+      "passthrough": {
+        "endpoint": "https://example.com",
+        "protocolType": "CUSTOM"
+      }
+    }
+  }
+}

src/handlers/gateway/__fixtures__/create/connector-create.golden.json

@@ -0,0 +1,31 @@
+{
+  "gatewayArn": "arn:aws:bedrock-agentcore:us-east-1:685197708687:gateway/agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "targetId": "U4ADV7VNSV",
+  "createdAt": "2026-08-06T17:25:52.273Z",
+  "updatedAt": "2026-08-06T17:25:52.273Z",
+  "status": "CREATING",
+  "name": "web-search-fixture",
+  "targetConfiguration": {
+    "mcp": {
+      "connector": {
+        "source": {
+          "connectorId": "web-search"
+        },
+        "configurations": [
+          {
+            "name": "WebSearch",
+            "parameterValues": {
+              "maxResults": 10
+            }
+          }
+        ]
+      }
+    }
+  },
+  "credentialProviderConfigurations": [
+    {
+      "credentialProviderType": "GATEWAY_IAM_ROLE"
+    }
+  ],
+  "description": "Disposable Gateway Connector Create fixture"
+}

src/handlers/gateway/__fixtures__/create/gateway-create.golden.json

@@ -0,0 +1,13 @@
+{
+  "gatewayArn": "arn:aws:bedrock-agentcore:us-east-1:685197708687:gateway/agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "gatewayId": "agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "createdAt": "2026-08-06T17:25:41.425Z",
+  "updatedAt": "2026-08-06T17:25:41.425Z",
+  "status": "CREATING",
+  "name": "agentcore-cli-gateway-create-fixture",
+  "authorizerType": "NONE",
+  "gatewayUrl": "https://agentcore-cli-gateway-create-fixture-bkf6yayfce.gateway.bedrock-agentcore.us-east-1.amazonaws.com",
+  "description": "Disposable Gateway Create fixture",
+  "roleArn": "arn:aws:iam::685197708687:role/AgentCoreGateway-agentcore-cli-gateway-create-fix-f0aa3f799a4b",
+  "workloadIdentityDetails": {}
+}

src/handlers/gateway/__fixtures__/create/rule-create.golden.json

@@ -0,0 +1,17 @@
+{
+  "ruleId": "93d59ee8-8a9b-4535-9f11-df7006241fed",
+  "gatewayArn": "arn:aws:bedrock-agentcore:us-east-1:685197708687:gateway/agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "priority": 10,
+  "actions": [
+    {
+      "routeToTarget": {
+        "staticRoute": {
+          "targetName": "http-fixture"
+        }
+      }
+    }
+  ],
+  "createdAt": "2026-08-06T17:25:57.672Z",
+  "status": "CREATING",
+  "description": "Disposable Gateway Rule Create fixture"
+}

src/handlers/gateway/__fixtures__/create/target-create.golden.json

@@ -0,0 +1,16 @@
+{
+  "gatewayArn": "arn:aws:bedrock-agentcore:us-east-1:685197708687:gateway/agentcore-cli-gateway-create-fixture-bkf6yayfce",
+  "targetId": "VZ7M0WBGJF",
+  "createdAt": "2026-08-06T17:25:46.743Z",
+  "updatedAt": "2026-08-06T17:25:46.743Z",
+  "status": "CREATING",
+  "name": "http-fixture",
+  "targetConfiguration": {
+    "http": {
+      "passthrough": {
+        "endpoint": "https://example.com",
+        "protocolType": "CUSTOM"
+      }
+    }
+  }
+}