norn-cli 2.9.8 → 3.1.0

package/package.json

@@ -2,7 +2,7 @@
   "name": "norn-cli",
   "displayName": "Norn",
   "description": "Version-controlled API and database tests. Author in VS Code, then run the same files from the CLI and CI.",
-  "version": "2.9.8",
+  "version": "3.1.0",
   "publisher": "Norn-PeterKrustanov",
   "author": {
     "name": "Peter Krastanov"
@@ -32,7 +32,8 @@
     "test automation"
   ],
   "engines": {
-    "vscode": "^1.108.1"
+    "vscode": "^1.108.1",
+    "node": ">=20.0.0"
   },
   "categories": [
     "Testing",
@@ -45,6 +46,7 @@
     "onLanguage:nornapi",
     "onLanguage:nornenv",
     "onLanguage:nornk8s",
+    "onLanguage:nornagent",
     "workspaceContains:**/norn.config.json",
     "onChatParticipant:norn.chat",
     "onView:norn.sidebarHome",
@@ -56,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",
@@ -76,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",
@@ -241,6 +256,13 @@
           "when": "explorerResourceIsFolder",
           "group": "norn@2"
         }
+      ],
+      "debug/toolBar": [
+        {
+          "command": "norn.debug.runToNextContractFailure",
+          "when": "debugType == norn && debugState == stopped",
+          "group": "navigation@25"
+        }
       ]
     },
     "languages": [
@@ -317,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": [
@@ -347,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": [
@@ -362,6 +416,9 @@
     "breakpoints": [
       {
         "language": "norn"
+      },
+      {
+        "language": "nornagent"
       }
     ],
     "debuggers": [
@@ -374,6 +431,9 @@
         "breakpoints": [
           {
             "language": "norn"
+          },
+          {
+            "language": "nornagent"
           }
         ],
         "configurationAttributes": {
@@ -391,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."
@@ -563,8 +627,8 @@
     "@types/pg": "^8.18.0",
     "@types/tough-cookie": "^4.0.5",
     "@types/vscode": "^1.108.1",
-    "@vscode/test-cli": "^0.0.12",
-    "@vscode/test-electron": "^2.5.2",
+    "@vscode/test-cli": "^0.0.15",
+    "@vscode/test-electron": "^3.1.0",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0",
     "esbuild": "^0.27.2",
@@ -575,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,15 @@
+import "./ai_orchastration.nornagent"
+
+sequence SimpleNexusRun
+
+    var nexusReply = run Nexus "Open any website for me need to see if the mcp connection is working"
+
+    print "Result" | nexusReply
+    
+end sequence
+
+sequence Test
+    run mcp list Time
+    run TimeTeller "what is the time"
+
+end sequence

package/playground/ai_orchastration.nornagent

@@ -0,0 +1,29 @@
+model gpt4o
+    provider openai
+    name gpt-4o
+    apiKey {{OPENAI_API}}
+end model
+
+mcp Playwright
+    transport stdio
+    command npx --yes @playwright/mcp@0.0.79 --headless --isolated --browser chrome
+end mcp
+
+mcp Time
+    transport http
+    url http://localhost:8811/mcp
+    header Authorization: Bearer {{$env.TIME_MCP_TOKEN}}
+end mcp
+
+agent Nexus
+    model gpt4o
+    system file "./knowedge_base/nexus_system_prompt.md"
+    mcp Playwright
+end agent
+
+agent TimeTeller
+    model gpt4o
+    mcp Time
+    system "When asked for the time you check the MCP server you have access to and check what the time is now."
+end agent
+

package/playground/knowedge_base/nexus_system_prompt.md

@@ -0,0 +1 @@
+You are Nexus you open a webpage when asked using the playwright mcp. They will ussualy provide you with a URL to open in the webpage, if you are not just try to open www.google.com and see if it works if you managed to open it this is success report back and wrap up.

package/schemas/norn.config.schema.json

@@ -66,6 +66,38 @@
           }
         }
       }
+    },
+    {
+      "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,
+          "max_turns": 100,
+          "contract_retries": 2,
+          "recording": {
+            "enabled": true
+          },
+          "providers": {
+            "local": {
+              "max_tokens": 4096
+            }
+          }
+        }
+      }
     }
   ],
   "properties": {
@@ -154,6 +186,50 @@
           }
         }
       ]
+    },
+    "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,
+            "max_turns": 100,
+            "contract_retries": 2,
+            "recording": {
+              "enabled": true
+            },
+            "providers": {
+              "${1:local}": {
+                "max_tokens": 4096
+              }
+            }
+          }
+        }
+      ]
     }
   },
   "definitions": {
@@ -260,6 +336,153 @@
         }
       }
     },
+    "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."
+        },
+        "max_turns": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Provider-specific maximum model turns in one hop's tool loop. Each turn is a paid model call."
+        },
+        "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."
+        },
+        "max_turns": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum model turns in one hop's tool loop before the hop stops as truncated. Each turn is a paid model call; defaults to 100."
+        },
+        "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,