From aad9564e817486251ddebdf9217b228d0e649779 Mon Sep 17 00:00:00 2001
From: geens <niels.geens@gmail.com>
Date: Wed, 13 Nov 2024 11:43:48 +0100
Subject: [PATCH] Added examples to action schema

---
 action_schema.xsd | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/action_schema.xsd b/action_schema.xsd
index b131bfc..8f22353 100644
--- a/action_schema.xsd
+++ b/action_schema.xsd
@@ -1,4 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Always answer with a single element.
+-->
 <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
 
   <!--
@@ -6,6 +9,8 @@
     Use it to remove unnecessary items and stop background processes.
     When you delete something, it is gone.
     Make sure all important info is stored in files.
+    Example:
+    <delete id="1234567890"/>
   -->
   <xs:element name="delete">
     <xs:complexType>
@@ -17,6 +22,8 @@
     Stop command terminates the agent gracefully.
     For the main SIA instance this will trigger an update and restart.
     For sub-instances this is the correct way to stop after all tasks are complete.
+    Example:
+    <stop id="1234567890"/>
   -->
   <xs:element name="stop">
     <xs:complexType/>
@@ -26,6 +33,10 @@
     Single script that runs once and completes.
     Output is stored in context until explicitly deleted.
     Used for one-time operations like file manipulation.
+    Example:
+    <single>
+      ls /
+    </single>
   -->
   <xs:element name="single">
     <xs:complexType mixed="true">
@@ -40,6 +51,10 @@
     After a command is issued, all repeat scripts in context are run again.
     Useful for monitoring changing files or viewing results immediately after changing a file.
     Repeat scripts should execute quickly to avoid blocking the agent.
+    Example:
+    <repeat>
+      ls /
+    </repeat>
   -->
   <xs:element name="repeat">
     <xs:complexType mixed="true">
@@ -53,6 +68,10 @@
     As an agent it is important to reason about your actions and their results.
     In a reasoning action you can write freeform text.
     This is also stored in context until deleted.
+    Example:
+    <reasoning>
+      I should explore the file system for interesting files.
+    </reasoning>
   -->
   <xs:element name="reasoning">
     <xs:complexType mixed="true">
@@ -64,6 +83,8 @@
 
   <!--
     Read all available text on stdin and store it in context.
+    Example:
+    <read_stdin/>
   -->
   <xs:element name="read_stdin">
     <xs:complexType/>
@@ -72,6 +93,10 @@
   <!--
     Write to stdout.
     This is your main way of contacting the user.
+    Example:
+    <write_stdout>
+      Hello world!
+    </write_stdout>
   -->
   <xs:element name="write_stdout">
     <xs:complexType mixed="true">