@xano/developer-mcp 1.0.31 → 1.0.33

package/dist/xanoscript_docs/agents.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "agents/**/*.xs"
+applyTo: "agent/**/*.xs"
 ---
 
 # Agents
@@ -186,7 +186,7 @@ agent "Classifier" {
 
 ## Tools
 
-Reference tools by name from `tools/` directory:
+Reference tools by name from `tool/` directory:
 
 ```xs
 tools = [

package/dist/xanoscript_docs/apis.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "apis/**/*.xs"
+applyTo: "api/**/*.xs"
 ---
 
 # APIs
@@ -77,16 +77,18 @@ api_group Authentication {
 ### File Structure
 
 ```
-apis/
+api/
 ├── users/
-│   ├── api_group.xs            // Defines group (canonical = "myapp-users")
-│   ├── list.xs                 // GET /myapp-users/list
-│   └── by-id.xs                // GET/PATCH/DELETE /myapp-users/{id}
+│   ├── api_group.xs            # Defines group (canonical = "myapp-users")
+│   ├── list_get.xs             # GET /myapp-users/list
+│   └── by_id_get.xs            # GET /myapp-users/{id}
 └── products/
-    ├── api_group.xs            // Defines group (canonical = "myapp-products")
-    └── search.xs               // GET /myapp-products/search
+    ├── api_group.xs            # Defines group (canonical = "myapp-products")
+    └── search_get.xs           # GET /myapp-products/search
 ```
 
+**Naming convention:** Endpoint files use `{name}_{verb}.xs` format (e.g., `list_get.xs`, `create_post.xs`).
+
 Full URL: `/<canonical>/<query name>` (e.g., `/myapp-users/profile`)
 
 ---

package/dist/xanoscript_docs/branch.md

@@ -222,10 +222,11 @@ Branch configuration files are typically named `branch.xs` and placed at the wor
 
 ```
 project/
-├── branch.xs              // Branch configuration
-├── tables/
-├── functions/
-└── apis/
+├── branch.xs              # Branch configuration
+├── workspace/
+├── table/
+├── function/
+└── api/
 ```
 
 ---

package/dist/xanoscript_docs/database.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "functions/**/*.xs, apis/**/*.xs, tasks/*.xs, tools/**/*.xs"
+applyTo: "function/**/*.xs, api/**/*.xs, task/**/*.xs, tool/**/*.xs"
 ---
 
 # Database Operations

package/dist/xanoscript_docs/functions.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "functions/**/*.xs"
+applyTo: "function/**/*.xs"
 ---
 
 # Functions
@@ -62,7 +62,7 @@ function "calculate_total" {
 Functions can be organized in subfolders:
 
 ```
-functions/
+function/
 ├── math/
 │   ├── add.xs
 │   └── multiply.xs

package/dist/xanoscript_docs/integrations.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "functions/**/*.xs, apis/**/*.xs, tasks/*.xs"
+applyTo: "function/**/*.xs, api/**/*.xs, task/**/*.xs"
 ---
 
 # Integrations

package/dist/xanoscript_docs/mcp-servers.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "mcp_servers/**/*.xs"
+applyTo: "mcp_server/**/*.xs"
 ---
 
 # MCP Servers
@@ -52,7 +52,7 @@ mcp_server "Customer Support" {
 
 ## Tools Block
 
-Reference tools from `tools/` directory by name:
+Reference tools from `tool/` directory by name:
 
 ```xs
 tools = [
@@ -62,7 +62,7 @@ tools = [
 ]
 ```
 
-Tool names must exactly match `.xs` file names in `tools/`.
+Tool names must exactly match `.xs` file names in `tool/`.
 
 ---
 
@@ -146,19 +146,19 @@ 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
+mcp_server/
+├── 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
+mcp_server/
+├── public.xs           # Public-facing tools
+├── authenticated.xs    # Requires auth
+└── admin.xs            # Admin-only tools
 ```
 
 ---

package/dist/xanoscript_docs/performance.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "functions/**/*.xs, apis/**/*.xs"
+applyTo: "function/**/*.xs, api/**/*.xs"
 ---
 
 # Performance Optimization

package/dist/xanoscript_docs/realtime.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "functions/**/*.xs, apis/**/*.xs, triggers/**/*.xs"
+applyTo: "function/**/*.xs, api/**/*.xs, */trigger/**/*.xs"
 ---
 
 # Realtime

package/dist/xanoscript_docs/run.md

@@ -16,9 +16,9 @@ Define job and service configurations for the Xano Job Runner.
 ### Directory Structure
 ```
 run.xs
-tables/
-functions/
-apis/
+table/
+function/
+api/
 ```
 
 ---
@@ -216,9 +216,9 @@ function "process_data" {
 
 ```
 run.xs
-tables/
+table/
 └── users.xs
-functions/
+function/
 └── migrate_users.xs
 ```
 
@@ -235,7 +235,7 @@ run.job "Data Migration" {
 }
 ```
 
-### tables/users.xs
+### table/users.xs
 ```xs
 table users {
   auth = false
@@ -255,7 +255,7 @@ table users {
 }
 ```
 
-### functions/migrate_users.xs
+### function/migrate_users.xs
 ```xs
 function "migrate_users" {
   input {
@@ -287,12 +287,13 @@ function "migrate_users" {
 
 ```
 run.xs
-tables/
+table/
 └── event.xs
-apis/
-├── api_group.xs
-├── list.xs
-└── add.xs
+api/
+└── events/
+    ├── api_group.xs
+    ├── list_get.xs
+    └── add_post.xs
 ```
 
 ### run.xs
@@ -306,7 +307,7 @@ run.service "Event Tracker" {
 }
 ```
 
-### tables/event.xs
+### table/event.xs
 ```xs
 table event {
   auth = false
@@ -322,7 +323,7 @@ table event {
 }
 ```
 
-### apis/list.xs
+### api/events/list_get.xs
 ```xs
 query list verb=GET {
   api_group = "events"

package/dist/xanoscript_docs/schema.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "functions/**/*.xs, apis/**/*.xs"
+applyTo: "function/**/*.xs, api/**/*.xs"
 ---
 
 # Schema Operations

package/dist/xanoscript_docs/security.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "functions/**/*.xs, apis/**/*.xs"
+applyTo: "function/**/*.xs, api/**/*.xs"
 ---
 
 # Security

package/dist/xanoscript_docs/streaming.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "functions/**/*.xs, apis/**/*.xs"
+applyTo: "function/**/*.xs, api/**/*.xs"
 ---
 
 # Streaming Operations
@@ -8,32 +8,35 @@ Stream data from files, requests, and to API responses.
 
 ## Quick Reference
 
-| Operation | Purpose | Input |
-|-----------|---------|-------|
-| `stream.from_csv` | Parse CSV stream | File or string |
-| `stream.from_jsonl` | Parse JSONL stream | File or string |
-| `stream.from_request` | Stream HTTP request body | Request |
-| `api.stream` | Stream response to client | Data |
+| Operation             | Purpose                   | Input          |
+| --------------------- | ------------------------- | -------------- |
+| `stream.from_csv`     | Parse CSV stream          | File or string |
+| `stream.from_jsonl`   | Parse JSONL stream        | File or string |
+| `stream.from_request` | Stream HTTP request body  | Request        |
+| `api.stream`          | Stream response to client | Data           |
 
 ---
 
 ## stream.from_csv
 
-Parse CSV data as a stream, processing rows one at a time without loading entire file into memory.
+Parse CSV data as a stream. Returns a stream value (like a generator) that is then iterated with `foreach`.
 
 ```xs
 stream.from_csv {
   value = $input.csv_file
-  headers = true
-  delimiter = ","
-  enclosure = "\""
-} as $row {
-  // Process each row
-  db.add "import_record" {
-    data = {
-      name: $row.name,
-      email: $row.email,
-      created_at: now
+  separator = ","
+  enclosure = '"'
+  escape_char = '"'
+} as $stream
+
+foreach ($stream) {
+  each as $row {
+    db.add "import_record" {
+      data = {
+        name: $row.name,
+        email: $row.email,
+        created_at: now
+      }
     }
   }
 }
@@ -41,13 +44,13 @@ stream.from_csv {
 
 ### Parameters
 
-| Parameter | Type | Default | Description |
-|-----------|------|---------|-------------|
-| `value` | file/text | required | CSV file or string |
-| `headers` | bool | `true` | First row contains headers |
-| `delimiter` | text | `,` | Field delimiter |
-| `enclosure` | text | `"` | Field enclosure character |
-| `escape` | text | `\` | Escape character |
+| Parameter     | Type      | Default  | Description                |
+| ------------- | --------- | -------- | -------------------------- |
+| `value`       | file/text | required | CSV file or string         |
+| `headers`     | bool      | `true`   | First row contains headers |
+| `separator`   | text      | `,`      | Field separator            |
+| `enclosure`   | text      | `"`      | Field enclosure character  |
+| `escape_char` | text      | `"`      | Escape character           |
 
 ### With Custom Headers
 
@@ -55,10 +58,14 @@ stream.from_csv {
 stream.from_csv {
   value = $input.file
   headers = false
-} as $row {
-  // Access by index: $row.0, $row.1, etc.
-  var $name { value = $row.0 }
-  var $email { value = $row.1 }
+} as $stream
+
+foreach ($stream) {
+  each as $row {
+    // Access by index: $row.0, $row.1, etc.
+    var $name { value = $row.0 }
+    var $email { value = $row.1 }
+  }
 }
 ```
 
@@ -66,18 +73,21 @@ stream.from_csv {
 
 ## stream.from_jsonl
 
-Parse JSON Lines (newline-delimited JSON) as a stream.
+Parse JSON Lines (newline-delimited JSON) as a stream. Returns a stream value iterated with `foreach`.
 
 ```xs
 stream.from_jsonl {
   value = $input.jsonl_file
-} as $record {
-  // Each $record is a parsed JSON object
-  db.add "event" {
-    data = {
-      event_type: $record.type,
-      payload: $record.data,
-      timestamp: $record.ts
+} as $stream
+
+foreach ($stream) {
+  each as $record {
+    db.add "event" {
+      data = {
+        event_type: $record.type,
+        payload: $record.data,
+        timestamp: $record.ts
+      }
     }
   }
 }
@@ -85,9 +95,9 @@ stream.from_jsonl {
 
 ### Parameters
 
-| Parameter | Type | Default | Description |
-|-----------|------|---------|-------------|
-| `value` | file/text | required | JSONL file or string |
+| Parameter | Type      | Default  | Description          |
+| --------- | --------- | -------- | -------------------- |
+| `value`   | file/text | required | JSONL file or string |
 
 ### Example JSONL Format
 
@@ -101,24 +111,27 @@ stream.from_jsonl {
 
 ## stream.from_request
 
-Stream the incoming HTTP request body for large uploads.
+Stream the incoming HTTP request body for large uploads. Returns a stream value iterated with `foreach`.
 
 ```xs
 stream.from_request {
   format = "jsonl"
-} as $record {
-  // Process streamed data
-  db.add "log" { data = $record }
+} as $stream
+
+foreach ($stream) {
+  each as $record {
+    db.add "log" { data = $record }
+  }
 }
 ```
 
 ### Parameters
 
-| Parameter | Type | Options | Description |
-|-----------|------|---------|-------------|
-| `format` | text | `jsonl`, `csv`, `raw` | Body format |
-| `headers` | bool | `true` (csv) | CSV has headers |
-| `delimiter` | text | `,` (csv) | CSV delimiter |
+| Parameter   | Type | Options               | Description     |
+| ----------- | ---- | --------------------- | --------------- |
+| `format`    | text | `jsonl`, `csv`, `raw` | Body format     |
+| `headers`   | bool | `true` (csv)          | CSV has headers |
+| `separator` | text | `,` (csv)             | CSV separator   |
 
 ### Raw Chunks
 
@@ -126,11 +139,14 @@ stream.from_request {
 stream.from_request {
   format = "raw"
   chunk_size = 8192
-} as $chunk {
-  // Process raw bytes
-  storage.append_file {
-    pathname = "uploads/large_file.bin"
-    data = $chunk
+} as $stream
+
+foreach ($stream) {
+  each as $chunk {
+    storage.append_file {
+      pathname = "uploads/large_file.bin"
+      data = $chunk
+    }
   }
 }
 ```
@@ -207,12 +223,12 @@ query "live_updates" {
 
 ### Parameters
 
-| Parameter | Type | Options | Description |
-|-----------|------|---------|-------------|
-| `format` | text | `jsonl`, `csv`, `sse`, `raw` | Stream format |
-| `value` | stream | optional | Data source for jsonl/csv |
-| `headers` | text[] | optional | CSV column headers |
-| `filename` | text | optional | Suggested download filename |
+| Parameter  | Type   | Options                      | Description                 |
+| ---------- | ------ | ---------------------------- | --------------------------- |
+| `format`   | text   | `jsonl`, `csv`, `sse`, `raw` | Stream format               |
+| `value`    | stream | optional                     | Data source for jsonl/csv   |
+| `headers`  | text[] | optional                     | CSV column headers          |
+| `filename` | text   | optional                     | Suggested download filename |
 
 ---
 
@@ -222,31 +238,35 @@ query "live_updates" {
 
 ```xs
 function "import_large_csv" {
-  input {
-    file csv_file
-  }
+  input { file csv_file }
   stack {
     var $processed { value = 0 }
     var $errors { value = [] }
 
     stream.from_csv {
       value = $input.csv_file
-      headers = true
-    } as $row {
-      try_catch {
-        try {
-          db.add "record" {
-            data = {
-              name: $row.name|trim,
-              email: $row.email|trim|lower,
-              created_at: now
+      separator = ","
+      enclosure = '"'
+      escape_char = '"'
+    } as $stream
+
+    foreach ($stream) {
+      each as $row {
+        try_catch {
+          try {
+            db.add "record" {
+              data = {
+                name: $row.name|trim,
+                email: $row.email|trim|lower,
+                created_at: now
+              }
             }
+            math.add $processed { value = 1 }
           }
-          math.add $processed { value = 1 }
-        }
-        catch {
-          var.update $errors {
-            value = $errors|push:{ row: $processed, error: $error.message }
+          catch {
+            var.update $errors {
+              value = $errors|push:{ row: $processed, error: $error.message }
+            }
           }
         }
       }
@@ -260,26 +280,28 @@ function "import_large_csv" {
 
 ```xs
 function "etl_events" {
-  input {
-    file events_file
-  }
+  input { file events_file }
   stack {
     stream.from_jsonl {
       value = $input.events_file
-    } as $event {
-      // Transform
-      var $transformed {
-        value = {
-          event_type: $event.type|to_lower,
-          user_id: $event.user_id|to_int,
-          metadata: $event.data|json_encode,
-          occurred_at: $event.timestamp|to_timestamp
+    } as $stream
+
+    foreach ($stream) {
+      each as $event {
+        // Transform
+        var $transformed {
+          value = {
+            event_type: $event.type|to_lower,
+            user_id: $event.user_id|to_int,
+            metadata: $event.data|json_encode,
+            occurred_at: $event.timestamp|to_timestamp
+          }
         }
-      }
 
-      // Load
-      db.add "processed_event" {
-        data = $transformed
+        // Load
+        db.add "processed_event" {
+          data = $transformed
+        }
       }
     }
   }

package/dist/xanoscript_docs/tables.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "tables/*.xs"
+applyTo: "table/**/*.xs"
 ---
 
 # Tables

package/dist/xanoscript_docs/tasks.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "tasks/*.xs"
+applyTo: "task/**/*.xs"
 ---
 
 # Tasks
@@ -17,13 +17,14 @@ task "<name>" {
 ```
 
 ### Common Frequencies
-| Interval | Seconds |
-|----------|---------|
-| 1 minute | 60 |
-| 5 minutes | 300 |
-| 1 hour | 3600 |
-| Daily | 86400 |
-| Weekly | 604800 |
+
+| Interval  | Seconds |
+| --------- | ------- |
+| 1 minute  | 60      |
+| 5 minutes | 300     |
+| 1 hour    | 3600    |
+| Daily     | 86400   |
+| Weekly    | 604800  |
 
 ---
 
@@ -57,11 +58,13 @@ task "daily_cleanup" {
 ## Schedule Configuration
 
 ### Single Event
+
 ```xs
 schedule = [{starts_on: 2025-06-15 09:00:00+0000, freq: 86400}]
 ```
 
 ### With End Date
+
 ```xs
 schedule = [{
   starts_on: 2025-01-01 08:00:00+0000,
@@ -71,6 +74,7 @@ schedule = [{
 ```
 
 ### Multiple Schedules
+
 ```xs
 schedule = [
   {starts_on: 2025-01-01 09:00:00+0000, freq: 86400},
@@ -83,6 +87,7 @@ schedule = [
 ## Common Patterns
 
 ### Data Aggregation
+
 ```xs
 task "hourly_stats" {
   description = "Aggregate hourly statistics"
@@ -106,6 +111,7 @@ task "hourly_stats" {
 ```
 
 ### Cleanup Job
+
 ```xs
 task "cleanup_temp_files" {
   description = "Delete temporary files older than 24 hours"
@@ -131,6 +137,7 @@ task "cleanup_temp_files" {
 ```
 
 ### Notification Job
+
 ```xs
 task "daily_digest" {
   description = "Send daily digest emails"
@@ -166,6 +173,7 @@ task "daily_digest" {
 ```
 
 ### External API Sync
+
 ```xs
 task "sync_exchange_rates" {
   description = "Sync currency exchange rates every hour"

package/dist/xanoscript_docs/testing.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "functions/**/*.xs, apis/**/*.xs"
+applyTo: "function/**/*.xs, api/**/*.xs"
 ---
 
 # Testing