Merge pull request #50 from KestrelAI/add-workflow-request-docs

Add workflow request docs

Author: ramanv0

docs/workflows/cli.mdx

@@ -141,11 +141,34 @@ kestrel workflows test <workflow-id>
 
 ### Request a workflow
 
-Submit a natural language request to trigger a matching workflow (CLI equivalent of `/kestrel-workflow` in Slack):
+Submit a natural language request to trigger a matching workflow. This is the CLI equivalent of `/kestrel-workflow` in Slack or the "Make a Request" page in the Kestrel Platform UI:
 
 ```bash
 kestrel workflows request "provision an MSK cluster with 3 brokers in us-east-1"
 kestrel workflows request "scale the payments deployment to 5 replicas"
+kestrel workflows request "create a DNS record for api.example.com in Cloudflare"
+kestrel workflows request "add a new PagerDuty escalation policy for the payments team"
+```
+
+If the matched workflow requires additional parameters, you'll be prompted interactively:
+
+```
+$ kestrel workflows request "create a configmap"
+  Routing request: create a configmap
+
+  ! Matched workflow: On-Demand K8s Resource Provision
+  Extracted: resource_type=ConfigMap
+
+  Please provide the following details:
+
+  cluster: prod-cluster
+  namespace: payments
+  name: app-config
+
+  Submitting with parameters...
+
+  ✓ Matched workflow: On-Demand K8s Resource Provision
+  ✓ Workflow is now executing.
 ```
 
 ## Execution Commands

docs/workflows/sdk.mdx

@@ -163,14 +163,47 @@ Trigger.vercel_error_anomaly()
 Trigger.vercel_usage_anomaly()
 Trigger.vercel_domain_issue()
 
-# Slack Requests (on-demand via /kestrel-workflow)
-Trigger.request_k8s_provision()
-Trigger.request_k8s_edit()
-Trigger.request_k8s_investigate()
-Trigger.request_cloud_provision()
-Trigger.request_cloud_edit()
-Trigger.request_cloud_investigate()
-Trigger.request_any()
+# Developer Requests (on-demand via Slack /kestrel-workflow, Kestrel Platform UI, or CLI)
+Trigger.request_kubernetes()    # Kubernetes operations
+Trigger.request_cloud()         # AWS / Cloud operations
+Trigger.request_cloudflare()    # Cloudflare operations
+Trigger.request_pagerduty()     # PagerDuty operations
+Trigger.request_datadog()       # Datadog operations
+Trigger.request_argocd()        # ArgoCD operations
+Trigger.request_github()        # GitHub operations
+Trigger.request_gitlab()        # GitLab operations
+Trigger.request_helm()          # Helm operations
+Trigger.request_vercel()        # Vercel operations
+Trigger.request_general()       # General (catch-all)
+```
+
+Each request trigger can be scoped further:
+
+```python
+from kestrel.workflows import Trigger
+
+# Kubernetes requests — only create operations from Slack
+Trigger.request_kubernetes().config(
+    request_sources=["slack"],
+    request_types=["create"],
+)
+
+# Cloud requests — only from Platform UI and CLI
+Trigger.request_cloud().config(
+    request_sources=["platform", "cli"],
+)
+```
+
+### Submitting Requests Programmatically
+
+```python
+# Submit a request (like /kestrel-workflow in Slack)
+result = client.workflows.request("create a configmap for my-app in production")
+
+# If clarification is needed:
+if result.status == "awaiting_params":
+    reply = client.workflows.request_reply(result.id, "use the prod-cluster, namespace=payments")
+```
 
 # Custom Webhook
 Trigger.custom_webhook("my-event-type")