@xcitedbs/client 0.2.14 → 0.2.15

package/llms-full.txt

@@ -613,6 +613,8 @@ Unquery supports: hierarchical navigation (self, parents, ancestors, children, d
 
 The `unquery` body is a **JSON template**: each **object key** names an output field; each **value** is either a nested object/array (recursed) or a **string parsed as an expression**. Arrays produce JSON arrays in order.
 
+**Parser-faithful grammar / AST** (for syntax checking, static typing, and tooling): see **`unquery-grammar.md`** shipped next to this file in SDK packages (canonical document in the XciteDB-server repository: `docs/unquery-grammar.md`). The MCP server also exposes it as the resource URI **`xcitedb://unquery-grammar`**.
+
 ### Core expression builtins (string values)
 
 - **Document / path:** `$identifier`, `$identifier(n)` (path segment by index), `$key`, `$index`, `$path`

package/llms.txt

@@ -301,7 +301,7 @@ interface XCiteDBClientOptions {
 
 - JSON **keys** = output fields; **string values** = expressions referencing meta/XML (e.g. field name `"title"` reads meta key `title`).
 - **Common builtins:** `$count`, `$sum(expr)`, `$avg(expr)`, `$min(expr)`, `$max(expr)`, `$xpath("…")`, `$identifier`, `$size(expr)`, `$length(expr)`, `$if(cond, a, b)`, `$var(name)` / `%name`.
-- **Example:** `{ "query": { "match_start": "/orders/" }, "unquery": { "n": "$count" } }` — count documents. Full grammar: **`llms-full.txt`** in this package.
+- **Example:** `{ "query": { "match_start": "/orders/" }, "unquery": { "n": "$count" } }` — count documents. Human-oriented reference: **`llms-full.txt`** in this package. **AI-first writing guide (read this before generating any Unquery query):** **`unquery-ai-guide.md`** (canonical source in the server repo: `docs/unquery-ai-guide.md`; MCP resource `xcitedb://unquery-guide`). **Parser-faithful grammar / parse tree** (syntax + static checks for tooling): **`unquery-grammar.md`** (canonical: `docs/unquery-grammar.md`; MCP resource `xcitedb://unquery-grammar`).
 
 **App Users (admin):**
 - `listAppUsers()` / `createAppUser()` / `deleteAppUser()` — Manage end-user accounts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xcitedbs/client",
-  "version": "0.2.14",
+  "version": "0.2.15",
   "description": "XCiteDB BaaS client SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -41,7 +41,9 @@
   "files": [
     "dist",
     "llms.txt",
-    "llms-full.txt"
+    "llms-full.txt",
+    "unquery-grammar.md",
+    "unquery-ai-guide.md"
   ],
   "license": "MIT"
 }