@dot-agent/language-server 0.2.0 → 0.3.1

package/.github/workflows/publish.yml

@@ -0,0 +1,28 @@
+name: Publish to npm
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Publish package to npm
+        run: npm publish

package/AGENTS.md

@@ -20,7 +20,7 @@ All structural analysis is performed on **tree-sitter ASTs** (not regex). `parse
 | `parser.js` | Tree-sitter engine — WASM initialization, per-document AST cache, and shared traversal helpers |
 | `features/hover.js` | Hover documentation for all DSL keywords (static lookup, no tree traversal) |
 | `features/completions.js` | Context-aware completions using `getContextNode` and `nodesOfType` for name lookups |
-| `features/diagnostics.js` | Linting — dangling transitions, dead-end interact (AST), deprecated keywords (line scan), undeclared types (AST) |
+| `features/diagnostics.js` | Linting — dangling transitions, dead-end interact (AST), undeclared types (AST) |
 | `features/definition.js` | Go-to-definition via `state_decl` / `type_decl` node lookup |
 | `features/references.js` | Find all references via `transition_stmt`, `intent_trigger`, `type_ref` traversal |
 | `features/rename.js` | Rename symbol — same traversal as references, produces `TextEdit[]` |
@@ -153,4 +153,4 @@ The Apache 2.0 header:
 | Agent grammar (canonical) | [tree-sitter-agent/grammar.js](https://github.com/daniloborges/tree-sitter-agent/blob/main/grammar.js) |
 | Flow grammar (canonical) | [tree-sitter-agent/flow/grammar.js](https://github.com/daniloborges/tree-sitter-agent/blob/main/flow/grammar.js) |
 | VS Code extension | [vscode-dot-agent](https://github.com/daniloborges/vscode-dot-agent) |
-| WASM execution engine | [dot-agent-kernel](https://github.com/daniloborges/dot-agent-kernel) |
+| WASM execution engine | [dot-agent-kernel](https://github.com/dot-agent-spec/kernel-dsl) |

package/README.md

@@ -8,7 +8,7 @@ A standalone [Language Server Protocol (LSP)](https://microsoft.github.io/langua
 |---|---|---|
 | **Hover** | Keyword documentation | Keyword documentation |
 | **Completion** | Manifest keywords, custom types | Keywords, state names, memory domains (`context.`, `session.`, …) |
-| **Diagnostics** | Deprecated keywords, strict block lint, undeclared types | Dangling `transition` targets, dead-end `interact` |
+| **Diagnostics** | Strict block lint, undeclared types | Dangling `transition` targets, dead-end `interact` |
 | **Go-to-Definition** | Type name → `type` declaration | `transition to stateName` → `state` declaration |
 | **Find References** | All uses of a type | All `transition` references to a state |
 | **Rename** | Type and its references | State and all `transition` references |

package/features/diagnostics.js

@@ -19,11 +19,6 @@
 const { DiagnosticSeverity } = require('vscode-languageserver');
 const { nodesOfType, nodeToRange } = require('../parser');
 
-const DEPRECATED_AGENT_KW = new Set([
-    'do', 'server', 'endpoint', 'author', 'version', 'requirements', 'step',
-    'softwareVersion', 'applicationCategory', 'character', 'publishingPrinciples',
-]);
-
 const STRICT_BLOCK_TYPES = {
     input_block:        'input',
     output_block:       'output',
@@ -34,26 +29,6 @@ const STRICT_BLOCK_TYPES = {
 function diagnoseAgent(tree, text) {
     const diagnostics = [];
 
-    // ── Deprecated keywords: line scan (no tree-sitter benefit here) ──────────
-    const lines = text.split('\n');
-    for (let i = 0; i < lines.length; i++) {
-        const raw = lines[i];
-        const stripped = raw.split('//')[0].trim();
-        if (!stripped) continue;
-        const wordM = stripped.match(/^([a-zA-Z0-9_.-]+)\b/);
-        if (!wordM) continue;
-        const word = wordM[1];
-        if (DEPRECATED_AGENT_KW.has(word)) {
-            const col = raw.indexOf(word);
-            diagnostics.push({
-                range: { start: { line: i, character: col }, end: { line: i, character: col + word.length } },
-                message: `The keyword '${word}' is deprecated or invalid in the current .agent specification.`,
-                severity: DiagnosticSeverity.Error,
-                source: 'agent-dsl',
-            });
-        }
-    }
-
     // ── Strict block validation ───────────────────────────────────────────────
     const declaredTypes = new Set(
         nodesOfType(tree, 'type_decl')
@@ -99,6 +74,7 @@ function diagnoseFlow(tree) {
     const diagnostics = [];
 
     // ── Rule 1: Dangling transitions ──────────────────────────────────────────
+    // Collect all defined state names (from both oriented_state_body and setup_state_body)
     const definedStates = new Set(
         nodesOfType(tree, 'state_decl')
             .map(n => n.childForFieldName('name')?.text)
@@ -125,26 +101,38 @@ function diagnoseFlow(tree) {
         checkTransitionTarget(n.childForFieldName('state'));
     }
     for (const n of nodesOfType(tree, 'intent_trigger')) {
-        // inline form: on intent "..." next <state>
+        // inline form: on intent "..." transition to <state>
+        checkTransitionTarget(n.childForFieldName('state'));
+    }
+    for (const n of nodesOfType(tree, 'fallback_stmt')) {
+        // inline form: on fallback transition to <state>
+        checkTransitionTarget(n.childForFieldName('state'));
+    }
+    for (const n of nodesOfType(tree, 'offtopic_stmt')) {
+        // inline form: on offtopic transition to <state>
         checkTransitionTarget(n.childForFieldName('state'));
     }
 
-    // ── Rule 2: Dead-end interact ─────────────────────────────────────────────
+    // ── Rule 2: Dead-end interact (now redundant but kept for safety) ────────────
+    // With the new grammar, oriented_state_body requires repeat1(handlers),
+    // so dead-end interact is structurally impossible. But kept for edge cases.
     for (const interactNode of nodesOfType(tree, 'interact_stmt')) {
         let ancestor = interactNode.parent;
-        while (ancestor && ancestor.type !== 'state_decl') {
+        while (ancestor && ancestor.type !== 'oriented_state_body' && ancestor.type !== 'state_decl') {
             ancestor = ancestor.parent;
         }
         if (!ancestor) continue;
 
-        const hasNext   = ancestor.descendantsOfType('transition_stmt').length > 0;
-        const hasIntent = ancestor.descendantsOfType('intent_trigger').length > 0;
-        const hasOfftopic = ancestor.descendantsOfType('offtopic_stmt').length > 0;
+        // With new grammar: oriented_state_body always has handlers after interact (repeat1)
+        // So this check should never trigger, but kept for robustness
+        const hasHandlers = ancestor.descendantsOfType('intent_trigger').length +
+                           ancestor.descendantsOfType('fallback_stmt').length +
+                           ancestor.descendantsOfType('offtopic_stmt').length > 0;
 
-        if (!hasNext && !hasIntent && !hasOfftopic) {
+        if (!hasHandlers) {
             diagnostics.push({
                 range: nodeToRange(interactNode),
-                message: "This state calls interact but has no 'transition' or 'on intent/offtopic'. This will trap the agent.",
+                message: "This state calls interact but has no handlers (on intent/fallback/offtopic). This will trap the agent.",
                 severity: DiagnosticSeverity.Warning,
                 source: 'behavior-dsl',
             });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dot-agent/language-server",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "LSP server for .agent DSL files",
   "license": "Apache-2.0",
   "author": "Danilo Borges <contato@daniloborg.es>",
@@ -12,7 +12,13 @@
   "bugs": {
     "url": "https://github.com/dot-agent-spec/language-server/issues"
   },
-  "keywords": ["lsp", "language-server", "agent", "dsl", "flow"],
+  "keywords": [
+    "lsp",
+    "language-server",
+    "agent",
+    "dsl",
+    "flow"
+  ],
   "main": "server.js",
   "engines": {
     "node": ">=18"
@@ -21,10 +27,10 @@
     "start": "node server.js --stdio"
   },
   "dependencies": {
+    "@dot-agent/tree-sitter": "^0.3.2",
     "vscode-languageserver": "^9.0.1",
     "vscode-languageserver-textdocument": "^1.0.12",
-    "web-tree-sitter": "^0.25.0",
-    "@dot-agent/tree-sitter": "^0.2.0"
+    "web-tree-sitter": "^0.25.10"
   },
   "publishConfig": {
     "access": "public"