@xano/developer-mcp 1.0.6 → 1.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xano/developer-mcp",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "MCP server for Xano Headless API documentation and XanoScript code validation",
   "type": "module",
   "main": "dist/index.js",

package/xanoscript_docs/README.md

@@ -16,22 +16,24 @@ XanoScript is the declarative scripting language for [Xano](https://xano.com), a
 | `mcp_server` | `mcp_servers/**/*.xs` | MCP server definitions |
 | `addon` | `addons/*.xs` | Subqueries for related data |
 
+**Important:** Each `.xs` file must contain exactly one definition. You cannot define multiple tables, functions, queries, or other constructs in a single file.
+
 ## Workspace Structure
 
 ```
 project/
-├── tables/              # Database table schemas
-├── functions/           # Reusable functions (supports subfolders)
+├── tables/              // Database table schemas
+├── functions/           // Reusable functions (supports subfolders)
 ├── apis/
-│   └── <api-group>/     # API endpoints grouped by domain
-├── tasks/               # Scheduled jobs
-├── triggers/            # Event-driven handlers
-├── agents/              # AI agents
-├── tools/               # AI tools
-├── mcp_servers/         # MCP server definitions
-├── addons/              # Query addons
-├── static/              # Frontend files (HTML, CSS, JS)
-└── ephemeral/           # Temporary test environments
+│   └── <api-group>/     // API endpoints grouped by domain
+├── tasks/               // Scheduled jobs
+├── triggers/            // Event-driven handlers
+├── agents/              // AI agents
+├── tools/               // AI tools
+├── mcp_servers/         // MCP server definitions
+├── addons/              // Query addons
+├── static/              // Frontend files (HTML, CSS, JS)
+└── ephemeral/           // Temporary test environments
 ```
 
 ## Environment Variables
@@ -55,28 +57,36 @@ Custom environment variables are set in the Xano dashboard and accessed as `$env
 ### Block Structure
 ```xs
 <construct> "<name>" {
-  input { ... }      # Parameters (optional)
-  stack { ... }      # Logic
-  response = $var    # Output
+  input { ... }      // Parameters (optional)
+  stack { ... }      // Logic
+  response = $var    // Output
 }
 ```
 
 ### Variable Access
 ```xs
-$input.field        # Input parameters
-$var.field          # Stack variables
-$auth.id            # Authenticated user ID
-$env.MY_VAR         # Environment variable
-$db.table.field     # Database field reference (in queries)
-$this               # Current item in loops/maps
+$input.field        // Input parameters
+$var.field          // Stack variables
+$auth.id            // Authenticated user ID
+$env.MY_VAR         // Environment variable
+$db.table.field     // Database field reference (in queries)
+$this               // Current item in loops/maps
 ```
 
+### Comments
+```xs
+// Single-line comment
+var $total { value = 0 }  // Inline comment
+```
+
+**Note:** XanoScript only supports `//` for comments. Other comment styles like `#` are not supported.
+
 ### Filters (Pipe Syntax)
 ```xs
-$value|trim|lower                    # Chain filters
-$input.name|strlen                   # Get length
-$array|first                         # First element
-($a + $b)|round:2                    # Math with precision
+$value|trim|lower                    // Chain filters
+$input.name|strlen                   // Get length
+$array|first                         // First element
+($a + $b)|round:2                    // Math with precision
 ```
 
 ## File Frontmatter

package/xanoscript_docs/agents.md

@@ -71,10 +71,10 @@ ai.agent.run "Customer Support" {
 
 ```xs
 llm = {
-  type: "<provider>"                    # Required
-  system_prompt: "..."                  # Agent persona and rules
-  prompt: "{{ $args.input }}"           # User input template
-  max_steps: 5                          # Max LLM calls per run
+  type: "<provider>"                    // Required
+  system_prompt: "..."                  // Agent persona and rules
+  prompt: "{{ $args.input }}"           // User input template
+  max_steps: 5                          // Max LLM calls per run
 }
 ```
 
@@ -94,7 +94,7 @@ llm = {
   prompt: "{{ $args.message }}"
   max_steps: 3
   temperature: 0
-  search_grounding: false               # Google Search grounding
+  search_grounding: false               // Google Search grounding
 }
 ```
 
@@ -108,7 +108,7 @@ llm = {
   prompt: "{{ $args.message }}"
   max_steps: 5
   temperature: 0.2
-  thinking_tokens: 10000                # Extended thinking
+  thinking_tokens: 10000                // Extended thinking
   include_thoughts: true
 }
 ```
@@ -123,7 +123,7 @@ llm = {
   prompt: "{{ $args.message }}"
   max_steps: 5
   temperature: 0.8
-  reasoning_effort: "medium"            # low, medium, high
+  reasoning_effort: "medium"            // low, medium, high
 }
 ```
 
@@ -134,7 +134,7 @@ llm = {
   api_key: "{{ $env.GROQ_API_KEY }}"
   baseURL: "https://api.groq.com/openai/v1"
   model: "llama-3.3-70b-versatile"
-  compatibility: "compatible"           # Required for non-OpenAI
+  compatibility: "compatible"           // Required for non-OpenAI
   ...
 }
 ```
@@ -151,7 +151,7 @@ llm = {
   prompt: "{{ $args.message }}"
   max_steps: 8
   temperature: 0.3
-  send_reasoning: true                  # Include thinking blocks
+  send_reasoning: true                  // Include thinking blocks
 }
 ```
 
@@ -218,9 +218,9 @@ llm = {
 
 ### Available Variables
 ```xs
-{{ $args.any_arg }}                     # Runtime arguments
-{{ $env.MY_VAR }}                       # Environment variables
-{{ "now"|date("Y-m-d") }}               # Current date
+{{ $args.any_arg }}                     // Runtime arguments
+{{ $env.MY_VAR }}                       // Environment variables
+{{ "now"|date("Y-m-d") }}               // Current date
 ```
 
 ---

package/xanoscript_docs/apis.md

@@ -9,19 +9,19 @@ HTTP endpoint definitions in XanoScript.
 ## Quick Reference
 
 ```xs
-query "<name>" verb=<METHOD> {
-  api_group = "<GroupName>"     # Required: API group for organization
+query "endpoint-path" verb=<METHOD> {
+  api_group = "<GroupName>"     // Required: API group for organization
   description = "What this endpoint does"
-  auth = "<table>"              # Optional: require authentication
+  auth = "<table>"              // Optional: require authentication
   input { ... }
   stack { ... }
   response = $result
 }
 ```
 
-### Query Name (Required)
+### Query Name (Required, Non-Empty)
 
-The query name is **required** and cannot be empty. It defines the endpoint path after the API group canonical.
+The query name is **required** and **must be a non-empty string**. Empty names (`query "" verb=...`) are invalid. The name defines the endpoint path after the API group canonical.
 
 **Full URL path structure:**
 ```
@@ -42,8 +42,8 @@ Every endpoint must belong to an API group. Each group is a folder with an `api_
 
 ```xs
 api_group "users" {
-  canonical = "users"                # Required: URL path segment
-  description = "User management"    # Optional
+  canonical = "users"                // Required: URL path segment
+  description = "User management"    // Optional
 }
 ```
 
@@ -51,12 +51,12 @@ api_group "users" {
 ```
 apis/
 ├── users/
-│   ├── api_group.xs            # Defines group (canonical = "users")
-│   ├── list.xs                 # GET /users/list
-│   └── by-id.xs                # GET/PATCH/DELETE /users/{id}
+│   ├── api_group.xs            // Defines group (canonical = "users")
+│   ├── list.xs                 // GET /users/list
+│   └── by-id.xs                // GET/PATCH/DELETE /users/{id}
 └── products/
-    ├── api_group.xs            # Defines group (canonical = "products")
-    └── search.xs               # GET /products/search
+    ├── api_group.xs            // Defines group (canonical = "products")
+    └── search.xs               // GET /products/search
 ```
 
 Full URL: `/<canonical>/<query name>` (e.g., `/users/profile`)
@@ -99,11 +99,11 @@ query "status" verb=GET {
 ```xs
 query "profile" verb=GET {
   api_group = "Users"
-  auth = "user"                 # Requires valid JWT
+  auth = "user"                 // Requires valid JWT
   stack {
     db.get "user" {
       field_name = "id"
-      field_value = $auth.id    # User ID from token
+      field_value = $auth.id    // User ID from token
     } as $user
   }
   response = $user

package/xanoscript_docs/database.md

@@ -35,7 +35,7 @@ db.query "product" {
 
 ### Where Operators
 ```xs
-# Comparison
+// Comparison
 $db.product.price == 100
 $db.product.price != 0
 $db.product.price > 50
@@ -43,32 +43,32 @@ $db.product.price >= 50
 $db.product.price < 100
 $db.product.price <= 100
 
-# Null-safe (ignore if value is null)
+// Null-safe (ignore if value is null)
 $db.product.category ==? $input.category
 $db.product.price >=? $input.min_price
 
-# String matching
-$db.product.name includes "phone"       # Contains substring
-$db.product.tags contains "featured"    # Array contains value
+// String matching
+$db.product.name includes "phone"       // Contains substring
+$db.product.tags contains "featured"    // Array contains value
 $db.product.tags not contains "hidden"
 
-# Array overlap
+// Array overlap
 $db.product.tags overlaps ["a", "b"]
 $db.product.tags not overlaps ["x", "y"]
 
-# Combining conditions
+// Combining conditions
 $db.product.is_active == true && $db.product.price > 0
 $db.product.category == "electronics" || $db.product.featured == true
 ```
 
 ### Return Types
 ```xs
-# List (default)
+// List (default)
 db.query "product" {
   return = { type: "list" }
 } as $products
 
-# With pagination
+// With pagination
 db.query "product" {
   return = {
     type: "list",
@@ -76,19 +76,19 @@ db.query "product" {
   }
 } as $products
 
-# Single record
+// Single record
 db.query "product" {
   where = $db.product.sku == $input.sku
   return = { type: "single" }
 } as $product
 
-# Count
+// Count
 db.query "product" {
   where = $db.product.is_active == true
   return = { type: "count" }
 } as $count
 
-# Exists
+// Exists
 db.query "product" {
   where = $db.product.email == $input.email
   return = { type: "exists" }
@@ -98,9 +98,9 @@ db.query "product" {
 ### Sorting
 ```xs
 db.query "product" {
-  sort = { created_at: "desc" }         # Descending
-  sort = { name: "asc" }                # Ascending
-  sort = { id: "rand" }                 # Random
+  sort = { created_at: "desc" }         // Descending
+  sort = { name: "asc" }                // Ascending
+  sort = { id: "rand" }                 // Random
 } as $products
 ```
 
@@ -110,7 +110,7 @@ db.query "comment" {
   join = {
     post: {
       table: "post",
-      type: "inner",                    # inner, left, right
+      type: "inner",                    // inner, left, right
       where: $db.comment.post_id == $db.post.id
     }
   }
@@ -279,7 +279,7 @@ Delete all records from a table.
 
 ```xs
 db.truncate "temp_data" {
-  reset = true                          # Reset auto-increment
+  reset = true                          // Reset auto-increment
 }
 ```
 
@@ -293,7 +293,7 @@ Execute raw SQL (use sparingly).
 db.direct_query {
   sql = "SELECT * FROM users WHERE email = ? AND status = ?"
   arg = [$input.email, "active"]
-  response_type = "list"                # list or single
+  response_type = "list"                // list or single
 } as $results
 ```
 
@@ -339,9 +339,9 @@ Filters for use in `where` clauses:
 
 ### String/Text
 ```xs
-$db.name|to_lower                       # Case conversion
-$db.name|concat:" "                     # Concatenation
-$db.text|substr:0:100                   # Substring
+$db.name|to_lower                       // Case conversion
+$db.name|concat:" "                     // Concatenation
+$db.text|substr:0:100                   // Substring
 ```
 
 ### Numeric
@@ -363,8 +363,8 @@ $db.created_at|timestamp_subtract_hours:24
 
 ### Geographic
 ```xs
-$db.location|distance:$input.point      # Distance in meters
-$db.location|within:$input.point:1000   # Within radius
+$db.location|distance:$input.point      // Distance in meters
+$db.location|within:$input.point:1000   // Within radius
 ```
 
 ### Vector (AI/ML)
@@ -385,7 +385,7 @@ $db.content|search_rank:$input.query
 Connect to external databases:
 
 ```xs
-# PostgreSQL
+// PostgreSQL
 db.external.postgres.direct_query {
   connection_string = $env.EXTERNAL_PG_URL
   sql = "SELECT * FROM users WHERE id = ?"
@@ -393,13 +393,13 @@ db.external.postgres.direct_query {
   response_type = "single"
 } as $user
 
-# MySQL
+// MySQL
 db.external.mysql.direct_query { ... }
 
-# MS SQL
+// MS SQL
 db.external.mssql.direct_query { ... }
 
-# Oracle
+// Oracle
 db.external.oracle.direct_query { ... }
 ```
 

package/xanoscript_docs/ephemeral.md

@@ -116,8 +116,8 @@ One-time operation with setup and cleanup hooks.
 ```xs
 function "$main" {
   input {
-    json args                   # Runtime arguments
-    json pre                    # Result from $pre
+    json args                   // Runtime arguments
+    json pre                    // Result from $pre
   }
   stack {
     db.query authors {

package/xanoscript_docs/frontend.md

@@ -11,10 +11,10 @@ Static frontend development and Lovable/Supabase migration.
 ### Directory Structure
 ```
 static/
-├── index.html              # Main entry point
+├── index.html              // Main entry point
 ├── css/
 ├── js/
-│   └── api.js              # Centralized API calls
+│   └── api.js              // Centralized API calls
 └── assets/
 ```
 

package/xanoscript_docs/functions.md

@@ -15,7 +15,7 @@ function "<name>" {
     <type> <name> [filters=...] { description = "..." }
   }
   stack {
-    # Logic here
+    // Logic here
   }
   response = $result
 }
@@ -110,21 +110,21 @@ stack {
 ### Loops
 ```xs
 stack {
-  # For loop (count-based)
+  // For loop (count-based)
   for (10) {
     each as $i {
       debug.log { value = $i }
     }
   }
 
-  # Foreach (array iteration)
+  // Foreach (array iteration)
   foreach ($input.items) {
     each as $item {
       debug.log { value = $item.name }
     }
   }
 
-  # While loop
+  // While loop
   while ($counter < 5) {
     each {
       math.add $counter { value = 1 }
@@ -161,10 +161,10 @@ For complete error handling reference (preconditions, try-catch, throw, early re
 Specify what the function returns:
 
 ```xs
-response = $total                    # Single variable
-response = { success: true, data: $result }   # Object literal
-response = $items|first              # With filter
-response = null                      # No return value
+response = $total                    // Single variable
+response = { success: true, data: $result }   // Object literal
+response = $items|first              // With filter
+response = null                      // No return value
 ```
 
 ---

package/xanoscript_docs/integrations.md

@@ -182,20 +182,20 @@ cloud.elasticsearch.document {
 
 ### Key-Value Operations
 ```xs
-# Set value
+// Set value
 redis.set {
   key = "user:123:session"
   data = $session_data
-  ttl = 3600                            # Expires in 1 hour
+  ttl = 3600                            // Expires in 1 hour
 }
 
-# Get value
+// Get value
 redis.get { key = "user:123:session" } as $session
 
-# Check exists
+// Check exists
 redis.has { key = "user:123:session" } as $exists
 
-# Delete
+// Delete
 redis.del { key = "user:123:session" }
 ```
 

package/xanoscript_docs/mcp-servers.md

@@ -147,18 +147,18 @@ mcp_server "CRM" {
 ### By Domain
 ```
 mcp_servers/
-├── support.xs          # Customer support tools
-├── ecommerce.xs        # Store management
-├── analytics.xs        # Reporting and metrics
-└── admin.xs            # Administrative functions
+├── support.xs          // Customer support tools
+├── ecommerce.xs        // Store management
+├── analytics.xs        // Reporting and metrics
+└── admin.xs            // Administrative functions
 ```
 
 ### By Access Level
 ```
 mcp_servers/
-├── public.xs           # Public-facing tools
-├── authenticated.xs    # Requires auth
-└── admin.xs            # Admin-only tools
+├── public.xs           // Public-facing tools
+├── authenticated.xs    // Requires auth
+└── admin.xs            // Admin-only tools
 ```
 
 ---

package/xanoscript_docs/syntax.md

@@ -44,24 +44,24 @@ var $total { value = `$input.qty * $input.price` }
 
 ### Comparison
 ```xs
-$a == $b      # Equal
-$a != $b      # Not equal
-$a > $b       # Greater than
-$a >= $b      # Greater or equal
-$a < $b       # Less than
-$a <= $b      # Less or equal
+$a == $b      // Equal
+$a != $b      // Not equal
+$a > $b       // Greater than
+$a >= $b      // Greater or equal
+$a < $b       // Less than
+$a <= $b      // Less or equal
 ```
 
 ### Logical
 ```xs
-$a && $b      # AND
-$a || $b      # OR
-!$a           # NOT
+$a && $b      // AND
+$a || $b      // OR
+!$a           // NOT
 ```
 
 ### Null-Safe Comparisons (DB Queries)
 ```xs
-# In db.query where clauses - ignore condition if value is null
+// In db.query where clauses - ignore condition if value is null
 $db.post.category ==? $input.category
 $db.post.date >=? $input.start_date
 ```
@@ -88,11 +88,11 @@ $db.post.date >=? $input.start_date
 
 ### Array Math
 ```xs
-[1,2,3,4]|sum        # 10
-[1,2,3,4]|avg        # 2.5
-[1,2,3,4]|product    # 24
-[5,2,8,1]|array_min  # 1
-[5,2,8,1]|array_max  # 8
+[1,2,3,4]|sum        // 10
+[1,2,3,4]|avg        // 2.5
+[1,2,3,4]|product    // 24
+[5,2,8,1]|array_min  // 1
+[5,2,8,1]|array_max  // 8
 ```
 
 ### Trigonometry
@@ -123,10 +123,10 @@ $db.post.date >=? $input.start_date
 
 ### Regex
 ```xs
-"/pattern/"|regex_matches:"subject"           # Boolean match
-"/(\w+)/"|regex_get_first_match:"test"        # First match
-"/\w+/"|regex_get_all_matches:"a b c"         # All matches
-"/\s+/"|regex_replace:"-":"a  b"              # Replace: "a-b"
+"/pattern/"|regex_matches:"subject"           // Boolean match
+"/(\w+)/"|regex_get_first_match:"test"        // First match
+"/\w+/"|regex_get_all_matches:"a b c"         // All matches
+"/\s+/"|regex_replace:"-":"a  b"              // Replace: "a-b"
 ```
 
 ---
@@ -155,36 +155,36 @@ $db.post.date >=? $input.start_date
 
 ### Functional Operations
 ```xs
-# Map - transform each element
-[{v:1},{v:2}]|map:$$.v*2                    # [2,4]
+// Map - transform each element
+[{v:1},{v:2}]|map:$$.v*2                    // [2,4]
 
-# Filter - keep matching elements
-[1,2,3,4]|filter:$$%2==0                    # [2,4]
+// Filter - keep matching elements
+[1,2,3,4]|filter:$$%2==0                    // [2,4]
 
-# Find - first matching element
-[{id:1},{id:2}]|find:$$.id==2               # {id:2}
+// Find - first matching element
+[{id:1},{id:2}]|find:$$.id==2               // {id:2}
 
-# FindIndex - index of first match
-[{id:1},{id:2}]|findIndex:$$.id==2          # 1
+// FindIndex - index of first match
+[{id:1},{id:2}]|findIndex:$$.id==2          // 1
 
-# Some - any element matches?
-[1,2,3]|some:$$>2                           # true
+// Some - any element matches?
+[1,2,3]|some:$$>2                           // true
 
-# Every - all elements match?
-[2,4,6]|every:$$%2==0                       # true
+// Every - all elements match?
+[2,4,6]|every:$$%2==0                       // true
 
-# Reduce - accumulate to single value
-[1,2,3,4]|reduce:$$+$result:0               # 10
+// Reduce - accumulate to single value
+[1,2,3,4]|reduce:$$+$result:0               // 10
 ```
 
 ### Grouping & Indexing
 ```xs
-# Group by property
+// Group by property
 [{g:"a",v:1},{g:"b",v:2},{g:"a",v:3}]|index_by:g
-# {"a":[{g:"a",v:1},{g:"a",v:3}],"b":[{g:"b",v:2}]}
+// {"a":[{g:"a",v:1},{g:"a",v:3}],"b":[{g:"b",v:2}]}
 
-# Sort
-[{n:"z"},{n:"a"}]|sort:n:text:false         # Ascending by n
+// Sort
+[{n:"z"},{n:"a"}]|sort:n:text:false         // Ascending by n
 ```
 
 ---
@@ -205,9 +205,9 @@ $db.post.date >=? $input.start_date
 
 ### Conditional Set
 ```xs
-{a:1}|set_conditional:"b":2:true            # {a:1,b:2} if condition true
-{a:1}|set_ifnotempty:"b":"val"              # Set only if val not empty
-{a:1}|set_ifnotnull:"b":$var                # Set only if $var not null
+{a:1}|set_conditional:"b":2:true            // {a:1,b:2} if condition true
+{a:1}|set_ifnotempty:"b":"val"              // Set only if val not empty
+{a:1}|set_ifnotnull:"b":$var                // Set only if $var not null
 ```
 
 ---
@@ -229,8 +229,8 @@ $db.post.date >=? $input.start_date
 
 ### Null Handling
 ```xs
-null|first_notnull:0                        # 0
-""|first_notempty:"default"                 # "default"
+null|first_notnull:0                        // 0
+""|first_notempty:"default"                 // "default"
 ```
 
 ---
@@ -249,12 +249,12 @@ null|first_notnull:0                        # 0
 
 ### Timestamp Parts
 ```xs
-$ts|timestamp_year           # Year
-$ts|timestamp_month          # Month (1-12)
-$ts|timestamp_day_of_month   # Day (1-31)
-$ts|timestamp_hour           # Hour (0-23)
-$ts|timestamp_minute         # Minute (0-59)
-$ts|timestamp_day_of_week    # Day (0=Sunday)
+$ts|timestamp_year           // Year
+$ts|timestamp_month          // Month (1-12)
+$ts|timestamp_day_of_month   // Day (1-31)
+$ts|timestamp_hour           // Hour (0-23)
+$ts|timestamp_minute         // Minute (0-59)
+$ts|timestamp_day_of_week    // Day (0=Sunday)
 ```
 
 ---

package/xanoscript_docs/tables.md

@@ -10,9 +10,9 @@ Database table definitions in XanoScript.
 
 ```xs
 table "<name>" {
-  auth = false                    # true if used for authentication
+  auth = false                    // true if used for authentication
   schema {
-    int id                        # Primary key (required)
+    int id                        // Primary key (required)
     text name filters=trim
     timestamp created_at?=now
   }
@@ -72,10 +72,10 @@ schema {
 ### Optional & Defaults
 ```xs
 schema {
-  text nickname?                   # Optional, no default
-  timestamp created_at?=now        # Optional, defaults to current time
-  bool is_active?=true             # Optional, defaults to true
-  int status?=0                    # Optional, defaults to 0
+  text nickname?                   // Optional, no default
+  timestamp created_at?=now        // Optional, defaults to current time
+  bool is_active?=true             // Optional, defaults to true
+  int status?=0                    // Optional, defaults to 0
 }
 ```
 
@@ -139,7 +139,7 @@ schema {
 ### Vector Fields
 ```xs
 schema {
-  vector embedding              # For AI/ML embeddings
+  vector embedding              // For AI/ML embeddings
 }
 ```
 

package/xanoscript_docs/tasks.md

@@ -222,7 +222,7 @@ task "risky_sync" {
           url = "https://external-api.com/data"
           method = "GET"
         } as $data
-        # Process data...
+        // Process data...
       }
       catch {
         util.send_email {

package/xanoscript_docs/triggers.md

@@ -34,11 +34,11 @@ table_trigger "<name>" {
   tags = ["tag1", "tag2"]
 
   input {
-    # Define input parameters
+    // Define input parameters
   }
 
   stack {
-    # Logic to execute when triggered
+    // Logic to execute when triggered
   }
 
   history = 100
@@ -118,11 +118,11 @@ realtime_trigger "<name>" {
   tags = ["tag1", "tag2"]
 
   input {
-    # Define input parameters
+    // Define input parameters
   }
 
   stack {
-    # Logic to execute when triggered
+    // Logic to execute when triggered
   }
 
   response = $result
@@ -211,11 +211,11 @@ workspace_trigger "<name>" {
   tags = ["tag1", "tag2"]
 
   input {
-    # Define input parameters
+    // Define input parameters
   }
 
   stack {
-    # Logic to execute when triggered
+    // Logic to execute when triggered
   }
 
   history = 100
@@ -292,11 +292,11 @@ agent_trigger "<name>" {
   tags = ["tag1", "tag2"]
 
   input {
-    # Define input parameters
+    // Define input parameters
   }
 
   stack {
-    # Logic to execute when triggered
+    // Logic to execute when triggered
   }
 
   response = $result
@@ -383,11 +383,11 @@ mcp_server_trigger "<name>" {
   tags = ["tag1", "tag2"]
 
   input {
-    # Define input parameters
+    // Define input parameters
   }
 
   stack {
-    # Logic to execute when triggered
+    // Logic to execute when triggered
   }
 
   response = $result

package/xanoscript_docs/types.md

@@ -68,8 +68,8 @@ Access inputs in stack: `$input.username`, `$input.age`
 
 ### text
 ```xs
-text name filters=trim|lower           # With filters
-text bio? filters=max:500              # Optional, max 500 chars
+text name filters=trim|lower           // With filters
+text bio? filters=max:500              // Optional, max 500 chars
 ```
 
 ### int / decimal
@@ -80,7 +80,7 @@ decimal price filters=min:0.01
 
 ### bool
 ```xs
-bool is_active?=true                   # Defaults to true
+bool is_active?=true                   // Defaults to true
 bool confirmed?=false
 ```
 
@@ -93,25 +93,25 @@ email contact filters=trim|lower {
 
 ### password
 ```xs
-password secret filters=min:8          # Minimum 8 characters
+password secret filters=min:8          // Minimum 8 characters
 ```
 
 ### timestamp / date
 ```xs
-timestamp created_at?=now              # Defaults to current time
+timestamp created_at?=now              // Defaults to current time
 date birth_date
 ```
 
 ### uuid
 ```xs
 uuid session_id
-uuid user_id { table = "user" }        # Foreign key reference
+uuid user_id { table = "user" }        // Foreign key reference
 ```
 
 ### json
 ```xs
-json metadata                          # Any JSON structure
-json settings?={}                      # Default empty object
+json metadata                          // Any JSON structure
+json settings?={}                      // Default empty object
 ```
 
 ### enum
@@ -140,8 +140,8 @@ object address {
 
 ### Arrays
 ```xs
-text[] tags filters=trim|lower         # Array of trimmed lowercase strings
-int[1:10] scores filters=min:0|max:100 # 1-10 integers between 0-100
+text[] tags filters=trim|lower         // Array of trimmed lowercase strings
+int[1:10] scores filters=min:0|max:100 // 1-10 integers between 0-100
 object[] items {
   schema {
     int id
@@ -212,19 +212,19 @@ input {
 
 ```xs
 input {
-  # Required, cannot be null
+  // Required, cannot be null
   text required_field
 
-  # Required, can be null (must provide, can send null)
+  // Required, can be null (must provide, can send null)
   text? nullable_field
 
-  # Optional, cannot be null (can omit, but if sent must have value)
+  // Optional, cannot be null (can omit, but if sent must have value)
   text optional_field?
 
-  # Optional, can be null (can omit or send null)
+  // Optional, can be null (can omit or send null)
   text? nullable_optional?
 
-  # Optional with default
+  // Optional with default
   text with_default?="hello"
 }
 ```