sync docs (#524)

Co-authored-by: michaeljguarino <[email protected]>

Author: github-actions[bot]

pages/overview/agent-api-reference.md

@@ -10,6 +10,7 @@ Package v1alpha1 contains API Schema definitions for the deployments v1alpha1 AP
 
 ### Resource Types
 - [AgentConfiguration](#agentconfiguration)
+- [AgentRuntime](#agentruntime)
 - [ClusterDrain](#clusterdrain)
 - [CustomHealth](#customhealth)
 - [IngressReplica](#ingressreplica)
@@ -99,6 +100,78 @@ _Appears in:_
 | `valuesConfigMapRef` _[ConfigMapKeySelector](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.29/#configmapkeyselector-v1-core)_ | ValuesConfigMapRef fetches helm values from a config map in this cluster.<br />Use only one of:<br />	- Values<br />	- ValuesSecretRef<br />	- ValuesConfigMapRef |  | Optional: \{\} <br /> |
 
 
+#### AgentRuntime
+
+
+
+AgentRuntime is the Schema for the agentruntimes API
+
+
+
+
+
+| Field | Description | Default | Validation |
+| --- | --- | --- | --- |
+| `apiVersion` _string_ | `deployments.plural.sh/v1alpha1` | | |
+| `kind` _string_ | `AgentRuntime` | | |
+| `metadata` _[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.29/#objectmeta-v1-meta)_ | Refer to Kubernetes API documentation for fields of `metadata`. |  |  |
+| `spec` _[AgentRuntimeSpec](#agentruntimespec)_ |  |  |  |
+
+
+#### AgentRuntimeBindings
+
+
+
+
+
+
+
+_Appears in:_
+- [AgentRuntimeSpec](#agentruntimespec)
+
+| Field | Description | Default | Validation |
+| --- | --- | --- | --- |
+| `create` _[Binding](#binding) array_ | Create bindings control who can generate new agent runtimes. |  | Optional: \{\} <br /> |
+
+
+#### AgentRuntimeConfig
+
+
+
+AgentRuntimeConfig contains typed configuration for the agent runtime.
+
+
+
+_Appears in:_
+- [AgentRuntimeSpec](#agentruntimespec)
+
+| Field | Description | Default | Validation |
+| --- | --- | --- | --- |
+| `claude` _[ClaudeConfig](#claudeconfig)_ | Config for Claude CLI runtime. |  | Optional: \{\} <br /> |
+| `opencode` _[OpenCodeConfig](#opencodeconfig)_ | Config for OpenCode CLI runtime. |  | Optional: \{\} <br /> |
+
+
+#### AgentRuntimeSpec
+
+
+
+AgentRuntimeSpec defines the desired state of AgentRuntime
+
+
+
+_Appears in:_
+- [AgentRuntime](#agentruntime)
+
+| Field | Description | Default | Validation |
+| --- | --- | --- | --- |
+| `name` _string_ | Name of this AgentRuntime.<br />If not provided, the name from AgentRuntime.ObjectMeta will be used. |  | Optional: \{\} <br /> |
+| `type` _[AgentRuntimeType](#agentruntimetype)_ | Type specifies the agent runtime to use for executing the stack.<br />One of CLAUDE, OPENCODE, GEMINI, CUSTOM. |  | Enum: [CLAUDE OPENCODE GEMINI CUSTOM] <br />Required: \{\} <br /> |
+| `bindings` _[AgentRuntimeBindings](#agentruntimebindings)_ | Bindings define the creation permissions for this agent runtime. |  | Optional: \{\} <br /> |
+| `template` _[PodTemplateSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.29/#podtemplatespec-v1-core)_ | Template defines the pod template for this agent runtime. |  | Required: \{\} <br /> |
+| `config` _[AgentRuntimeConfig](#agentruntimeconfig)_ | Config contains typed configuration depending on the chosen runtime type. |  |  |
+| `aiProxy` _boolean_ | AiProxy specifies whether the agent runtime should be proxied through the AI proxy. |  |  |
+
+
 #### Binding
 
 
@@ -108,6 +181,7 @@ Binding ...
 
 
 _Appears in:_
+- [AgentRuntimeBindings](#agentruntimebindings)
 - [Bindings](#bindings)
 
 | Field | Description | Default | Validation |
@@ -138,6 +212,24 @@ _Appears in:_
 | `write` _[Binding](#binding) array_ | Write bindings. |  | Optional: \{\} <br /> |
 
 
+#### ClaudeConfig
+
+
+
+ClaudeConfig contains configuration for the Claude CLI runtime.
+
+
+
+_Appears in:_
+- [AgentRuntimeConfig](#agentruntimeconfig)
+
+| Field | Description | Default | Validation |
+| --- | --- | --- | --- |
+| `apiKeySecretRef` _[SecretKeySelector](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.29/#secretkeyselector-v1-core)_ | ApiKeySecretRef Reference to a Kubernetes Secret containing the Claude API key. |  |  |
+| `model` _string_ | Model Name of the model to use. |  |  |
+| `extraArgs` _string array_ | ExtraArgs CLI args for advanced flags not modeled here |  |  |
+
+
 #### ClusterDrain
 
 
@@ -431,6 +523,24 @@ MetricsAggregate
 
 
 
+#### OpenCodeConfig
+
+
+
+OpenCodeConfig contains configuration for the OpenCode CLI runtime.
+
+
+
+_Appears in:_
+- [AgentRuntimeConfig](#agentruntimeconfig)
+
+| Field | Description | Default | Validation |
+| --- | --- | --- | --- |
+| `endpoint` _string_ | API endpoint for the OpenCode service. |  |  |
+| `tokenSecretRef` _[SecretKeySelector](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.29/#secretkeyselector-v1-core)_ | Reference to a Kubernetes Secret containing the API token for OpenCode. |  |  |
+| `extraArgs` _string array_ | Extra args for advanced or experimental CLI flags. |  |  |
+
+
 #### PipelineGate
 
 

pages/overview/management-api-reference.md

@@ -249,7 +249,7 @@ _Appears in:_
 
 | Field | Description | Default | Validation |
 | --- | --- | --- | --- |
-| `modelId` _string_ | ModelID is the AWS Bedrock Model ID to use. |  | Required: \{\} <br /> |
+| `modelId` _string_ | ModelID is the AWS Bedrock Model ID to use.  This will use the openai compatible endpoint, so the model id must be supported. |  | Required: \{\} <br /> |
 | `toolModelId` _string_ | ToolModelId to use for tool calling, which is less frequent and often requires more advanced reasoning |  | Optional: \{\} <br /> |
 | `embeddingModel` _string_ | EmbeddingModel to use for generating embeddings |  | Optional: \{\} <br /> |
 | `region` _string_ | Region is the AWS region the model is hosted in |  | Required: \{\} <br /> |
@@ -843,6 +843,7 @@ specifications that are populated with data from the discovered clusters.
 
 Example usage:
 
+	```yaml
 	apiVersion: deployments.plural.sh/v1alpha1
 	kind: ClusterSync
 	metadata:
@@ -861,6 +862,7 @@ Example usage:
 	      handle: "{{ .cluster.handle }}"
 	      version: "{{ .cluster.version }}"
 	      cloud: "{{ .cluster.cloud }}"
+	 ````
 
 
 
@@ -1146,6 +1148,7 @@ monitoring integrations, and AI-powered features.
 
 Example usage:
 
+	```yaml
 	apiVersion: deployments.plural.sh/v1alpha1
 	kind: DeploymentSettings
 	metadata:
@@ -1183,6 +1186,7 @@ Example usage:
 	  cost:
 	    recommendationCushion: 20
 	    recommendationThreshold: 100
+	```
 
 
 
@@ -4596,7 +4600,7 @@ _Appears in:_
 
 | Field | Description | Default | Validation |
 | --- | --- | --- | --- |
-| `model` _string_ | Model is the Vertex AI model to use |  | Optional: \{\} <br /> |
+| `model` _string_ | Model is the Vertex AI model to use.  Must support the OpenAI completions api, see: https://cloud.google.com/vertex-ai/generative-ai/docs/migrate/openai/overview |  | Optional: \{\} <br /> |
 | `toolModel` _string_ | ToolModel to use for tool calling, which is less frequent and often requires more advanced reasoning |  | Optional: \{\} <br /> |
 | `embeddingModel` _string_ | EmbeddingModel to use for generating embeddings |  | Optional: \{\} <br /> |
 | `project` _string_ | Project is the GCP project you'll be using |  | Required: \{\} <br /> |