@xano/xanoscript-language-server 12.23.0 → 12.25.0

package/lexer/tokens.js

@@ -134,7 +134,6 @@ import {
   RealtimeTriggerTokens,
 } from "./realtime_trigger.js";
 import { mapTokenToType as mapRedisTokenToType, RedisTokens } from "./redis.js";
-import { mapTokenToType as mapRunTokenToType, RunTokens } from "./run.js";
 import {
   mapTokenToType as mapSecurityTokenToType,
   SecurityTokens,
@@ -295,7 +294,7 @@ export const HistoryToken = createTokenByName("history", {
   categories: [Identifier], // could also be an identifier
 });
 
-// `mesh0 = {logging, statements}` on objects and containers.
+// `mesh0 = {logging}` on objects and containers.
 export const Mesh0Token = createTokenByName("mesh0", {
   longer_alt: Identifier,
   categories: [Identifier], // could also be an identifier
@@ -469,7 +468,6 @@ export const allTokens = uniq([
   ...DbTokens,
   ...RedisTokens,
   ...TextTokens,
-  ...RunTokens,
   ...ObjectTokens,
   ...StreamTokens,
   ...DatadogTokens,
@@ -536,7 +534,6 @@ const tokenMappers = [
   mapRealtimeServerTriggerTokenToType,
   mapRealtimeTriggerTokenToType,
   mapRedisTokenToType,
-  mapRunTokenToType,
   mapSecurityTokenToType,
   mapStorageTokenToType,
   mapStreamTokenToType,

package/onHover/functions.md

@@ -333,62 +333,6 @@ An `error_trigger` file defines the workspace's error-notification handler, fire
 
 Use an `error_trigger` to wire workspace-wide alerting on top of the error-logs system without subscribing per object or per event source.
 
-# run.job
-
-```xs
-run.job "Gemini -> Image Understanding" {
-  main = {
-    name: "Gemini -> Image Understanding"
-    input: {
-      model: "gemini-1.5-flash"
-      prompt: "Describe what is happening in this image."
-      image: "(attach image file)"
-    }
-  }
-  env = ["gemini_api_key"]
-}
-```
-
-A `run.job` file defines a job configuration for execution in the Xano Job Runner. It includes:
-
-- A name (e.g., `"Gemini -> Image Understanding"`) to identify the job,
-- A required `main` attribute specifying the function to execute:
-  - `name`: The name of the function to call,
-  - `input`: Optional input parameters to pass to the function,
-- An optional `env` array listing environment variable names required by the job.
-
-Jobs are used to run functions as standalone processes, typically for long-running or resource-intensive operations.
-
-# run.service
-
-```xs
-run.service "email proxy" {
-  pre = {
-    name: "email_proxy_init"
-    input: {
-      config: "default"
-    }
-  }
-  env = ["email_proxy_api_key"]
-}
-```
-
-A `run.service` file defines a service configuration for the Xano Job Runner. It includes:
-
-- A name (e.g., `"email proxy"`) to identify the service,
-- An optional `pre` attribute specifying an initialization function to run before the service starts:
-  - `name`: The name of the initialization function,
-  - `input`: Optional input parameters for the initialization,
-- An optional `env` array listing environment variable names required by the service.
-
-Services can also be defined in minimal form without a body:
-
-```xs
-run.service "email proxy"
-```
-
-Services are ideal for long-running background processes like proxies, webhooks listeners, or daemon-style operations.
-
 # action.call
 
 ```xs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xano/xanoscript-language-server",
-  "version": "12.23.0",
+  "version": "12.25.0",
   "description": "Language Server Protocol implementation for XanoScript, the language of Xano backends",
   "keywords": [
     "xano",

package/parser/agent_parser.js

@@ -182,6 +182,7 @@ export function agentDeclaration($) {
                 "include_thoughts",
               ],
             };
+            validFieldsPerSource["xano-ai"] = validFieldsPerSource["xano-free"];
 
             const captured = {};
             $.SUBRULE($.schemaParseObjectFn, {
@@ -193,6 +194,7 @@ export function agentDeclaration($) {
                     "azure-openai",
                     "google-genai",
                     "openai",
+                    "xano-ai",
                     "xano-free",
                   ],
                   max_steps: "[number]",

package/parser/branch_parser.js

@@ -57,7 +57,7 @@ export function branchDeclaration($) {
             "prompt?": historyValues,
             "resource?": historyValues,
           },
-          // Strict whitelist of run types, each `{logging, statements}`.
+          // Strict whitelist of run types, each `{logging}`.
           // The platform writes only the types that differ from the
           // default, and no block at all when none do.
           "mesh0?": {

package/parser/clauses/mesh0Clause.js

@@ -2,26 +2,25 @@ import { EqualToken } from "../../lexer/control.js";
 import { Mesh0Token } from "../../lexer/tokens.js";
 
 /**
- * The value set of one mesh0 setting, `{logging, statements}`, shared by the
+ * The value set of one mesh0 setting, `{logging}`, shared by the
  * object/container `mesh0 = {...}` clause and each run type of a branch
  * document's `mesh0` block (`branch_parser.js`).
  *
  * Mirrors the platform's mesh0 settings: `logging` is the trace detail
- * (`"inherit"` defers to the next level), `statements` the per-run statement
- * span cap. Unlimited is written `"all"`, as `history` writes it; the platform
- * stores it as `-1`. Both keys are optional, and a missing one inherits.
+ * (`"inherit"` defers to the next level) and is required. The per-run
+ * statement span cap is not a mesh0 key; the platform takes it from the
+ * request-history `history` setting, so a `statements` key is invalid.
  */
 export const MESH0_SETTING_SCHEMA = {
-  "logging?": ["inherit", "minimal", "light", "full"],
-  "statements?": [100, 1000, 10000, "all"],
+  logging: ["inherit", "minimal", "light", "full"],
 };
 
 /**
- * Parses the `mesh0 = {logging: "light", statements: 1000}` setting of an
- * object (query, function, task, tool, middleware, trigger, prompt, resource)
- * or a container (api_group, mcp_server, channel, realtime_server). It sits
- * beside `history`. A container presents the same two keys; the platform maps
- * them to its type-prefixed fields (`query_logging`, `tool_statements`, ...).
+ * Parses the `mesh0 = {logging: "light"}` setting of an object (query,
+ * function, task, tool, middleware, trigger, prompt, resource) or a container
+ * (api_group, mcp_server, channel, realtime_server). It sits beside
+ * `history`. A container presents the same key; the platform maps it to its
+ * type-prefixed field (`query_logging`, `tool_logging`, ...).
  *
  * @param {import('../base_parser.js').XanoBaseParser} $
  */
@@ -31,19 +30,8 @@ export function mesh0Clause($) {
     const parent = $.CONSUME(Mesh0Token); // "mesh0"
     $.CONSUME(EqualToken); // "="
 
-    const captured = {};
     $.SUBRULE($.schemaParseObjectFn, {
-      ARGS: [parent, MESH0_SETTING_SCHEMA, captured],
-    });
-
-    // Both keys are optional, but an empty setting says nothing.
-    $.ACTION(() => {
-      if (Object.keys(captured).length === 0) {
-        $.addMissingError(
-          parent,
-          "{} requires at least one of: logging, statements",
-        );
-      }
+      ARGS: [parent, MESH0_SETTING_SCHEMA],
     });
 
     $.sectionStack.pop();

package/parser/parser.js

@@ -110,7 +110,11 @@ export function xanoscriptParser(text, scheme, preTokenized = null) {
       parser.realtimeChannelDeclaration();
       return parser;
     case "run":
-      parser.runDeclaration();
+      // run.job and run.service were removed from XanoScript with Xano Run. The platform refuses
+      // a document that still opens with one with this message, so report it here too, rather
+      // than the function parser's errors.
+      if (reportRemovedKeyword(lexResult.tokens)) return parser;
+      parser.functionDeclaration();
       return parser;
     case "table_trigger":
       parser.tableTriggerDeclaration();
@@ -137,6 +141,44 @@ export function xanoscriptParser(text, scheme, preTokenized = null) {
   }
 }
 
+/** The top-level keywords XanoScript removed, with the platform's message for each. */
+export const REMOVED_KEYWORDS = ["run.job", "run.service"];
+
+/**
+ * The platform's error for a removed keyword, quoted as PHP's escapeshellarg quotes it.
+ * @param {string} keyword
+ */
+export function removedKeywordMessage(keyword) {
+  return `'${keyword}' is no longer supported: Xano Run was removed from XanoScript. Remove this document.`;
+}
+
+/**
+ * Reports a document whose declaration opens with a removed keyword (`run.job foo {`), on the
+ * keyword. Returns whether it did.
+ * @param {import('chevrotain').IToken[]} tokens
+ */
+function reportRemovedKeyword(tokens) {
+  const words = tokens.filter((t) => !/^\s*$/.test(t.image) && !t.image.startsWith("//"));
+  const [first, dot, second] = words;
+  if (!first || !dot || !second || dot.image !== ".") return false;
+  if (dot.startOffset !== first.endOffset + 1 || second.startOffset !== dot.endOffset + 1) return false;
+  const keyword = `${first.image}.${second.image}`;
+  if (!REMOVED_KEYWORDS.includes(keyword)) return false;
+  parser.addInvalidValueError(
+    {
+      image: keyword,
+      startOffset: first.startOffset,
+      endOffset: second.endOffset,
+      startLine: first.startLine,
+      startColumn: first.startColumn,
+      endLine: second.endLine,
+      endColumn: second.endColumn,
+    },
+    removedKeywordMessage(keyword),
+  );
+  return true;
+}
+
 const SEPARATOR_IN_STRING =
   'A line that is only "---" separates documents in a multidoc push (xano workspace push, release push), even inside a string. Indent it to keep it in the text.';
 

package/parser/policy/catalogueSnapshot.js

@@ -1,7 +1,7 @@
 // Generated by scripts/gen-policy-catalogue.mjs from the platform's policy check catalogue
 // (`xano policy catalogue -o json`). Do not edit by hand: regenerate it.
 export default {
-  "generated_at": "2026-10-13",
+  "generated_at": "2026-10-29",
   "items": [
     {
       "id": "db.output_fields_forbidden",
@@ -2504,6 +2504,7 @@ export default {
                   "litellm",
                   "openai",
                   "openrouter",
+                  "xano-ai",
                   "xano-free"
                 ]
               }

package/parser/register.js

@@ -43,11 +43,6 @@ import { realtimeChannelDeclaration } from "./realtime_channel_parser.js";
 import { realtimeServerDeclaration } from "./realtime_server_parser.js";
 import { realtimeServerTriggerDeclaration } from "./realtime_server_trigger_parser.js";
 import { realtimeTriggerDeclaration } from "./realtime_trigger_parser.js";
-import {
-  runDeclaration,
-  runJobClause,
-  runServiceClause,
-} from "./run_parser.js";
 import { tableDeclaration } from "./table_parser.js";
 import { tableTriggerDeclaration } from "./table_trigger_parser.js";
 import { taskDeclaration } from "./task_parser.js";
@@ -158,9 +153,6 @@ export const register = ($) => {
     "realtimeChannelDeclaration",
     realtimeChannelDeclaration($)
   );
-  $.runDeclaration = $.RULE("runDeclaration", runDeclaration($));
-  $.runJobClause = $.RULE("runJobClause", runJobClause($));
-  $.runServiceClause = $.RULE("runServiceClause", runServiceClause($));
   $.tableTriggerDeclaration = $.RULE(
     "tableTriggerDeclaration",
     tableTriggerDeclaration($)

package/lexer/run.js

@@ -1,37 +0,0 @@
-import { Identifier } from "./identifier.js";
-import { createTokenByName } from "./utils.js";
-
-// "run"
-export const RunToken = createTokenByName("run", {
-  longer_alt: Identifier,
-  categories: [Identifier],
-});
-
-// "job"
-export const JobToken = createTokenByName("job", {
-  longer_alt: Identifier,
-  categories: [Identifier],
-});
-
-// "service"
-export const ServiceToken = createTokenByName("service", {
-  longer_alt: Identifier,
-  categories: [Identifier],
-});
-
-export const RunTokens = [RunToken, JobToken, ServiceToken];
-
-/**
- * Maps a token name to a type
- * @param {string} token the token name
- */
-export function mapTokenToType(token) {
-  switch (token) {
-    case RunToken.name:
-    case JobToken.name:
-    case ServiceToken.name:
-      return "keyword";
-    default:
-      return null;
-  }
-}

package/parser/run_parser.js

@@ -1,72 +0,0 @@
-import { StringLiteral } from "../lexer/literal.js";
-import { JobToken, RunToken, ServiceToken } from "../lexer/run.js";
-import { DotToken, Identifier, NewlineToken } from "../lexer/tokens.js";
-
-export function runDeclaration($) {
-  return () => {
-    $.sectionStack.push("runDeclaration");
-    // Allow leading comments and newlines before the run declaration
-    $.SUBRULE($.optionalCommentBlockFn);
-
-    $.CONSUME(RunToken); // "run"
-    $.CONSUME(DotToken); // "."
-
-    $.OR([
-      { ALT: () => $.SUBRULE($.runJobClause) },
-      { ALT: () => $.SUBRULE($.runServiceClause) },
-    ]);
-
-    $.MANY2(() => $.CONSUME2(NewlineToken)); // optional trailing newlines
-    $.sectionStack.pop();
-  };
-}
-
-export function runJobClause($) {
-  return () => {
-    const parent = $.CONSUME(JobToken); // "job"
-
-    const nameToken = $.OR([
-      { ALT: () => $.CONSUME(StringLiteral) },
-      { ALT: () => $.CONSUME(Identifier) },
-    ]);
-    $.validateDeclarationName(nameToken, "job");
-
-    $.SUBRULE($.schemaParseAttributeFn, {
-      ARGS: [
-        parent,
-        {
-          main: {
-            name: "[string]",
-            "input?": { "[string]?": "[constant]" },
-          },
-          "env?": ["[string]"],
-        },
-      ],
-    });
-  };
-}
-
-export function runServiceClause($) {
-  return () => {
-    const parent = $.CONSUME(ServiceToken); // "service"
-
-    const nameToken = $.OR([
-      { ALT: () => $.CONSUME(StringLiteral) },
-      { ALT: () => $.CONSUME(Identifier) },
-    ]);
-    $.validateDeclarationName(nameToken, "service");
-
-    $.SUBRULE($.schemaParseAttributeFn, {
-      ARGS: [
-        parent,
-        {
-          "pre?": {
-            name: "[string]",
-            input: { "[string]?": "[constant]" },
-          },
-          "env?": ["[string]"],
-        },
-      ],
-    });
-  };
-}