Add kernel_app data source

README.md

@@ -20,6 +20,7 @@ Resources:
 
 Data sources:
 
+- `kernel_app`
 - `kernel_project`
 - `kernel_profile`
 - `kernel_proxy`

docs/data-sources/app.md

@@ -0,0 +1,33 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "kernel_app Data Source - Kernel"
+subcategory: ""
+description: |-
+  Lookup a running Kernel app version by exact app name and version.
+---
+
+# kernel_app (Data Source)
+
+Lookup a running Kernel app version by exact app name and version.
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `app_name` (String) Exact app name.
+- `version` (String) Exact app version label.
+
+### Optional
+
+- `project_id` (String) Project to look the app up in. Defaults to the provider `project_id`; when neither is set, the API key's project binding determines the project.
+
+### Read-Only
+
+- `actions` (Set of String) Action names available on this app version.
+- `deployment_id` (String) Deployment backing this app version.
+- `env_var_keys` (Set of String) Environment variable names configured for this app version. Values are never exposed.
+- `id` (String) Canonical app-version ID.
+- `region` (String) Deployment region.

examples/README.md

@@ -23,6 +23,6 @@ Use local development overrides while the provider is unreleased. See the root [
 - [basic-browser-pool](basic-browser-pool) creates a minimal durable browser pool.
 - [design-preview-browser-pool](design-preview-browser-pool) shows a browser pool shaped for repeated design-preview checks without modeling the browser sessions themselves.
 - [extension](extension) uploads an immutable extension archive and tracks exact content changes with `filesha256`.
-- [lookups](lookups) shows read-only project, profile, proxy, and extension data sources.
+- [lookups](lookups) shows read-only app, project, profile, proxy, and extension data sources.
 - [project](project) creates a durable Kernel project with an explicit unique name.
 - [project-scoped-browser-pool](project-scoped-browser-pool) places a browser pool in an explicit project, overriding the provider-level `project_id` default.

examples/lookups/main.tf

@@ -28,6 +28,16 @@ variable "extension_name" {
   description = "Existing Kernel extension name for exact lookup."
 }
 
+variable "app_name" {
+  type        = string
+  description = "Existing running Kernel app name for exact lookup."
+}
+
+variable "app_version" {
+  type        = string
+  description = "Existing running Kernel app version for exact lookup."
+}
+
 data "kernel_project" "selected" {
   name = var.project_name
 }
@@ -47,11 +57,19 @@ data "kernel_extension" "selected" {
   project_id = data.kernel_project.selected.id
 }
 
+data "kernel_app" "selected" {
+  app_name   = var.app_name
+  version    = var.app_version
+  project_id = data.kernel_project.selected.id
+}
+
 output "kernel_ids" {
   value = {
-    project_id   = data.kernel_project.selected.id
-    profile_id   = data.kernel_profile.selected.id
-    proxy_id     = data.kernel_proxy.selected.id
-    extension_id = data.kernel_extension.selected.id
+    project_id    = data.kernel_project.selected.id
+    profile_id    = data.kernel_profile.selected.id
+    proxy_id      = data.kernel_proxy.selected.id
+    extension_id  = data.kernel_extension.selected.id
+    app_id        = data.kernel_app.selected.id
+    deployment_id = data.kernel_app.selected.deployment_id
   }
 }