norn-cli 2.9.7 → 3.0.0

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "norn-cli",
   "displayName": "Norn",
-  "description": "Version-controlled API, database, and Kubernetes tests and runbooks. Author in VS Code, then run the same files from the CLI and CI.",
-  "version": "2.9.7",
+  "description": "Version-controlled API and database tests. Author in VS Code, then run the same files from the CLI and CI.",
+  "version": "3.0.0",
   "publisher": "Norn-PeterKrustanov",
   "author": {
     "name": "Peter Krastanov"
@@ -29,13 +29,11 @@
     "api automation",
     "openapi",
     "http",
-    "test automation",
-    "kubernetes",
-    "kubectl",
-    "runbooks"
+    "test automation"
   ],
   "engines": {
-    "vscode": "^1.108.1"
+    "vscode": "^1.108.1",
+    "node": ">=20.0.0"
   },
   "categories": [
     "Testing",
@@ -48,6 +46,7 @@
     "onLanguage:nornapi",
     "onLanguage:nornenv",
     "onLanguage:nornk8s",
+    "onLanguage:nornagent",
     "workspaceContains:**/norn.config.json",
     "onChatParticipant:norn.chat",
     "onView:norn.sidebarHome",
@@ -59,6 +58,8 @@
     "onCommand:norn.openTerminal",
     "onCommand:norn.terminal.focusRawTerminal",
     "onCommand:norn.debugSequence",
+    "onCommand:norn.debug.runToNextContractFailure",
+    "onCommand:norn.showAgentGraph",
     "onDebugResolve:norn"
   ],
   "main": "./dist/extension.js",
@@ -79,6 +80,17 @@
         "title": "Debug Sequence",
         "category": "Norn"
       },
+      {
+        "command": "norn.debug.runToNextContractFailure",
+        "title": "Run to Next Contract Failure",
+        "category": "Norn Debug",
+        "icon": "$(debug-continue)"
+      },
+      {
+        "command": "norn.showAgentGraph",
+        "title": "Show Agent Graph",
+        "category": "Norn"
+      },
       {
         "command": "norn.clearCookies",
         "title": "Clear Cookies",
@@ -219,6 +231,20 @@
       ]
     },
     "menus": {
+      "commandPalette": [
+        {
+          "command": "norn.k8s.runLine",
+          "when": "false"
+        },
+        {
+          "command": "norn.k8s.runSequence",
+          "when": "false"
+        },
+        {
+          "command": "norn.k8s.selectContext",
+          "when": "false"
+        }
+      ],
       "explorer/context": [
         {
           "command": "norn.createStarterCatalog",
@@ -230,6 +256,13 @@
           "when": "explorerResourceIsFolder",
           "group": "norn@2"
         }
+      ],
+      "debug/toolBar": [
+        {
+          "command": "norn.debug.runToNextContractFailure",
+          "when": "debugType == norn && debugState == stopped",
+          "group": "navigation@25"
+        }
       ]
     },
     "languages": [
@@ -306,6 +339,21 @@
           "dark": "./images/nornk8s-icon.svg"
         },
         "configuration": "./language-configuration.json"
