Initial import

examples/prompts.md

@@ -0,0 +1,77 @@
+# Prompt API
+The Prompt API provides a set of prompts with optional
+arguments and [autocompletion](completion.md) support.
+
+## Listing Prompts
+The client can request a set of prompts
+from the server using the `prompts/list` call
+
+A client request:
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "prompts/list",
+  "params": {}
+}
+```
+
+And an appropriate server response
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "result": {
+    "prompts": [
+      {
+        "name": "my-prompt",
+        "arguments": [
+          {
+            "name": "input",
+            "description": "The input string",
+            "required": false
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Running a prompt
+In order to run a prompt, the client issues
+a `prompts/get` command:
+
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 2,
+  "method": "prompts/get",
+  "params": {
+    "name": "my-prompt",
+    "arguments": {
+      "input": "hello world"
+    }
+  }
+}
+```
+
+and it's respective response:
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 2,
+  "result": {
+    "description": "An optional description of the prompt.",
+    "messages": [
+      {
+        "role": "user",
+        "content": {
+          "type": "text",
+          "text": "This is a templated prompt. You passed the argument 'hello world'"
+        }
+      }
+    ]
+  }
+}
+```