+      },
+      {
+        "id": "nornagent",
+        "aliases": [
+          "Norn Agent",
+          "nornagent"
+        ],
+        "extensions": [
+          ".nornagent"
+        ],
+        "icon": {
+          "light": "./images/nornagent-icon.svg",
+          "dark": "./images/nornagent-icon.svg"
+        },
+        "configuration": "./language-configuration.json"
       }
     ],
     "grammars": [
@@ -336,6 +384,23 @@
         "language": "nornk8s",
         "scopeName": "source.nornk8s",
         "path": "./syntaxes/nornk8s.tmLanguage.json"
+      },
+      {
+        "language": "nornagent",
+        "scopeName": "source.nornagent",
+        "path": "./syntaxes/nornagent.tmLanguage.json"
+      }
+    ],
+    "semanticTokenScopes": [
+      {
+        "language": "norn",
+        "scopes": {
+          "variable": [
+            "variable.other.constant.norn",
+            "variable.other.constant",
+            "variable"
+          ]
+        }
       }
     ],
     "jsonValidation": [
@@ -351,6 +416,9 @@
     "breakpoints": [
       {
         "language": "norn"
+      },
+      {
+        "language": "nornagent"
       }
     ],
     "debuggers": [
@@ -363,6 +431,9 @@
         "breakpoints": [
           {
             "language": "norn"
+          },
+          {
+            "language": "nornagent"
           }
         ],
         "configurationAttributes": {
@@ -380,6 +451,10 @@
                 "type": "string",
                 "description": "Name of the sequence to debug."
               },
+              "recording": {
+                "type": "string",
+                "description": "Optional workspace-relative or absolute agent-run recording to replay offline."
+              },
               "env": {
                 "type": "string",
                 "description": "Environment name for this debug session. If omitted, Norn uses the currently selected environment."
@@ -435,7 +510,7 @@
         "id": "norn.chat",
         "name": "norn",
         "fullName": "Norn",
-        "description": "Ask questions about Norn syntax, generate requests and runbooks, explain sequences, and convert cURL/HTTP to Norn",
+        "description": "Ask questions about Norn syntax, generate requests, explain sequences, and convert cURL/HTTP to Norn",
         "isSticky": true,
         "commands": [
           {
@@ -564,12 +639,15 @@
     "typescript-eslint": "^8.52.0"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.116.0",
+    "@google/genai": "^2.16.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "ajv": "^8.17.1",
     "axios": "^1.13.2",
     "chalk": "^5.4.1",
     "mssql": "^12.2.0",
     "norn-cli": "^1.10.6",
+    "openai": "^6.49.0",
     "pg": "^8.20.0",
     "tough-cookie": "^6.0.0"
   },

package/playground/ai.norn

@@ -0,0 +1,9 @@
+import "./ai_orchastration.nornagent"
+
+sequence SimpleNexusRun
+
+    var nexusReply = run Nexus "Who are you?"
+
+    print nexusReply
+
+end sequence

package/playground/ai_orchastration.nornagent

@@ -0,0 +1,10 @@
+model gpt4o
+    provider openai
+    name gpt-4o
+    apiKey {{OPENAI_API}}
+end model
+
+agent Nexus
+    model gpt4o
+    system file "./knowedge_base/nexus_system_prompt.md"
+end agent

package/playground/knowedge_base/nexus_system_prompt.md

@@ -0,0 +1 @@
+You are Nexus you test Jira tickets

package/schemas/norn.config.schema.json

@@ -66,6 +66,37 @@
           }
         }
       }
+    },
+    {
+      "label": "Norn config with contract mode",
+      "description": "Create a Norn config that auto-validates endpoint responses against synced contracts/ schemas.",
+      "body": {
+        "version": 1,
+        "contracts": {
+          "mode": "auto"
+        }
+      }
+    },
+    {
+      "label": "Norn config with agent limits",
+      "description": "Create a Norn config with global agent safeguards, automatic run recording, and a smaller local-provider output ceiling.",
+      "body": {
+        "version": 1,
+        "agents": {
+          "max_tokens": 16000,
+          "max_depth": 5,
+          "max_invocations": 25,
+          "contract_retries": 2,
+          "recording": {
+            "enabled": true
+          },
+          "providers": {
+            "local": {
+              "max_tokens": 4096
+            }
+          }
+        }
+      }
     }
   ],
   "properties": {
@@ -154,6 +185,49 @@
           }
         }
       ]
+    },
+    "contracts": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/contractsSection"
+        }
+      ],
+      "defaultSnippets": [
+        {
+          "label": "Contracts section definition",
+          "description": "Turn on contract mode for endpoint-syntax requests.",
+          "body": {
+            "mode": "${1:auto}"
+          }
+        }
+      ]
+    },
+    "agents": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/agentsSection"
+        }
+      ],
+      "defaultSnippets": [
+        {
+          "label": "Agent settings section definition",
+          "description": "Insert global agent limits, recording settings, and an optional provider-specific override.",
+          "body": {
+            "max_tokens": 16000,
+            "max_depth": 5,
+            "max_invocations": 25,
+            "contract_retries": 2,
+            "recording": {
+              "enabled": true
+            },
+            "providers": {
+              "${1:local}": {
+                "max_tokens": 4096
+              }
+            }
+          }
+        }
+      ]
     }
   },
   "definitions": {
@@ -260,6 +334,143 @@
         }
       }
     },
+    "contractsSection": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Contract-mode settings. Contract mode auto-validates each endpoint-syntax response against the synced contracts/ schema for that operation and status.",
+      "properties": {
+        "_comment": {
+          "$ref": "#/definitions/comment",
+          "description": "Optional human-readable guidance ignored by Norn at runtime."
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "auto",
+            "off"
+          ],
+          "default": "off",
+          "description": "'auto' validates every endpoint-syntax request against its committed contracts/ schema (no assert lines needed). 'off' (default) disables contract mode; the --contracts CLI flag overrides this per run.",
+          "enumDescriptions": [
+            "Validate every endpoint-syntax response against its synced contract schema.",
+            "Disable automatic contract validation (default)."
+          ]
+        }
+      }
+    },
+    "agentProviderLimits": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Agent limits for one model provider. These override global agents settings and are overridden by directives on an individual agent.",
+      "properties": {
+        "_comment": {
+          "$ref": "#/definitions/comment",
+          "description": "Optional human-readable guidance ignored by Norn at runtime."
+        },
+        "max_tokens": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Provider-specific maximum output-token ceiling for each agent invocation."
+        },
+        "max_depth": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Provider-specific maximum sub-agent invocation depth."
+        },
+        "max_invocations": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Provider-specific maximum total invocations in one top-level agent run."
+        },
+        "contract_retries": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Provider-specific failed-attempt cap for correctable accepts or returns handoff violations."
+        }
+      }
+    },
+    "agentRecording": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Automatic agent run recording. Norn keeps a fixed rolling maximum of the latest 20 generated recordings; retention is not configurable.",
+      "properties": {
+        "_comment": {
+          "$ref": "#/definitions/comment",
+          "description": "Optional human-readable guidance ignored by Norn at runtime."
+        },
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Write an offline replay recording for completed agent runs. Enabled by default."
+        }
+      }
+    },
+    "agentsSection": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Global recording behavior and global/provider-specific limits for agent runs. Per-agent .nornagent directives override limit values.",
+      "properties": {
+        "_comment": {
+          "$ref": "#/definitions/comment",
+          "description": "Optional human-readable guidance ignored by Norn at runtime."
+        },
+        "max_tokens": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum output-token ceiling for each agent invocation. This is a ceiling, not a spend; hosted providers default to 16000 and local defaults to 4096."
+        },
+        "max_depth": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum sub-agent invocation depth for one top-level agent run. Higher values can permit more model calls."
+        },
+        "max_invocations": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum total agent invocations, including the root, within one top-level agent run."
+        },
+        "contract_retries": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Failed-attempt cap for correctable accepts or returns violations at a sub-agent handoff. Set to 0 to fail immediately."
+        },
+        "recording": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/agentRecording"
+            }
+          ],
+          "defaultSnippets": [
+            {
+              "label": "Agent recording settings",
+              "description": "Enable or disable automatic offline replay recordings.",
+              "body": {
+                "enabled": true
+              }
+            }
+          ]
+        },
+        "providers": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Limits for a specific model provider. Provider values override global agents settings.",
+          "properties": {
+            "openai": {
+              "$ref": "#/definitions/agentProviderLimits"
+            },
+            "anthropic": {
+              "$ref": "#/definitions/agentProviderLimits"
+            },
+            "google": {
+              "$ref": "#/definitions/agentProviderLimits"
+            },
+            "local": {
+              "$ref": "#/definitions/agentProviderLimits"
+            }
+          }
+        }
+      }
+    },
     "mcpSection": {
       "type": "object",
       "additionalProperties": false,