PyPI - graphcore-studio - Versions diffs - 0.2.0__tar.gz → 0.2.2__tar.gz - Mend

graphcore-studio 0.2.0tar.gz → 0.2.2tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (44) hide show

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/.github/workflows/ci.yml RENAMED Viewed

@@ -31,7 +31,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        python: ['3.9', '3.12']
+        python: ['3.9', '3.12', '3.14']
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/.github/workflows/wheels.yml RENAMED Viewed

@@ -30,7 +30,7 @@ jobs:
       - name: Build wheels for supported CPython versions
         run: python -m pip install cibuildwheel && python -m cibuildwheel --output-dir wheelhouse
         env:
-          CIBW_BUILD: 'cp39-* cp310-* cp311-* cp312-* cp313-*'
+          CIBW_BUILD: 'cp39-* cp310-* cp311-* cp312-* cp313-* cp314-*'
           CIBW_SKIP: '*-musllinux_*'
           CIBW_TEST_COMMAND: >-
             python -c "from graphcore import END, Graph; g=Graph(); g.add_node('probe', lambda s,c: {'ok': True}); g.set_entry('probe').add_edge('probe', END); assert g.invoke().state['ok']; g.close()"

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/CMakeLists.txt RENAMED Viewed

@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.16)
-project(GraphCore VERSION 0.2.0 LANGUAGES CXX)
+project(GraphCore VERSION 0.2.2 LANGUAGES CXX)
 option(GRAPHCORE_BUILD_TESTS "Build tests" ON)
 option(GRAPHCORE_BUILD_EXAMPLES "Build examples" ON)
 option(GRAPHCORE_BUILD_PYTHON "Build C ABI shared library for Python" ON)

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graphcore-studio
-Version: 0.2.0
+Version: 0.2.2
 Summary: A local-first visual agent workflow studio powered by a native C++ graph runtime
 Keywords: agents,agentic-workflows,graph,C++,visual-workflow-builder
 License-Expression: MIT
@@ -15,11 +15,14 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.9
+Requires-Python: >=3.9.2
+Requires-Dist: openrouter<1,>=0.10.8
+Requires-Dist: pydantic<3,>=2
 Provides-Extra: models
-Requires-Dist: openrouter<1,>=0.10; extra == "models"
+Requires-Dist: openrouter<1,>=0.10.8; extra == "models"
 Provides-Extra: pydantic
 Requires-Dist: pydantic<3,>=2; extra == "pydantic"
 Description-Content-Type: text/markdown
@@ -32,7 +35,7 @@ GraphCore Studio is an interactive, local-first visual agent framework. Drag nod
 ## Start Studio
-Requirements: Python 3.9+ and a C++17 compiler. You do not need CMake, Node.js, Docker, API keys, an internet connection, or a model to try the included workflows.
+Requirements: Python 3.9.2+ and a C++17 compiler. You do not need CMake, Node.js, Docker, API keys, an internet connection, or a model to try the included workflows.
 From the project folder, run one command:
@@ -48,25 +51,25 @@ py run_studio.py
 If Python was installed through the Windows Store and `py` is unavailable, run `python run_studio.py` from the Visual Studio Developer Terminal.
-Stop the server with Ctrl+C. Workflows and run history live in `studio/data/`; drafts are saved in this browser. Run `python3 run_studio.py --help` to configure the port, data directory, or Python tool plugins.
+Stop the server with Ctrl+C. Workflows and run history live in `studio/data/`; drafts are saved in this browser. Studio starts on port 8787 when available and automatically chooses a free local port if it is occupied. The actual URL is printed in the terminal. Run `python3 run_studio.py --help` to configure a specific port, data directory, or Python tool plugins.
 ### Install the PyPI package
-After the first release is published, install the prebuilt package with:
+Install the prebuilt package and its OpenRouter/Pydantic runtime dependencies with:
 ```bash
-python -m pip install "graphcore-studio[models,pydantic]"
+python -m pip install graphcore-studio
 graphcore-studio
 ```
-The wheel bundles the C++ runtime and Studio UI. Source installs build the native runtime and therefore require a C++17 compiler and CMake. The distribution is named `graphcore-studio`; its Python API imports as `graphcore`.
+The wheel bundles the C++ runtime and Studio UI. Source installs build the native runtime and therefore require a C++17 compiler and CMake. The distribution is named `graphcore-studio`; its Python API imports as `graphcore`. Windows, macOS, and Linux wheels are provided for supported architectures.
 ### Use Pydantic
-The built-in structured-output validator works offline with no extra packages. To enable optional Pydantic v2 validation:
+The built-in structured-output validator works offline. Pydantic v2 is installed by the standard PyPI command above and can be selected as the validation engine. When running directly from a source checkout, install the runtime dependencies with:
 ```bash
-python3 -m pip install -r requirements-pydantic.txt
+python3 -m pip install -r requirements-models.txt -r requirements-pydantic.txt
 python3 run_studio.py
 ```
@@ -74,18 +77,16 @@ On Windows, replace `python3` with `py -3`. Restart Studio after installing pack
 ### Use OpenRouter models
-The **Chat Model** and **Agent** nodes use GraphCore's model adapter with the official OpenRouter Python SDK. C++ owns graph scheduling, state commits, conditions, and checkpoints; the Python wrapper calls the SDK. The OpenRouter request runs through the project-owned adapter rather than a chain framework.
+The **Chat Model** and **Agent** nodes use GraphCore's model adapter with the official OpenRouter Python SDK, installed automatically by the standard PyPI command. C++ owns graph scheduling, state commits, conditions, and checkpoints; the Python wrapper calls the SDK. The OpenRouter request runs through the project-owned adapter rather than a chain framework.
-Install the SDK into the Python environment used to run Studio:
+When running directly from a source checkout, install the runtime dependencies into the Python environment used to run Studio:
 ```bash
 python3 -m pip install -r requirements-models.txt
 python3 run_studio.py
 ```
-For a PyPI installation, use the `models` extra instead: `python -m pip install "graphcore-studio[models]"`.
-In Studio, open **Model integrations**, add `OPENROUTER_API_KEY`, and save. Select **OpenRouter** on a Chat Model node and enter a model ID from the [OpenRouter model catalog](https://openrouter.ai/models). Compose system/user/assistant messages and use **Insert variable** to reference workflow inputs and prior node outputs. Studio loads the local `.env` file automatically; secret values are not included in workflow files. The offline fixture needs no SDK, key, or network call.
+In Studio, open **Model integrations**, add `OPENROUTER_API_KEY`, and save. Add as many named models as you need, such as `model1 → deepseek/deepseek-v4-pro-0813` and `model2 → openai/gpt-4o-mini`, using IDs from the [OpenRouter model catalog](https://openrouter.ai/models). Choose a saved model on each Chat Model or Agent node. In workflow JSON, set `"model": "$model1"` or `"model": "$model2"` to select the model for that node. Literal model IDs still work. Compose system/user/assistant messages and use **Insert variable** to reference workflow inputs and prior node outputs. Studio loads the local `.env` file automatically; secret values are not included in workflow files. Named model IDs are stored in the local Studio data directory. The offline fixture needs no SDK, key, or network call.
 ## Build a workflow

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/README.md RENAMED Viewed

@@ -6,7 +6,7 @@ GraphCore Studio is an interactive, local-first visual agent framework. Drag nod
 ## Start Studio
-Requirements: Python 3.9+ and a C++17 compiler. You do not need CMake, Node.js, Docker, API keys, an internet connection, or a model to try the included workflows.
+Requirements: Python 3.9.2+ and a C++17 compiler. You do not need CMake, Node.js, Docker, API keys, an internet connection, or a model to try the included workflows.
 From the project folder, run one command:
@@ -22,25 +22,25 @@ py run_studio.py
 If Python was installed through the Windows Store and `py` is unavailable, run `python run_studio.py` from the Visual Studio Developer Terminal.
-Stop the server with Ctrl+C. Workflows and run history live in `studio/data/`; drafts are saved in this browser. Run `python3 run_studio.py --help` to configure the port, data directory, or Python tool plugins.
+Stop the server with Ctrl+C. Workflows and run history live in `studio/data/`; drafts are saved in this browser. Studio starts on port 8787 when available and automatically chooses a free local port if it is occupied. The actual URL is printed in the terminal. Run `python3 run_studio.py --help` to configure a specific port, data directory, or Python tool plugins.
 ### Install the PyPI package
-After the first release is published, install the prebuilt package with:
+Install the prebuilt package and its OpenRouter/Pydantic runtime dependencies with:
 ```bash
-python -m pip install "graphcore-studio[models,pydantic]"
+python -m pip install graphcore-studio
 graphcore-studio
 ```
-The wheel bundles the C++ runtime and Studio UI. Source installs build the native runtime and therefore require a C++17 compiler and CMake. The distribution is named `graphcore-studio`; its Python API imports as `graphcore`.
+The wheel bundles the C++ runtime and Studio UI. Source installs build the native runtime and therefore require a C++17 compiler and CMake. The distribution is named `graphcore-studio`; its Python API imports as `graphcore`. Windows, macOS, and Linux wheels are provided for supported architectures.
 ### Use Pydantic
-The built-in structured-output validator works offline with no extra packages. To enable optional Pydantic v2 validation:
+The built-in structured-output validator works offline. Pydantic v2 is installed by the standard PyPI command above and can be selected as the validation engine. When running directly from a source checkout, install the runtime dependencies with:
 ```bash
-python3 -m pip install -r requirements-pydantic.txt
+python3 -m pip install -r requirements-models.txt -r requirements-pydantic.txt
 python3 run_studio.py
 ```
@@ -48,18 +48,16 @@ On Windows, replace `python3` with `py -3`. Restart Studio after installing pack
 ### Use OpenRouter models
-The **Chat Model** and **Agent** nodes use GraphCore's model adapter with the official OpenRouter Python SDK. C++ owns graph scheduling, state commits, conditions, and checkpoints; the Python wrapper calls the SDK. The OpenRouter request runs through the project-owned adapter rather than a chain framework.
+The **Chat Model** and **Agent** nodes use GraphCore's model adapter with the official OpenRouter Python SDK, installed automatically by the standard PyPI command. C++ owns graph scheduling, state commits, conditions, and checkpoints; the Python wrapper calls the SDK. The OpenRouter request runs through the project-owned adapter rather than a chain framework.
-Install the SDK into the Python environment used to run Studio:
+When running directly from a source checkout, install the runtime dependencies into the Python environment used to run Studio:
 ```bash
 python3 -m pip install -r requirements-models.txt
 python3 run_studio.py
 ```
-For a PyPI installation, use the `models` extra instead: `python -m pip install "graphcore-studio[models]"`.
-In Studio, open **Model integrations**, add `OPENROUTER_API_KEY`, and save. Select **OpenRouter** on a Chat Model node and enter a model ID from the [OpenRouter model catalog](https://openrouter.ai/models). Compose system/user/assistant messages and use **Insert variable** to reference workflow inputs and prior node outputs. Studio loads the local `.env` file automatically; secret values are not included in workflow files. The offline fixture needs no SDK, key, or network call.
+In Studio, open **Model integrations**, add `OPENROUTER_API_KEY`, and save. Add as many named models as you need, such as `model1 → deepseek/deepseek-v4-pro-0813` and `model2 → openai/gpt-4o-mini`, using IDs from the [OpenRouter model catalog](https://openrouter.ai/models). Choose a saved model on each Chat Model or Agent node. In workflow JSON, set `"model": "$model1"` or `"model": "$model2"` to select the model for that node. Literal model IDs still work. Compose system/user/assistant messages and use **Insert variable** to reference workflow inputs and prior node outputs. Studio loads the local `.env` file automatically; secret values are not included in workflow files. Named model IDs are stored in the local Studio data directory. The offline fixture needs no SDK, key, or network call.
 ## Build a workflow

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/docs/ARCHITECTURE.md RENAMED Viewed

@@ -4,7 +4,7 @@
 Browser visual canvas (plain HTML/CSS/JS)
              │ local JSON API with per-launch token
 Python standard-library HTTP server and run manager
-      ├── registered Python / optional Pydantic nodes
+      ├── registered Python / Pydantic nodes
       ├── official OpenRouter Python SDK adapter
       └── ctypes C ABI bridge
                   │
@@ -25,7 +25,7 @@ C++17 GraphCore runtime
 - `python/graphcore/`: Python SDK and asyncio callback bridge.
 - `run_studio.py`: one-command native compilation and local startup.
-No Node.js, frontend bundler, database, C++ package manager or Python web framework is required. The OpenRouter Python SDK is optional and required only for live model calls; the offline fixture works with the base install. Pydantic remains optional. The canvas is served as local files and does not send workflow data to a remote service.
+No Node.js, frontend bundler, database, C++ package manager or Python web framework is required. The standard PyPI install includes the OpenRouter Python SDK and Pydantic so model and validation nodes are ready to use. Live model calls still require an OpenRouter API key; the offline fixture needs no key or network call. The canvas is served as local files and does not send workflow data to a remote service.
 ## Extending nodes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/docs/SEMANTICS.md RENAMED Viewed

@@ -10,11 +10,11 @@ The graph hash pins each run to the exact workflow document it started with. Sav
 ## Execution split
-The C++17 runtime owns sequential scheduling, node transitions, direct equality conditions, step limits, cancellation checks between callbacks and file-checkpoint commits. Python executes the local web API, model requests, registered integrations, demo fixtures and optional Pydantic validation. A Python callback crosses the C ABI and returns its update to the C++ scheduler before the next node runs.
+The C++17 runtime owns sequential scheduling, node transitions, direct equality conditions, step limits, cancellation checks between callbacks and file-checkpoint commits. Python executes the local web API, model requests, registered integrations, demo fixtures and Pydantic validation. A Python callback crosses the C ABI and returns its update to the C++ scheduler before the next node runs.
 A **demo model node uses a deterministic response template, not a model**. Select OpenRouter on a Chat Model or Agent node to make a request through the official OpenRouter Python SDK. The API key is read from the Studio process environment, which loads the local `.env` file on startup. The initial adapter performs non-streaming chat completions; it supports role-tagged messages, temperature, token limit, and JSON output mode.
-OpenRouter JSON mode requests a JSON object; the next Structured output node can validate its shape and values. Built-in validation supports string, integer, number, boolean, object and array fields with strict primitive types. Pydantic v2 is an optional backend, enabled only when installed in the Python environment that launches Studio. It adds Pydantic model validation to the same field list; custom Python validators are not configured through this UI yet.
+OpenRouter JSON mode requests a JSON object; the next Structured output node can validate its shape and values. Built-in validation supports string, integer, number, boolean, object and array fields with strict primitive types. The standard PyPI install includes Pydantic v2, which adds Pydantic model validation to the same field list; custom Python validators are not configured through this UI yet.
 ## Native step commit

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/pyproject.toml RENAMED Viewed

@@ -4,10 +4,10 @@ build-backend = "scikit_build_core.build"
 [project]
 name = "graphcore-studio"
-version = "0.2.0"
+version = "0.2.2"
 description = "A local-first visual agent workflow studio powered by a native C++ graph runtime"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.9.2"
 license = "MIT"
 license-files = ["LICENSE"]
 classifiers = [
@@ -21,14 +21,18 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Topic :: Scientific/Engineering :: Artificial Intelligence",
   "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 keywords = ["agents", "agentic-workflows", "graph", "C++", "visual-workflow-builder"]
-dependencies = []
+dependencies = [
+  "openrouter>=0.10.8,<1",
+  "pydantic>=2,<3",
+]
 [project.optional-dependencies]
-models = ["openrouter>=0.10,<1"]
+models = ["openrouter>=0.10.8,<1"]
 pydantic = ["pydantic>=2,<3"]
 [project.scripts]

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/python/graphcore/__init__.py RENAMED Viewed

@@ -16,7 +16,7 @@ from dataclasses import dataclass, field
 from typing import Optional
 END = "__end__"
-__version__ = "0.2.0"
+__version__ = "0.2.2"
 class GraphCoreError(RuntimeError):
     pass

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/requirements-models.txt RENAMED Viewed

@@ -1,2 +1,2 @@
 # Official OpenRouter client used by the Chat Model node through GraphCore's Python wrapper.
-openrouter>=0.10,<1
+openrouter>=0.10.8,<1

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/studio/engine.py RENAMED Viewed

@@ -52,7 +52,16 @@ def render(template, state):
         return value if isinstance(value, str) else json.dumps(value, ensure_ascii=False)
     return re.sub(r"\{\{\s*([A-Za-z_][A-Za-z0-9_.]*)\s*\}\}", replace, template)
-def validate(workflow):
+def resolve_model(config, models=None):
+    model = config.get("model", "")
+    if isinstance(model, str) and model.startswith("$"):
+        name = model[1:]
+        if not KEY.fullmatch(name) or name not in (models or {}):
+            raise WorkflowError("Unknown model variable: " + model + ". Add it in Model integrations.")
+        return models[name]
+    return model
+def validate(workflow, models=None):
     errors = []
     if not isinstance(workflow, dict):
         return ["Workflow must be an object"]
@@ -103,6 +112,9 @@ def validate(workflow):
                 if field in config and not isinstance(config[field], str): errors.append(ident + ": " + field + " must be text")
             if provider != "demo" and (not isinstance(config.get("model"), str) or not config["model"].strip() or len(config["model"]) > 200):
                 errors.append(ident + ": choose a model identifier (1–200 characters)")
+            elif provider != "demo":
+                try: resolve_model(config, models)
+                except WorkflowError as error: errors.append(ident + ": " + str(error))
             if "temperature" in config and (isinstance(config["temperature"], bool) or not isinstance(config["temperature"], (int,float)) or not math.isfinite(config["temperature"]) or not 0 <= config["temperature"] <= 2):
                 errors.append(ident + ": temperature must be between 0 and 2")
             if "max_tokens" in config and (isinstance(config["max_tokens"], bool) or not isinstance(config["max_tokens"], int) or not 1 <= config["max_tokens"] <= 200000):
@@ -230,7 +242,7 @@ def chat_messages(config, state):
                     {"role":"user", "content":config.get("prompt", "{{input}}") }]
     return [{"role":message["role"], "content":render(message["content"], state)} for message in messages]
-def invoke_model(config, state):
+def invoke_model(config, state, models=None):
     provider = config.get("provider", "demo")
     if provider == "demo":
         text = render(config.get("demo_response", "Demo response for {{input}}"), state)
@@ -239,13 +251,14 @@ def invoke_model(config, state):
     if not meta: raise WorkflowError("This initial release supports OpenRouter models. Choose OpenRouter or the offline fixture.")
     api_key = os.environ.get("OPENROUTER_API_KEY", "").strip()
     if not api_key: raise WorkflowError("Configure OPENROUTER_API_KEY in Model integrations before running this model.")
-    if not isinstance(config.get("model"), str) or not config["model"].strip():
+    model_id = resolve_model(config, models)
+    if not isinstance(model_id, str) or not model_id.strip():
         raise WorkflowError("Enter an OpenRouter model ID, such as openai/gpt-4o-mini.")
     try:
         from openrouter import OpenRouter
     except ImportError as error:
         raise WorkflowError("Install the OpenRouter SDK in the Studio Python environment: python -m pip install openrouter") from error
-    kwargs = {"model":config["model"], "messages":chat_messages(config, state), "stream":False,
+    kwargs = {"model":model_id, "messages":chat_messages(config, state), "stream":False,
               "temperature":config.get("temperature", 0.2),
               "max_completion_tokens":config.get("max_tokens", 1024),
               "timeout_ms":round(config.get("timeout", 60) * 1000)}
@@ -279,7 +292,7 @@ def invoke_model(config, state):
             # A reasoning-only response often means hidden reasoning consumed the
             # entire completion limit. Ask for a direct answer on the single retry.
             retry["reasoning_effort"] = "none"
-            return invoke_model(retry, state)
+            return invoke_model(retry, state, models)
         finish_reason = field(choice, "finish_reason", "unknown")
         reasoning = field(message, "reasoning")
         reason = " The model returned reasoning but no visible answer." if reasoning else ""
@@ -289,8 +302,8 @@ def invoke_model(config, state):
         return content
     return content if isinstance(content, str) else json.dumps(content, ensure_ascii=False)
-def compile_workflow(workflow, emit=lambda kind, **data: None):
-    errors = validate(workflow)
+def compile_workflow(workflow, emit=lambda kind, **data: None, models=None):
+    errors = validate(workflow, models)
     if errors: raise WorkflowError("\n".join(errors))
     version = hashlib.sha256(json.dumps(workflow, sort_keys=True).encode()).hexdigest()
     graph = Graph(version)
@@ -303,9 +316,10 @@ def compile_workflow(workflow, emit=lambda kind, **data: None):
             if kind == "input":
                 result = {}
             elif kind in ("agent", "model"):
-                emit("model.started", node=ident, provider=config.get("provider", "demo"), model=config.get("model", ""))
-                result = {key: invoke_model(config, state)}
-                emit("model.completed", node=ident, provider=config.get("provider", "demo"), model=config.get("model", ""))
+                model_id = resolve_model(config, models) if config.get("provider", "demo") != "demo" else ""
+                emit("model.started", node=ident, provider=config.get("provider", "demo"), model=model_id)
+                result = {key: invoke_model(config, state, models)}
+                emit("model.completed", node=ident, provider=config.get("provider", "demo"), model=model_id)
             elif kind == "tool":
                 value = lookup(state, config.get("input_field", "input"))
                 result = {key: TOOLS[config.get("tool", "word_count")]["function"](copy.deepcopy(value), copy.deepcopy(config))}

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/studio/server.py RENAMED Viewed

@@ -2,6 +2,7 @@
 """Local-only Studio server. No third-party web framework or frontend build needed."""
 import argparse
 import copy
+import errno
 from concurrent.futures import ThreadPoolExecutor
 from datetime import datetime, timezone
 from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
@@ -23,7 +24,7 @@ import uuid
 ROOT = Path(__file__).resolve().parents[1]
 sys.path.insert(0, str(ROOT / "python"))
 sys.path.insert(0, str(ROOT))
-from studio.engine import compile_workflow, validate, TOOLS, pydantic_available, provider_availability, register_tool
+from studio.engine import compile_workflow, validate, TOOLS, KEY, pydantic_available, provider_availability, register_tool
 WEB = ROOT / "studio" / "web"
 TEMPLATES = ROOT / "studio" / "templates"
@@ -94,6 +95,8 @@ class Store:
         self.base_environment = dict(os.environ)
         self.env_lock = threading.RLock()
         self.saved_environment = load_dotenv(self.env_path)
+        self.models_path = self.root / "models.json"
+        self.models = json.loads(self.models_path.read_text(encoding="utf-8")) if self.models_path.exists() else {}
         self.workflows = self.root / "workflows"; self.workflows.mkdir(exist_ok=True)
         self.runs = self.root / "runs"; self.runs.mkdir(exist_ok=True)
         self.lock = threading.RLock()
@@ -126,6 +129,19 @@ class Store:
         return [{"name": name, "configured": name in os.environ, "stored": name in stored}
                 for name in names]
+    def update_models(self, models):
+        if not isinstance(models, dict) or len(models) > 50:
+            raise ValueError("Configure up to 50 named models")
+        for name, model in models.items():
+            if not isinstance(name, str) or not KEY.fullmatch(name):
+                raise ValueError("Model variable names must be simple identifiers")
+            if not isinstance(model, str) or not model.strip() or len(model) > 200 or "/" not in model:
+                raise ValueError("Each model needs an OpenRouter model ID such as openai/gpt-4o-mini")
+        with self.lock:
+            write_json(self.models_path, models)
+            self.models = dict(models)
+        return dict(self.models)
     def update_environment(self, values, remove):
         if not isinstance(values, dict) or not isinstance(remove, list):
             raise ValueError("Environment values must be an object and removals a list")
@@ -167,14 +183,15 @@ class Store:
         write_json(self.runs / (ident + ".json"), self.records[ident])
     def start(self, workflow, inputs, max_steps=100):
-        errors = validate(workflow)
+        with self.lock: models = dict(self.models)
+        errors = validate(workflow, models)
         if errors: raise ValueError("\n".join(errors))
         if not isinstance(inputs, dict): raise ValueError("Inputs must be a JSON object")
         if not isinstance(max_steps, int) or not 1 <= max_steps <= 1000: raise ValueError("Step limit must be 1–1000")
         if not self.slots.acquire(blocking=False): raise ValueError("Four runs are already active; wait for one to finish")
         ident = uuid.uuid4().hex
         record = {"id": ident, "name": workflow.get("name", "Untitled workflow"), "workflow": copy.deepcopy(workflow),
-                  "inputs": copy.deepcopy(inputs), "max_steps": max_steps, "created": now(), "status": "queued",
+                  "inputs": copy.deepcopy(inputs), "models": models, "max_steps": max_steps, "created": now(), "status": "queued",
                   "events": [], "state": {}, "prompt": "", "error": "", "duration_ms": 0}
         try:
             with self.lock:
@@ -222,7 +239,7 @@ class Store:
             with self.lock:
                 record = self.records[ident]
                 workflow, inputs, budget = record["workflow"], record["inputs"], record["max_steps"]
-            graph = compile_workflow(workflow, emit)
+            graph = compile_workflow(workflow, emit, record.get("models", {}))
             with self.lock:
                 self.active[ident] = graph
                 if record["status"] == "cancelling": graph.cancel()
@@ -286,6 +303,8 @@ class Handler(BaseHTTPRequestHandler):
                     "tools": [{"name": k, "description": v["description"]} for k,v in TOOLS.items()]})
             if path == "/api/settings/environment":
                 return self.send({"variables": self.server.store.environment_status()})
+            if path == "/api/settings/models":
+                with self.server.store.lock: return self.send({"models": dict(self.server.store.models)})
             if path == "/api/workflows":
                 with self.server.store.lock:
                     items = [json.loads(p.read_text()) for p in self.server.store.workflows.glob("*.json")]
@@ -313,10 +332,12 @@ class Handler(BaseHTTPRequestHandler):
             body = json.loads(self.rfile.read(size), parse_constant=lambda value: (_ for _ in ()).throw(ValueError("Non-finite JSON number")))
             if not isinstance(body, dict): raise ValueError("Request must be a JSON object")
             path = urllib.parse.urlsplit(self.path).path
-            if path == "/api/validate": return self.send({"errors": validate(body.get("workflow"))})
+            if path == "/api/validate": return self.send({"errors": validate(body.get("workflow"), self.server.store.models)})
             if path == "/api/settings/environment":
                 return self.send({"variables": self.server.store.update_environment(
                     body.get("values", {}), body.get("remove", []))})
+            if path == "/api/settings/models":
+                return self.send({"models": self.server.store.update_models(body.get("models"))})
             if path == "/api/workflows":
                 workflow = body.get("workflow")
                 if not isinstance(workflow, dict) or workflow.get("format") != "graphcore.studio.v1": raise ValueError("Invalid workflow document")
@@ -346,7 +367,7 @@ class Server(ThreadingHTTPServer):
 def main():
     parser = argparse.ArgumentParser(description="GraphCore Studio — local visual agent builder")
-    parser.add_argument("--port", type=int, default=8787)
+    parser.add_argument("--port", type=int, default=None, help="Local port (default: 8787, then an available port)")
     parser.add_argument("--data", default=os.environ.get("GRAPHCORE_STUDIO_DATA", str(ROOT / "studio" / "data")))
     parser.add_argument("--plugin", action="append", default=[], help="Trusted local Python module file registering tools")
     args = parser.parse_args()
@@ -356,7 +377,13 @@ def main():
         module = importlib.util.module_from_spec(spec); spec.loader.exec_module(module)
         module.register(register_tool)
     store = Store(args.data)
-    server = Server(("127.0.0.1", args.port), store)
+    try:
+        server = Server(("127.0.0.1", args.port if args.port is not None else 8787), store)
+    except OSError as error:
+        if args.port is not None or getattr(error, "errno", None) != errno.EADDRINUSE:
+            store.close()
+            raise
+        server = Server(("127.0.0.1", 0), store)
     print("GraphCore Studio: http://127.0.0.1:" + str(server.server_port), flush=True)
     print("Local files: " + str(store.root), flush=True)
     try: server.serve_forever()

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/studio/web/app.js RENAMED Viewed

@@ -23,7 +23,7 @@ const META = {
  output:{name:'Output',sub:'Return your final result',group:'FLOW',color:'#7aa39a',bg:'#edf6f4'}
 };
 const icon = kind => `<span class="node-icon" style="--node-color:${META[kind]?.color};--node-bg:${META[kind]?.bg}"><svg viewBox="0 0 22 22">${icons[kind]||icons.agent}</svg></span>`;
-const S = {workflow:null,selected:null,library:'nodes',tab:'input',bootstrap:null,view:{x:35,y:55,z:.8},undo:[],redo:[],run:null,nodeStatus:{},connection:null,inputText:'{}',poll:null,dirty:false};
+const S = {workflow:null,selected:null,library:'nodes',tab:'input',bootstrap:null,view:{x:35,y:55,z:.8},undo:[],redo:[],run:null,nodeStatus:{},connection:null,inputText:'{}',poll:null,dirty:false,models:{}};
 let toastTimer;
 function toast(message){$('#toast').textContent=message;$('#toast').hidden=false;clearTimeout(toastTimer);toastTimer=setTimeout(()=>$('#toast').hidden=true,4500);}
 async function api(path, body){const response=await fetch(path,{method:body===undefined?'GET':'POST',headers:body===undefined?{}:{'Content-Type':'application/json','X-Studio-Token':S.bootstrap.csrf},body:body===undefined?undefined:JSON.stringify(body)});const data=await response.json();if(!response.ok)throw Error(data.error||'Request failed');return data;}
@@ -33,8 +33,8 @@ function load(workflow){if(S.poll){clearTimeout(S.poll);S.poll=null;}S.workflow=
 function renderAll(){if(!S.workflow)return;$('#workflow-name').value=S.workflow.name;$('#breadcrumb').textContent=S.workflow.name;$('#workflow-description').textContent=S.workflow.description||'Build a team of agents. Connect the way they think.';renderLibrary();renderNodes();renderInspector();renderConsole();$('#undo-button').disabled=!S.undo.length;$('#redo-button').disabled=!S.redo.length;}
 function renderLibrary(){const text=$('#node-search').value.toLowerCase();document.querySelectorAll('[data-library]').forEach(b=>b.classList.toggle('active',b.dataset.library===S.library));let html='';if(S.library==='templates'){html=S.bootstrap.templates.map((t,i)=>`<button class="template-card" data-template="${i}">${icon(i===1?'schema':i===2?'tool':'agent')}<strong>${esc(t.name)}</strong><p>${esc(t.description)}</p><small>${t.nodes.length} nodes &nbsp;↗&nbsp; Open template</small></button>`).join('');html+='<button class="template-card" id="blank-template"><strong>＋ Start from scratch</strong><p>A blank canvas for your next idea.</p></button>';}else{for(const group of ['INTELLIGENCE','FLOW','INTEGRATIONS']){const kinds=Object.keys(META).filter(k=>META[k].group===group&&`${META[k].name} ${META[k].sub}`.toLowerCase().includes(text));if(!kinds.length)continue;html+=`<div class="library-group">${group}</div>`;for(const kind of kinds){const m=META[kind];html+=`<button class="palette-node" draggable="true" data-kind="${kind}" aria-label="Add ${m.name}">${icon(kind)}<span><strong>${m.name}</strong><small>${m.sub}</small></span><span class="grab">⠿</span></button>`;}}}$('#node-library').innerHTML=html;document.querySelectorAll('.palette-node').forEach(el=>{el.addEventListener('dragstart',e=>{e.dataTransfer.setData('application/graphcore-node',el.dataset.kind);e.dataTransfer.effectAllowed='copy';});el.onclick=()=>{const area=$('#canvas-area');addNode(el.dataset.kind,(area.clientWidth/2-S.view.x)/S.view.z-113,(area.clientHeight/2-S.view.y)/S.view.z-54);};});document.querySelectorAll('[data-template]').forEach(b=>b.onclick=()=>confirmReplace(()=>load(S.bootstrap.templates[+b.dataset.template])));if($('#blank-template'))$('#blank-template').onclick=()=>confirmReplace(()=>load({format:'graphcore.studio.v1',id:'workflow_'+Date.now(),name:'Untitled workflow',description:'A blank canvas for your next idea.',inputs:{input:'Hello, world'},nodes:[],edges:[]}));}
 function confirmReplace(action){if(!S.dirty){action();return;}showModal('Replace this draft?',`<p class="modal-copy">Save or export your current workflow first if you want to keep it.</p><div class="modal-actions"><button class="button" id="keep-draft">Keep editing</button><button class="button primary" id="replace-draft">Replace draft</button></div>`);$('#keep-draft').onclick=closeModal;$('#replace-draft').onclick=()=>{closeModal();action();};}
-function nodeSubtitle(n){const c=n.config||{};if(n.type==='agent'||n.type==='model')return c.provider==='demo'?'Offline fixture':`${c.provider||'demo'} · ${c.model||'choose model'}`;if(n.type==='condition')return `${c.field||'field'} equals ${JSON.stringify(c.expected)}`;if(n.type==='tool')return c.tool||'word_count';if(n.type==='schema')return c.engine==='pydantic'?'Pydantic validation':'Portable schema validation';return META[n.type]?.sub||n.type;}
-function renderNodes(){const w=S.workflow;$('#nodes').innerHTML=w.nodes.map(n=>{const m=META[n.type]||META.agent;const selected=S.selected===n.id;const c=n.config||{};return `<div class="canvas-node ${esc(n.type)} ${selected?'selected':''} ${S.nodeStatus[n.id]||''}" id="node-${esc(n.id)}" data-node="${esc(n.id)}" style="left:${Number(n.x)||0}px;top:${Number(n.y)||0}px" tabindex="0" role="group" aria-label="${esc(n.label)} node"><div class="node-head">${icon(n.type)}<div><strong>${esc(n.label||m.name)}</strong><small>${esc(nodeSubtitle(n))}</small></div><span class="node-menu">⋮</span></div><div class="node-foot"><span>${n.type==='condition'?'C++ routing':n.type==='agent'?'Agent':esc(m.name)}</span><code>${esc(n.type==='input'?'workflow inputs':n.type==='output'?'output':c.output_key||n.type==='condition'&&'true / false'||n.id)}</code></div>${n.type!=='input'?`<button class="port input" data-target="${esc(n.id)}" aria-label="Connect to ${esc(n.label)}"></button>`:''}${n.type==='condition'?`<button class="port output true" data-source="${esc(n.id)}" data-port="true" aria-label="True branch from ${esc(n.label)}"></button><button class="port output false" data-source="${esc(n.id)}" data-port="false" aria-label="False branch from ${esc(n.label)}"></button>`:n.type!=='output'?`<button class="port output" data-source="${esc(n.id)}" data-port="next" aria-label="Connect from ${esc(n.label)}"></button>`:''}</div>`;}).join('');$('#empty-canvas').hidden=w.nodes.length>0;$('#graph-stats').textContent=`${w.nodes.length} nodes · ${w.edges.length} connections`;const real=w.nodes.find(n=>['agent','model'].includes(n.type)&&(n.config?.provider||'demo')!=='demo');$('#mode-label').textContent=real?`${real.config.provider} model · Python integration`:'Offline demo · no model calls';document.querySelectorAll('.canvas-node').forEach(el=>{el.addEventListener('pointerdown',startNodeDrag);el.addEventListener('keydown',e=>{if(e.key==='Enter'){selectNode(el.dataset.node);}});});document.querySelectorAll('.port.output').forEach(el=>{el.addEventListener('keydown',e=>{if(e.key==='Enter'){e.preventDefault();S.connection={source:el.dataset.source,port:el.dataset.port};toast('Select an input port to connect.');}});el.addEventListener('pointerdown',e=>{e.stopPropagation();S.connection={source:el.dataset.source,port:el.dataset.port};$('#canvas-hint').textContent='Click an input dot to connect · Esc to cancel';el.classList.add('connecting');});});document.querySelectorAll('.port.input').forEach(el=>{el.addEventListener('keydown',e=>{if(e.key==='Enter'&&S.connection){e.preventDefault();connect(S.connection.source,el.dataset.target,S.connection.port);}});el.addEventListener('pointerdown',e=>{e.stopPropagation();if(S.connection)connect(S.connection.source,el.dataset.target,S.connection.port);});});applyView();drawEdges();}
+function nodeSubtitle(n){const c=n.config||{};if(n.type==='agent'||n.type==='model')return c.provider==='demo'?'Offline fixture':`${c.provider||'openrouter'} · ${c.model||'choose model'}`;if(n.type==='condition')return `${c.field||'field'} equals ${JSON.stringify(c.expected)}`;if(n.type==='tool')return c.tool||'word_count';if(n.type==='schema')return c.engine==='pydantic'?'Pydantic validation':'Portable schema validation';return META[n.type]?.sub||n.type;}
+function renderNodes(){const w=S.workflow;$('#nodes').innerHTML=w.nodes.map(n=>{const m=META[n.type]||META.agent;const selected=S.selected===n.id;const c=n.config||{};return `<div class="canvas-node ${esc(n.type)} ${selected?'selected':''} ${S.nodeStatus[n.id]||''}" id="node-${esc(n.id)}" data-node="${esc(n.id)}" style="left:${Number(n.x)||0}px;top:${Number(n.y)||0}px" tabindex="0" role="group" aria-label="${esc(n.label)} node"><div class="node-head">${icon(n.type)}<div><strong>${esc(n.label||m.name)}</strong><small>${esc(nodeSubtitle(n))}</small></div><span class="node-menu">⋮</span></div><div class="node-foot"><span>${n.type==='condition'?'C++ routing':n.type==='agent'?'Agent':esc(m.name)}</span><code>${esc(n.type==='input'?'workflow inputs':n.type==='output'?'output':c.output_key||n.type==='condition'&&'true / false'||n.id)}</code></div>${n.type!=='input'?`<button class="port input" data-target="${esc(n.id)}" aria-label="Connect to ${esc(n.label)}"></button>`:''}${n.type==='condition'?`<button class="port output true" data-source="${esc(n.id)}" data-port="true" aria-label="True branch from ${esc(n.label)}"></button><button class="port output false" data-source="${esc(n.id)}" data-port="false" aria-label="False branch from ${esc(n.label)}"></button>`:n.type!=='output'?`<button class="port output" data-source="${esc(n.id)}" data-port="next" aria-label="Connect from ${esc(n.label)}"></button>`:''}</div>`;}).join('');$('#empty-canvas').hidden=w.nodes.length>0;$('#graph-stats').textContent=`${w.nodes.length} nodes · ${w.edges.length} connections`;const real=w.nodes.filter(n=>['agent','model'].includes(n.type)&&(n.config?.provider||'demo')!=='demo');$('#mode-label').textContent=real.length?`${real.length} model node${real.length===1?'':'s'} · ${new Set(real.map(n=>n.config.model)).size} selection${new Set(real.map(n=>n.config.model)).size===1?'':'s'}`:'Offline demo · no model calls';document.querySelectorAll('.canvas-node').forEach(el=>{el.addEventListener('pointerdown',startNodeDrag);el.addEventListener('keydown',e=>{if(e.key==='Enter'){selectNode(el.dataset.node);}});});document.querySelectorAll('.port.output').forEach(el=>{el.addEventListener('keydown',e=>{if(e.key==='Enter'){e.preventDefault();S.connection={source:el.dataset.source,port:el.dataset.port};toast('Select an input port to connect.');}});el.addEventListener('pointerdown',e=>{e.stopPropagation();S.connection={source:el.dataset.source,port:el.dataset.port};$('#canvas-hint').textContent='Click an input dot to connect · Esc to cancel';el.classList.add('connecting');});});document.querySelectorAll('.port.input').forEach(el=>{el.addEventListener('keydown',e=>{if(e.key==='Enter'&&S.connection){e.preventDefault();connect(S.connection.source,el.dataset.target,S.connection.port);}});el.addEventListener('pointerdown',e=>{e.stopPropagation();if(S.connection)connect(S.connection.source,el.dataset.target,S.connection.port);});});applyView();drawEdges();}
 function dimensions(node){const el=document.getElementById('node-'+node.id);return {w:226,h:el?.offsetHeight||108};}
 function anchor(node,side,port){const d=dimensions(node);return {x:(Number(node.x)||0)+(side==='out'?d.w:0),y:(Number(node.y)||0)+d.h*(port==='true'?.35:port==='false'?.72:.5)};}
 function curve(a,b){const distance=Math.max(70,Math.abs(b.x-a.x)*.5);return `M ${a.x} ${a.y} C ${a.x+distance} ${a.y}, ${b.x-distance} ${b.y}, ${b.x} ${b.y}`;}
@@ -65,7 +65,8 @@ function modelEditor(node){
  html+=field('Provider','provider',provider,{select:providers});
  if(provider==='demo')html+=field('Demo response fixture','demo_response',c.demo_response||'Demo response: {{input}}',{area:true,rows:2,help:'Used for offline testing. It does not call a model.'});
  else {
-  html+=field('OpenRouter model ID','model',c.model||'openai/gpt-4o-mini',{help:'Use the model slug shown in the OpenRouter model catalog, for example openai/gpt-4o-mini.'});
+  html+=field('Model selection','model',c.model||'openai/gpt-4o-mini',{help:'Use $model1 for a saved model variable, or enter an OpenRouter model ID directly.'});
+  html+=`<label class="field"><span>Insert saved model</span><select id="model-variable"><option value="">Choose a model variable…</option>${Object.entries(S.models).map(([name,id])=>`<option value="$${esc(name)}" ${c.model==='$'+name?'selected':''}>$${esc(name)} · ${esc(id)}</option>`).join('')}</select><small>Manage model variables in Model integrations.</small></label>`;
   html+='<div class="inspector-note">Add <strong>OPENROUTER_API_KEY</strong> in <strong>Model integrations</strong>. OpenRouter model calls run through GraphCore’s Python bridge.</div>';
   if(router&&!router.installed)html+='<div class="inspector-note">Install the SDK in the Python environment running Studio: <code>python -m pip install openrouter</code>, then restart Studio.</div>';
  }
@@ -88,21 +89,22 @@ if(kind==='approval'){html+='<div class="inspector-section">HUMAN IN THE LOOP</d
 if(kind==='output'){html+=field('Result template','template',c.template||'{{input}}',{area:true,rows:7,help:'Combine state fields into your final result.'});}
 if(!['input','condition','output'].includes(kind)){html+='<div class="inspector-section">STATE</div>';html+=field('Save output to','output_key',c.output_key||node.id,{help:'Other nodes can read this field.'});}
 html+='<div class="inspector-section">CONNECTIONS</div>';const ports=kind==='condition'?['true','false']:kind==='output'?[]:['next'];for(const port of ports){const edge=S.workflow.edges.find(e=>e.source===node.id&&(e.port||'next')===port);html+=`<div class="connection-row"><span>${port} →</span><select data-route="${port}" aria-label="${port} target"><option value="">Not connected</option>${S.workflow.nodes.filter(n=>n.id!==node.id&&n.type!=='input').map(n=>`<option value="${esc(n.id)}" ${edge?.target===n.id?'selected':''}>${esc(n.label)}</option>`).join('')}</select></div>`;}if(!ports.length)html+='<div class="field-help">This node completes the workflow.</div>';html+='<button class="button delete-node" id="delete-node">Delete node</button>';$('#inspector-content').innerHTML=html;
-$('#node-label').onchange=e=>{mark();node.label=e.target.value||META[kind].name;changed();renderNodes();};document.querySelectorAll('[data-config]').forEach(el=>el.onchange=()=>{let value=el.value;try{if(el.dataset.json)value=JSON.parse(value);if(['temperature','max_tokens','timeout'].includes(el.dataset.config))value=Number(value);mark();node.config[el.dataset.config]=value;if(el.dataset.config==='provider'&&value==='openrouter'&&!String(node.config.model||'').includes('/'))node.config.model='openai/gpt-4o-mini';changed();renderNodes();if(['provider','engine'].includes(el.dataset.config))renderInspector();}catch(error){toast('Invalid JSON value: '+error.message);el.setAttribute('aria-invalid','true');}});document.querySelectorAll('[data-message-role]').forEach(el=>el.onchange=()=>{mark();node.config.messages[+el.dataset.messageRole].role=el.value;changed();});document.querySelectorAll('[data-message-content]').forEach(el=>{el.addEventListener('input',()=>{if(!el.dataset.historyMarked){mark();el.dataset.historyMarked='1';}node.config.messages[+el.dataset.messageContent].content=el.value;changed();});el.addEventListener('blur',()=>{delete el.dataset.historyMarked;});});document.querySelectorAll('[data-message-variable]').forEach(el=>el.onchange=()=>{const name=el.value;if(!name)return;const area=[...document.querySelectorAll('[data-message-content]')].find(a=>a.dataset.messageContent===el.dataset.messageVariable);const token='{{'+name+'}}';const start=area.selectionStart??area.value.length,end=area.selectionEnd??start;area.setRangeText(token,start,end,'end');node.config.messages[+el.dataset.messageVariable].content=area.value;changed();area.focus();el.value='';});document.querySelectorAll('[data-message-remove]').forEach(el=>el.onclick=()=>{mark();node.config.messages.splice(+el.dataset.messageRemove,1);changed();renderInspector();});if($('#add-message'))$('#add-message').onclick=()=>{if(node.config.messages.length>=20){toast('A model can have up to 20 messages.');return;}mark();node.config.messages.push({role:'user',content:''});changed();renderInspector();document.querySelectorAll('[data-message-content]')[node.config.messages.length-1]?.focus();};if($('#json-output'))$('#json-output').onchange=e=>{mark();node.config.json_output=e.target.checked;changed();};document.querySelectorAll('[data-schema]').forEach(el=>el.onchange=()=>{mark();node.config.fields[+el.closest('[data-index]').dataset.index][el.dataset.schema]=el.type==='checkbox'?el.checked:el.value;changed();});document.querySelectorAll('[data-remove-field]').forEach(el=>el.onclick=()=>{mark();node.config.fields.splice(+el.dataset.removeField,1);changed();renderInspector();});if($('#add-schema-field'))$('#add-schema-field').onclick=()=>{mark();node.config.fields.push({name:'field_'+(node.config.fields.length+1),type:'string',required:true});changed();renderInspector();};document.querySelectorAll('[data-route]').forEach(el=>el.onchange=()=>{if(el.value)connect(node.id,el.value,el.dataset.route);else{mark();S.workflow.edges=S.workflow.edges.filter(e=>!(e.source===node.id&&(e.port||'next')===el.dataset.route));changed();renderNodes();}});$('#delete-node').onclick=deleteSelected;}
+$('#node-label').onchange=e=>{mark();node.label=e.target.value||META[kind].name;changed();renderNodes();};document.querySelectorAll('[data-config]').forEach(el=>el.onchange=()=>{let value=el.value;try{if(el.dataset.json)value=JSON.parse(value);if(['temperature','max_tokens','timeout'].includes(el.dataset.config))value=Number(value);mark();node.config[el.dataset.config]=value;if(el.dataset.config==='provider'&&value==='openrouter'&&!String(node.config.model||'').includes('/')&&!String(node.config.model||'').startsWith('$'))node.config.model='openai/gpt-4o-mini';changed();renderNodes();if(['provider','engine'].includes(el.dataset.config))renderInspector();}catch(error){toast('Invalid JSON value: '+error.message);el.setAttribute('aria-invalid','true');}});document.querySelectorAll('[data-message-role]').forEach(el=>el.onchange=()=>{mark();node.config.messages[+el.dataset.messageRole].role=el.value;changed();});document.querySelectorAll('[data-message-content]').forEach(el=>{el.addEventListener('input',()=>{if(!el.dataset.historyMarked){mark();el.dataset.historyMarked='1';}node.config.messages[+el.dataset.messageContent].content=el.value;changed();});el.addEventListener('blur',()=>{delete el.dataset.historyMarked;});});document.querySelectorAll('[data-message-variable]').forEach(el=>el.onchange=()=>{const name=el.value;if(!name)return;const area=[...document.querySelectorAll('[data-message-content]')].find(a=>a.dataset.messageContent===el.dataset.messageVariable);const token='{{'+name+'}}';const start=area.selectionStart??area.value.length,end=area.selectionEnd??start;area.setRangeText(token,start,end,'end');node.config.messages[+el.dataset.messageVariable].content=area.value;changed();area.focus();el.value='';});document.querySelectorAll('[data-message-remove]').forEach(el=>el.onclick=()=>{mark();node.config.messages.splice(+el.dataset.messageRemove,1);changed();renderInspector();});if($('#add-message'))$('#add-message').onclick=()=>{if(node.config.messages.length>=20){toast('A model can have up to 20 messages.');return;}mark();node.config.messages.push({role:'user',content:''});changed();renderInspector();document.querySelectorAll('[data-message-content]')[node.config.messages.length-1]?.focus();};if($('#model-variable'))$('#model-variable').onchange=e=>{if(!e.target.value)return;mark();node.config.model=e.target.value;changed();renderNodes();renderInspector();};if($('#json-output'))$('#json-output').onchange=e=>{mark();node.config.json_output=e.target.checked;changed();};document.querySelectorAll('[data-schema]').forEach(el=>el.onchange=()=>{mark();node.config.fields[+el.closest('[data-index]').dataset.index][el.dataset.schema]=el.type==='checkbox'?el.checked:el.value;changed();});document.querySelectorAll('[data-remove-field]').forEach(el=>el.onclick=()=>{mark();node.config.fields.splice(+el.dataset.removeField,1);changed();renderInspector();});if($('#add-schema-field'))$('#add-schema-field').onclick=()=>{mark();node.config.fields.push({name:'field_'+(node.config.fields.length+1),type:'string',required:true});changed();renderInspector();};document.querySelectorAll('[data-route]').forEach(el=>el.onchange=()=>{if(el.value)connect(node.id,el.value,el.dataset.route);else{mark();S.workflow.edges=S.workflow.edges.filter(e=>!(e.source===node.id&&(e.port||'next')===el.dataset.route));changed();renderNodes();}});$('#delete-node').onclick=deleteSelected;}
 function deleteSelected(){if(!S.selected)return;mark();S.workflow.nodes=S.workflow.nodes.filter(n=>n.id!==S.selected);S.workflow.edges=S.workflow.edges.filter(e=>e.source!==S.selected&&e.target!==S.selected);S.selected=null;changed();renderNodes();renderInspector();}
 function renderConsole(){document.querySelectorAll('[data-console]').forEach(b=>b.classList.toggle('active',b.dataset.console===S.tab));const r=S.run;const active=r&&['queued','running','cancelling'].includes(r.status);$('#stop-button').hidden=!active;$('#stop-button').disabled=r?.status==='cancelling';$('#run-button').disabled=!!active||!S.bootstrap.native;$('#run-status').textContent=r?`${r.status.charAt(0).toUpperCase()+r.status.slice(1)}${r.duration_ms?' · '+(r.duration_ms/1000).toFixed(2)+'s':''}`:'Ready to run';$('#event-count').textContent=r?.events.length||0;let html='';if(S.tab==='input'){html=`<div class="input-pane"><div><textarea id="run-input" spellcheck="false" aria-label="Workflow input JSON">${esc(S.inputText)}</textarea></div><div class="input-hint"><strong>Give your workflow a starting point.</strong>Pass a JSON object. Reference its fields in prompts with <code>{{input}}</code>.<br>Then click <strong style="display:inline;font-size:10px">Run workflow</strong>.</div></div>`;}else if(!r){html='<div class="console-empty"><span class="empty-symbol">▷</span><div><strong>A little input. A lot of possibility.</strong>Run your workflow to see results here.</div></div>';}else if(S.tab==='state'){html=`<pre class="state-json">${esc(JSON.stringify(r.state,null,2))}</pre>${!Object.keys(r.state).length?'<p class="field-help">Final state appears when the run completes or pauses. Intermediate updates are in the execution trace.</p>':''}`;}else if(S.tab==='trace'){html=r.events.map(e=>`<div class="trace-row"><time>${esc(e.time.slice(11,23))}</time><strong>${esc(e.type)}</strong><code>${esc(e.node||'')}</code>${e.updates?`<span title="${esc(JSON.stringify(e.updates))}">↳ ${esc(Object.keys(e.updates).join(', '))}</span>`:''}</div>`).join('')||'<p class="field-help">Waiting for native runtime events…</p>';}else if(r.status==='suspended'){html=`<div class="approval-panel"><span class="run-badge suspended">Awaiting human input</span><div class="question">${esc(r.prompt)}</div><div class="approval-form"><input id="approval-response" value="true" aria-label="Approval response as JSON"><button class="button primary" id="resume-button">Continue run →</button></div><p class="field-help">Enter a JSON response: true, false, or a quoted message.</p></div>`;}else if(r.error){html=`<div class="error-box">${esc(r.error)}</div><button class="button small" id="recover-button" style="margin-top:8px">Recover from checkpoint</button>`;}else if(r.status==='completed'){html=`<pre class="output-text">${esc(typeof r.state.output==='string'?r.state.output:JSON.stringify(r.state.output??r.state,null,2))}</pre>`;}else{html='<div class="console-empty"><span class="empty-symbol">◌</span><div><strong>Your workflow is running.</strong>Follow each step in the execution trace.</div></div>';}$('#console-content').innerHTML=html;if($('#run-input'))$('#run-input').oninput=e=>{S.inputText=e.target.value;try{const obj=JSON.parse(S.inputText);if(obj&&typeof obj==='object'&&!Array.isArray(obj)){S.workflow.inputs=obj;changed();}}catch{}};if($('#resume-button'))$('#resume-button').onclick=async()=>{try{const response=JSON.parse($('#approval-response').value);await api(`/api/runs/${r.id}/resume`,{response});S.run.status='queued';renderConsole();pollRun(r.id);}catch(error){toast(error.message);}};if($('#recover-button'))$('#recover-button').onclick=async()=>{try{await api(`/api/runs/${r.id}/recover`,{});S.run.status='queued';S.run.error='';renderConsole();pollRun(r.id);}catch(error){toast(error.message);}};}
-async function pollRun(id){clearTimeout(S.poll);try{const run=await api('/api/runs/'+id);if(S.run&&S.run.id!==id)return;S.run=run;S.nodeStatus={};for(const e of run.events){if(e.type==='node.started')S.nodeStatus[e.node]='running';if(e.type==='node.completed')S.nodeStatus[e.node]='completed';if(e.type==='node.failed')S.nodeStatus[e.node]='failed';if(e.type==='run.interrupted')S.nodeStatus[e.node]='suspended';}if(['failed','cancelled'].includes(run.status)){for(const [key,value]of Object.entries(S.nodeStatus))if(value==='running')S.nodeStatus[key]='failed';}if(run.status==='suspended'&&S.tab==='trace')S.tab='output';renderNodes();if(S.tab!=='input')renderConsole();else{const active=['queued','running','cancelling'].includes(run.status);$('#run-button').disabled=active;$('#run-status').textContent=run.status;$('#stop-button').hidden=!active;}if(['queued','running','cancelling'].includes(run.status))S.poll=setTimeout(()=>pollRun(id),250);else updateHistoryCount();}catch(error){toast(error.message);}}
+async function pollRun(id){clearTimeout(S.poll);try{const run=await api('/api/runs/'+id);if(!S.run||S.run.id!==id)return;S.run=run;S.nodeStatus={};for(const e of run.events){if(e.type==='node.started')S.nodeStatus[e.node]='running';if(e.type==='node.completed')S.nodeStatus[e.node]='completed';if(e.type==='node.failed')S.nodeStatus[e.node]='failed';if(e.type==='run.interrupted')S.nodeStatus[e.node]='suspended';}if(['failed','cancelled'].includes(run.status)){for(const [key,value]of Object.entries(S.nodeStatus))if(value==='running')S.nodeStatus[key]='failed';}if(run.status==='suspended'&&S.tab==='trace')S.tab='output';renderNodes();if(S.tab!=='input')renderConsole();else{const active=['queued','running','cancelling'].includes(run.status);$('#run-button').disabled=active;$('#run-status').textContent=run.status;$('#stop-button').hidden=!active;}if(['queued','running','cancelling'].includes(run.status))S.poll=setTimeout(()=>pollRun(id),250);else updateHistoryCount();}catch(error){toast(error.message);}}
 async function startRun(){try{const inputs=JSON.parse(S.inputText);const data=await api('/api/runs',{workflow:clone(S.workflow),inputs,max_steps:100});S.run={id:data.id,status:'queued',events:[],state:{},duration_ms:0};S.nodeStatus={};S.tab='output';renderConsole();pollRun(data.id);}catch(error){showModal('Cannot run this workflow',`<div class="error-box">${esc(error.message)}</div>`);}}
 function showModal(title,html){$('#modal-title').textContent=title;$('#modal-content').innerHTML=html;if(!$('#modal').open)$('#modal').showModal();}function closeModal(){$('#modal').close();}
 function environmentRow(name,status={},custom=false){return `<div class="environment-row ${custom?'custom':''}" data-env-row><label><span>${custom?'<input data-env-name value="'+esc(name)+'" placeholder="VARIABLE_NAME" aria-label="Environment variable name">':'<strong>'+esc(name)+'</strong>'}<small>${status.stored?'Saved in local .env':status.configured?'Available from Studio environment':'Not set'}</small></span><input type="password" data-env-value="${esc(name)}" autocomplete="new-password" placeholder="${status.stored?'Saved · leave empty to keep':status.configured?'Already available · enter to override':'Enter value'}" aria-label="Value for ${esc(name)}"></label><label class="env-remove"><input type="checkbox" data-env-remove="${esc(name)}"> Remove</label></div>`;}
-async function openIntegrations(){try{const data=await api('/api/settings/environment');const status=new Map(data.variables.map(v=>[v.name,v]));let html='<p class="modal-copy">Configure provider credentials and other <code>.env</code> variables here. Studio saves them in its local data folder and loads them before model initialization. Secret values are write-only in this UI.</p><div class="env-security">Local file: <code>studio/data/.env</code> · file permissions are restricted where the operating system supports it.</div><div class="inspector-section">PROVIDER VARIABLES</div>';const names=[...new Set(S.bootstrap.providers.flatMap(p=>p.env||[]))];if(!names.length)html+='<p class="field-help">Provider integrations do not declare API key variables.</p>';for(const name of names)html+=environmentRow(name,status.get(name));html+='<div class="inspector-section">CUSTOM .ENV VARIABLES</div><div id="custom-env-rows">';for(const v of data.variables.filter(v=>!names.includes(v.name)))html+=environmentRow(v.name,v,true);html+='</div><button class="button small" id="add-env-variable">＋ Add variable</button><div class="modal-actions"><button class="button" id="cancel-env">Cancel</button><button class="button primary" id="save-env">Save integrations</button></div><p class="field-help">Changes take effect immediately for new model calls. Shell-defined variables are available too. Avoid putting secrets in workflow JSON.</p>';showModal('Model integrations & environment',html);$('#cancel-env').onclick=closeModal;$('#add-env-variable').onclick=()=>{$('#custom-env-rows').insertAdjacentHTML('beforeend',environmentRow('',{},true));document.querySelector('#custom-env-rows [data-env-row]:last-child [data-env-name]')?.focus();};$('#save-env').onclick=saveEnvironment;}catch(error){toast(error.message);}}
-async function saveEnvironment(){const values={},remove=[];for(const row of document.querySelectorAll('[data-env-row]')){const nameField=row.querySelector('[data-env-name]'),secret=row.querySelector('[data-env-value]'),removeBox=row.querySelector('[data-env-remove]');const name=(nameField?nameField.value:secret.dataset.envValue).trim();if(!name)continue;if(removeBox?.checked){remove.push(name);continue;}if(secret.value)values[name]=secret.value;}try{const result=await api('/api/settings/environment',{values,remove});closeModal();toast('Environment saved locally. New model calls will use these values.');}catch(error){toast(error.message);}}
+async function openIntegrations(){try{const [data,modelData]=await Promise.all([api('/api/settings/environment'),api('/api/settings/models')]);S.models=modelData.models;const status=new Map(data.variables.map(v=>[v.name,v]));let html='<p class="modal-copy">Configure provider credentials and other <code>.env</code> variables here. Studio saves them in its local data folder and loads them before model initialization. Secret values are write-only in this UI.</p><div class="env-security">Local file: <code>studio/data/.env</code> · file permissions are restricted where the operating system supports it.</div><div class="inspector-section">NAMED MODELS</div>';html+='<p class="modal-copy">Save models as variables, then put <code>$model1</code> in a Chat Model or Agent node’s <code>model</code> field in workflow JSON. Each node can use a different variable.</p><div id="model-rows">';for(const [name,id] of Object.entries(S.models))html+=modelRow(name,id);html+='</div><button class="button small" id="add-model">＋ Add model</button>';html+='<div class="inspector-section">PROVIDER VARIABLES</div>';const names=[...new Set(S.bootstrap.providers.flatMap(p=>p.env||[]))];if(!names.length)html+='<p class="field-help">Provider integrations do not declare API key variables.</p>';for(const name of names)html+=environmentRow(name,status.get(name));html+='<div class="inspector-section">CUSTOM .ENV VARIABLES</div><div id="custom-env-rows">';for(const v of data.variables.filter(v=>!names.includes(v.name)))html+=environmentRow(v.name,v,true);html+='</div><button class="button small" id="add-env-variable">＋ Add variable</button><div class="modal-actions"><button class="button" id="cancel-env">Cancel</button><button class="button primary" id="save-env">Save integrations</button></div><p class="field-help">Changes take effect immediately for new model calls. Shell-defined variables are available too. Avoid putting secrets in workflow JSON.</p>';showModal('Model integrations · multiple models',html);$('#cancel-env').onclick=closeModal;$('#add-model').onclick=()=>{$('#model-rows').insertAdjacentHTML('beforeend',modelRow('',''));$('#model-rows [data-model-row]:last-child [data-model-name]')?.focus();};$('#model-rows').onclick=e=>{if(e.target.matches('[data-model-remove]'))e.target.closest('[data-model-row]').remove();};$('#add-env-variable').onclick=()=>{$('#custom-env-rows').insertAdjacentHTML('beforeend',environmentRow('',{},true));document.querySelector('#custom-env-rows [data-env-row]:last-child [data-env-name]')?.focus();};$('#save-env').onclick=saveEnvironment;}catch(error){toast(error.message);}}
+function modelRow(name,id){return `<div class="model-row" data-model-row><input data-model-name value="${esc(name)}" placeholder="model1" aria-label="Model variable name"><span>→</span><input data-model-id value="${esc(id)}" placeholder="openai/gpt-4o-mini" aria-label="OpenRouter model ID"><button type="button" data-model-remove aria-label="Remove model">×</button></div>`;}
+async function saveEnvironment(){const models={};for(const row of document.querySelectorAll('[data-model-row]')){const name=row.querySelector('[data-model-name]').value.trim(),id=row.querySelector('[data-model-id]').value.trim();if(!name&&!id)continue;if(!name||!id){toast('Each model needs a name and OpenRouter ID.');return;}if(Object.prototype.hasOwnProperty.call(models,name)){toast('Model variable names must be unique.');return;}models[name]=id;}const values={},remove=[];for(const row of document.querySelectorAll('[data-env-row]')){const nameField=row.querySelector('[data-env-name]'),secret=row.querySelector('[data-env-value]'),removeBox=row.querySelector('[data-env-remove]');const name=(nameField?nameField.value:secret.dataset.envValue).trim();if(!name)continue;if(removeBox?.checked){remove.push(name);continue;}if(secret.value)values[name]=secret.value;}try{const result=await api('/api/settings/models',{models});S.models=result.models;await api('/api/settings/environment',{values,remove});closeModal();renderNodes();renderInspector();toast('Models and environment saved locally.');}catch(error){toast(error.message);}}
 async function save(){try{await api('/api/workflows',{workflow:S.workflow});S.dirty=false;$('#save-status').textContent='Saved locally';toast('Workflow saved on this machine.');}catch(error){toast(error.message);}}
 function showJSON(){showModal('Your workflow, as a document',`<p class="modal-copy">Export a portable JSON workflow, or edit and apply it here.</p><textarea id="workflow-json" class="modal-code" spellcheck="false">${esc(JSON.stringify(S.workflow,null,2))}</textarea><div class="modal-actions"><button class="button" id="import-json">Import file</button><button class="button" id="export-json">Export JSON</button><button class="button primary" id="apply-json">Apply changes</button></div>`);$('#import-json').onclick=()=>$('#import-file').click();$('#export-json').onclick=()=>{const blob=new Blob([$('#workflow-json').value],{type:'application/json'}),url=URL.createObjectURL(blob),a=document.createElement('a');a.href=url;a.download=(S.workflow.id||'workflow')+'.json';a.click();setTimeout(()=>URL.revokeObjectURL(url),1000);};$('#apply-json').onclick=()=>{try{const value=JSON.parse($('#workflow-json').value);checkDocument(value);mark();S.workflow=value;S.inputText=JSON.stringify(value.inputs||{},null,2);S.selected=value.nodes[0]?.id;changed();closeModal();renderAll();fit();}catch(error){toast(error.message);}};}
 function checkDocument(w){if(!w||w.format!=='graphcore.studio.v1'||!Array.isArray(w.nodes)||!Array.isArray(w.edges)||w.nodes.length>100||w.edges.length>300)throw Error('Unsupported workflow document');const ids=new Set();for(const n of w.nodes){if(!n||!Object.prototype.hasOwnProperty.call(META,n.type)||typeof n.id!=='string'||!/^[A-Za-z_][A-Za-z0-9_]{0,63}$/.test(n.id)||ids.has(n.id)||!Number.isFinite(n.x)||!Number.isFinite(n.y)||!n.config||typeof n.config!=='object'||Array.isArray(n.config))throw Error('Invalid node definition');if(n.type==='schema'&&(!Array.isArray(n.config.fields)||n.config.fields.some(f=>!f||typeof f.name!=='string'||typeof f.type!=='string')))throw Error('Invalid schema fields');ids.add(n.id);}for(const e of w.edges)if(!e||!ids.has(e.source)||!ids.has(e.target))throw Error('Connection references a missing node');if(typeof w.name!=='string'||typeof w.id!=='string')throw Error('Workflow name and ID are required');}
 async function openSaved(){try{const items=await api('/api/workflows');showModal('Open a workflow',items.length?items.map((w,i)=>`<button class="saved-row" data-saved="${i}"><strong>${esc(w.name)}</strong><small>${w.nodes?.length||0} nodes →</small></button>`).join(''):'<p class="modal-copy">No saved workflows yet. Save your draft, or start from a template.</p>');document.querySelectorAll('[data-saved]').forEach(b=>b.onclick=()=>{const w=items[+b.dataset.saved];try{checkDocument(w);closeModal();confirmReplace(()=>load(w));}catch(error){toast(error.message);}});}catch(error){toast(error.message);}}
 async function updateHistoryCount(){try{$('#run-count').textContent=(await api('/api/runs')).length;}catch{}}
 async function history(){try{const runs=await api('/api/runs');showModal('Run history',runs.length?runs.map(r=>`<button class="saved-row" data-run="${esc(r.id)}"><span><strong>${esc(r.name)}</strong><br><small>${esc(new Date(r.created).toLocaleString())} · ${(r.duration_ms/1000).toFixed(2)}s</small></span><span class="run-badge ${esc(r.status)}">${esc(r.status)}</span></button>`).join(''):'<p class="modal-copy">Your runs will appear here, including approvals waiting for a response.</p>');document.querySelectorAll('[data-run]').forEach(b=>b.onclick=async()=>{try{const r=await api('/api/runs/'+b.dataset.run);closeModal();confirmReplace(()=>{load(r.workflow);S.run=r;S.tab='output';pollRun(r.id);});}catch(error){toast(error.message);}});}catch(error){toast(error.message);}}
-function help(){showModal('A visual workspace for local agents',`<div class="modal-copy"><p><strong>Build:</strong> drag nodes from the library or click to add one. Drag a node to arrange it.</p><p><strong>Connect:</strong> click an output dot, then an input dot. You can also choose targets in Node settings.</p><p><strong>Configure:</strong> select a node, set its prompts, tools, schema, or condition. Use <code>{{field}}</code> to reference state.</p><p><strong>Run:</strong> edit the Input JSON and run. Inspect Output, State, or the native execution trace.</p><p><strong>Models:</strong> choose OpenRouter on a Chat Model or Agent node, enter an OpenRouter model ID, and configure OPENROUTER_API_KEY under Model integrations. The offline fixture makes no AI request.</p><p><strong>Shortcuts:</strong> <kbd>Ctrl/Cmd Z</kbd> undo, <kbd>Delete</kbd> remove selected node, <kbd>Escape</kbd> cancel connection. Scroll to pan; Ctrl/Cmd + scroll to zoom.</p><p>Scheduling, checkpoints, and equality conditions run in C++. Model and tool integrations run in Python. Agent handoffs are sequential in this release.</p></div>`);}
-async function boot(){try{S.bootstrap=await api('/api/bootstrap');$('#engine-status').innerHTML=`<i></i> ${S.bootstrap.native?'C++ engine connected':'Engine needs a build'}`;if(!S.bootstrap.native)toast(S.bootstrap.native_error);let workflow=S.bootstrap.templates[0];try{const draft=JSON.parse(localStorage.getItem('graphcore.studio.draft'));if(draft){checkDocument(draft);workflow=draft;}}catch{}load(workflow);updateHistoryCount();}catch(error){$('#engine-status').textContent='Server unavailable';toast(error.message);}}
-$('#node-search').oninput=renderLibrary;document.querySelectorAll('[data-library]').forEach(b=>b.onclick=()=>{S.library=b.dataset.library;renderLibrary();});document.querySelectorAll('[data-console]').forEach(b=>b.onclick=()=>{S.tab=b.dataset.console;renderConsole();});$('#workflow-name').onchange=e=>{mark();S.workflow.name=e.target.value||'Untitled workflow';$('#breadcrumb').textContent=S.workflow.name;changed();};$('#settings-toggle').onclick=()=>document.querySelector('.inspector').classList.toggle('mobile-open');$('#close-inspector').onclick=()=>document.querySelector('.inspector').classList.remove('mobile-open');$('#save-button').onclick=save;$('#open-button').onclick=openSaved;$('#run-button').onclick=startRun;$('#history-button').onclick=history;$('#integrations-button').onclick=openIntegrations;$('#builder-button').onclick=()=>$('#canvas-area').focus();$('#help-button').onclick=help;$('#add-note-button').onclick=help;$('#json-button').onclick=showJSON;$('#modal-close').onclick=closeModal;$('#validate-button').onclick=async()=>{try{const data=await api('/api/validate',{workflow:S.workflow});showModal(data.errors.length?'A few connections need attention':'Your workflow is ready',data.errors.length?`<div class="error-box">${esc(data.errors.join('\n'))}</div>`:'<div class="success-box">All nodes and routes are valid.<br>Run the workflow to test its behavior with your input.</div>');}catch(error){toast(error.message);}};$('#stop-button').onclick=async()=>{try{await api(`/api/runs/${S.run.id}/cancel`,{});toast('Stop requested. Active callbacks must finish before execution stops.');pollRun(S.run.id);}catch(error){toast(error.message);}};$('#zoom-in').onclick=()=>zoom(1.15);$('#zoom-out').onclick=()=>zoom(1/1.15);$('#fit-button').onclick=fit;$('#undo-button').onclick=()=>{if(!S.undo.length)return;S.redo.push(clone(S.workflow));S.workflow=S.undo.pop();changed();renderAll();};$('#redo-button').onclick=()=>{if(!S.redo.length)return;S.undo.push(clone(S.workflow));S.workflow=S.redo.pop();changed();renderAll();};$('#import-file').onchange=async e=>{const file=e.target.files[0];if(!file)return;try{if(file.size>2*1024*1024)throw Error('Workflow file exceeds 2 MiB');const value=JSON.parse(await file.text());checkDocument(value);closeModal();confirmReplace(()=>{load(value);changed();});}catch(error){toast(error.message);}e.target.value='';};const canvas=$('#canvas-area');canvas.addEventListener('dragover',e=>{e.preventDefault();e.dataTransfer.dropEffect='copy';});canvas.addEventListener('drop',e=>{e.preventDefault();const kind=e.dataTransfer.getData('application/graphcore-node');if(META[kind]){const p=worldPoint(e);addNode(kind,p.x-113,p.y-54);}});canvas.addEventListener('pointerdown',e=>{if(e.button!==0||e.target.closest('.canvas-node,.canvas-controls'))return;drag={type:'pan',x:e.clientX,y:e.clientY,vx:S.view.x,vy:S.view.y};});canvas.addEventListener('wheel',e=>{e.preventDefault();if(e.ctrlKey||e.metaKey){const rect=canvas.getBoundingClientRect();zoom(Math.exp(-e.deltaY*.005),e.clientX-rect.left,e.clientY-rect.top);}else{S.view.x-=e.deltaX;S.view.y-=e.deltaY;applyView();}},{passive:false});document.addEventListener('keydown',e=>{if(e.key==='Escape'){S.connection=null;drawEdges();$('#canvas-hint').textContent='Drag to arrange · connect the dots to build a flow';}if(e.target.matches('input,textarea,select')||$('#modal').open)return;if((e.metaKey||e.ctrlKey)&&e.key.toLowerCase()==='z'){e.preventDefault();(e.shiftKey?$('#redo-button'):$('#undo-button')).click();}if(e.key==='Delete'||e.key==='Backspace'){e.preventDefault();deleteSelected();}if(e.key==='/'){e.preventDefault();$('#node-search').focus();}});window.addEventListener('resize',()=>drawEdges());boot();
+function help(){showModal('A visual workspace for local agents',`<div class="modal-copy"><p><strong>Build:</strong> drag nodes from the library or click to add one. Drag a node to arrange it.</p><p><strong>Connect:</strong> click an output dot, then an input dot. You can also choose targets in Node settings.</p><p><strong>Configure:</strong> select a node, set its prompts, tools, schema, or condition. Use <code>{{field}}</code> to reference state.</p><p><strong>Run:</strong> edit the Input JSON and run. Inspect Output, State, or the native execution trace.</p><p><strong>Models:</strong> add named model variables in Model integrations, then select $model1 in each Chat Model or Agent node. Configure OPENROUTER_API_KEY there too. The offline fixture makes no AI request.</p><p><strong>Shortcuts:</strong> <kbd>Ctrl/Cmd Z</kbd> undo, <kbd>Delete</kbd> remove selected node, <kbd>Escape</kbd> cancel connection. Scroll to pan; Ctrl/Cmd + scroll to zoom.</p><p>Scheduling, checkpoints, and equality conditions run in C++. Model and tool integrations run in Python. Agent handoffs are sequential in this release.</p></div>`);}
+async function boot(){try{S.bootstrap=await api('/api/bootstrap');S.models=(await api('/api/settings/models')).models;$('#engine-status').innerHTML=`<i></i> ${S.bootstrap.native?'C++ engine connected':'Engine needs a build'}`;if(!S.bootstrap.native)toast(S.bootstrap.native_error);let workflow=S.bootstrap.templates[0];try{const draft=JSON.parse(localStorage.getItem('graphcore.studio.draft'));if(draft){checkDocument(draft);workflow=draft;}}catch{}load(workflow);updateHistoryCount();}catch(error){$('#engine-status').textContent='Server unavailable';toast(error.message);}}
+$('#node-search').oninput=renderLibrary;document.querySelectorAll('[data-library]').forEach(b=>b.onclick=()=>{S.library=b.dataset.library;renderLibrary();});document.querySelectorAll('[data-console]').forEach(b=>b.onclick=()=>{S.tab=b.dataset.console;renderConsole();});$('#workflow-name').onchange=e=>{mark();S.workflow.name=e.target.value||'Untitled workflow';$('#breadcrumb').textContent=S.workflow.name;changed();};$('#settings-toggle').onclick=()=>document.querySelector('.inspector').classList.toggle('mobile-open');$('#close-inspector').onclick=()=>document.querySelector('.inspector').classList.remove('mobile-open');$('#save-button').onclick=save;$('#clear-button').onclick=()=>{showModal('Clear this workflow?',`<p class="modal-copy">Remove all nodes and connections from the current canvas? You can undo this action.</p><div class="modal-actions"><button class="button" id="cancel-clear">Keep workflow</button><button class="button danger" id="confirm-clear">Clear workflow</button></div>`);$('#cancel-clear').onclick=closeModal;$('#confirm-clear').onclick=()=>{mark();S.workflow.nodes=[];S.workflow.edges=[];S.selected=null;S.connection=null;S.nodeStatus={};S.run=null;if(S.poll){clearTimeout(S.poll);S.poll=null;}changed();renderAll();closeModal();fit();};};$('#open-button').onclick=openSaved;$('#run-button').onclick=startRun;$('#history-button').onclick=history;$('#integrations-button').onclick=openIntegrations;$('#builder-button').onclick=()=>$('#canvas-area').focus();$('#help-button').onclick=help;$('#add-note-button').onclick=help;$('#json-button').onclick=showJSON;$('#modal-close').onclick=closeModal;$('#validate-button').onclick=async()=>{try{const data=await api('/api/validate',{workflow:S.workflow});showModal(data.errors.length?'A few connections need attention':'Your workflow is ready',data.errors.length?`<div class="error-box">${esc(data.errors.join('\n'))}</div>`:'<div class="success-box">All nodes and routes are valid.<br>Run the workflow to test its behavior with your input.</div>');}catch(error){toast(error.message);}};$('#stop-button').onclick=async()=>{try{await api(`/api/runs/${S.run.id}/cancel`,{});toast('Stop requested. Active callbacks must finish before execution stops.');pollRun(S.run.id);}catch(error){toast(error.message);}};$('#zoom-in').onclick=()=>zoom(1.15);$('#zoom-out').onclick=()=>zoom(1/1.15);$('#fit-button').onclick=fit;$('#undo-button').onclick=()=>{if(!S.undo.length)return;S.redo.push(clone(S.workflow));S.workflow=S.undo.pop();changed();renderAll();};$('#redo-button').onclick=()=>{if(!S.redo.length)return;S.undo.push(clone(S.workflow));S.workflow=S.redo.pop();changed();renderAll();};$('#import-file').onchange=async e=>{const file=e.target.files[0];if(!file)return;try{if(file.size>2*1024*1024)throw Error('Workflow file exceeds 2 MiB');const value=JSON.parse(await file.text());checkDocument(value);closeModal();confirmReplace(()=>{load(value);changed();});}catch(error){toast(error.message);}e.target.value='';};const canvas=$('#canvas-area');canvas.addEventListener('dragover',e=>{e.preventDefault();e.dataTransfer.dropEffect='copy';});canvas.addEventListener('drop',e=>{e.preventDefault();const kind=e.dataTransfer.getData('application/graphcore-node');if(META[kind]){const p=worldPoint(e);addNode(kind,p.x-113,p.y-54);}});canvas.addEventListener('pointerdown',e=>{if(e.button!==0||e.target.closest('.canvas-node,.canvas-controls'))return;drag={type:'pan',x:e.clientX,y:e.clientY,vx:S.view.x,vy:S.view.y};});canvas.addEventListener('wheel',e=>{e.preventDefault();if(e.ctrlKey||e.metaKey){const rect=canvas.getBoundingClientRect();zoom(Math.exp(-e.deltaY*.005),e.clientX-rect.left,e.clientY-rect.top);}else{S.view.x-=e.deltaX;S.view.y-=e.deltaY;applyView();}},{passive:false});document.addEventListener('keydown',e=>{if(e.key==='Escape'){S.connection=null;drawEdges();$('#canvas-hint').textContent='Drag to arrange · connect the dots to build a flow';}if(e.target.matches('input,textarea,select')||$('#modal').open)return;if((e.metaKey||e.ctrlKey)&&e.key.toLowerCase()==='z'){e.preventDefault();(e.shiftKey?$('#redo-button'):$('#undo-button')).click();}if(e.key==='Delete'||e.key==='Backspace'){e.preventDefault();deleteSelected();}if(e.key==='/'){e.preventDefault();$('#node-search').focus();}});window.addEventListener('resize',()=>drawEdges());boot();

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/studio/web/index.html RENAMED Viewed

@@ -22,7 +22,7 @@
 <main class="main">
   <section class="workflow-header">
     <div><div class="workflow-title"><input id="workflow-name" aria-label="Workflow name" value="Research & review"><span class="version-tag">DRAFT</span></div><p id="workflow-description">Build a team of agents. Connect the way they think.</p></div>
-    <div class="actions"><button id="open-button" class="button quiet" title="Open a saved workflow">Open</button><button id="save-button" class="button">Save</button><button id="run-button" class="button primary"><span>▶</span> Run workflow</button></div>
+    <div class="actions"><button id="open-button" class="button quiet" title="Open a saved workflow">Open</button><button id="clear-button" class="button" title="Clear the canvas">Clear</button><button id="save-button" class="button">Save</button><button id="run-button" class="button primary"><span>▶</span> Run workflow</button></div>
   </section>
   <div class="canvas-toolbar"><div class="toolbar-tabs"><button class="active" id="canvas-tab">◇ Canvas</button><button id="json-button">{ } Workflow JSON</button></div><div class="toolbar-right"><span id="save-status">Local draft</span><span class="divider"></span><button id="undo-button" class="icon-button" aria-label="Undo" title="Undo (Ctrl/Cmd+Z)">↶</button><button id="redo-button" class="icon-button" aria-label="Redo">↷</button><button id="settings-toggle" class="button small">Settings</button><button id="validate-button" class="button small">✓ Validate</button></div></div>
   <div class="canvas-area" id="canvas-area" tabindex="0" aria-label="Workflow canvas">

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/studio/web/style.css RENAMED Viewed

@@ -7,3 +7,26 @@
 .field>span,.field input,.field select,.field textarea{color:#675773}.field small,.field-help{color:#8b7b98}.inspector-note{color:#897298}.node-head small,.node-foot{color:#8d7c9c}.palette-node small{color:#8b8495}.workflow-header p{color:#8b8295}.input-hint{color:#8a7b97}.console-tabs button{color:#897795}.canvas-hint{color:#9685a6}.toolbar-tabs button{color:#8e7e9d}
 .message-card{border:1px solid #ebe4f1;border-radius:7px;background:#fdfbff;padding:9px;margin:9px 0}.message-card header,.message-tools{display:flex;align-items:center;gap:8px}.message-card header{justify-content:space-between;margin-bottom:8px}.message-card header select,.message-tools select{border:1px solid #e5dbea;border-radius:4px;background:white;color:#675773;font-size:10px;padding:5px 7px}.message-remove{border:0;background:transparent;color:#a78bac;font-size:17px}.message-remove:disabled{opacity:.35;cursor:not-allowed}.message-content{display:block;width:100%;min-height:68px;resize:vertical;border:1px solid #e7dfee;border-radius:5px;padding:8px;font:10px/1.6 var(--mono);color:#675773;background:white}.message-tools{margin-top:7px;justify-content:space-between}.message-tools select{max-width:100%;min-width:0;flex:1}.message-tools small{font-size:8px;color:#91849a;white-space:nowrap}
 .environment-row{display:flex;align-items:center;gap:12px;padding:10px 0;border-bottom:1px solid #f0ebf4}.environment-row>label:first-child{flex:1;min-width:0;display:grid;grid-template-columns:minmax(120px,1fr) minmax(160px,1.2fr);align-items:center;gap:10px}.environment-row strong{display:block;font:10px var(--mono);color:#675773;overflow-wrap:anywhere}.environment-row small{display:block;margin-top:4px;font-size:9px;color:#8b7b98}.environment-row input[type=password],.environment-row input[data-env-name]{min-width:0;width:100%;border:1px solid #e7dfee;border-radius:5px;padding:8px;font-size:10px;color:#675773}.environment-row.custom>label:first-child{grid-template-columns:minmax(120px,.8fr) minmax(160px,1.2fr)}.env-remove{display:flex;align-items:center;gap:4px;color:#917f9b;font-size:9px;white-space:nowrap}.env-security{padding:9px 11px;background:#f8f5fb;border-radius:6px;color:#867791;font-size:10px}.env-security code{font:9px var(--mono)}@media(max-width:600px){.environment-row>label:first-child,.environment-row.custom>label:first-child{grid-template-columns:1fr;gap:6px}.env-remove{font-size:8px}}
+/* Named model registry and clearer interactive controls. */
+.model-row{display:grid;grid-template-columns:minmax(90px,1fr) auto minmax(160px,2fr) 28px;align-items:center;gap:9px;margin:10px 0;padding:10px;background:#fbf9fe;border:1px solid #e8e0f1;border-radius:9px}
+.model-row input{min-width:0;width:100%;padding:9px 10px;border:1px solid #ded5ea;border-radius:6px;background:#fff;color:#514263;font:11px var(--mono)}
+.model-row input:focus{outline:2px solid #d4c5ec;border-color:#9b83c7}
+.model-row span{color:#9985b4;font-size:13px}
+.model-row button{height:28px;border:0;border-radius:5px;background:transparent;color:#a77f98;font-size:19px;cursor:pointer}
+.model-row button:hover{background:#f8eaf0;color:#ad526e}
+.button:focus-visible,.icon-button:focus-visible,.palette-node:focus-visible,.workspace-item:focus-visible{outline:2px solid #9b83c7;outline-offset:2px}
+#clear-button{color:#886b83}
+@media(max-width:650px){.model-row{grid-template-columns:minmax(70px,1fr) auto minmax(100px,1.4fr) 24px;gap:5px;padding:7px}.model-row input{font-size:9px;padding:7px 5px}}
+/* Readable hierarchy on the builder, inspector, and model settings. */
+.workspace-item,.palette-node strong,.button,.toolbar-tabs button,.console-tabs button{font-size:12px}
+.palette-node small,.node-head small,.field small,.field-help,.inspector-note,.canvas-banner,.console-meta,.input-hint{font-size:10px;color:#746c82}
+.node-head strong,.inspector-hero strong{font-size:13px;color:#393246}
+.field>span,.inspector-heading strong{font-size:11px;color:#5c506d}
+.field input,.field select,.field textarea{font-size:11px;color:#43374f;border-color:#d9d0e4}
+.workflow-header{border-bottom:1px solid #f0ecf5}
+.canvas-node{box-shadow:0 3px 12px #3524420d,0 12px 30px #35244208}
+.canvas-node:hover{border-color:#c9b8e3;box-shadow:0 5px 15px #35244213,0 15px 32px #3524420b}
+.button{transition:background-color .14s,border-color .14s,box-shadow .14s}
+.button.primary{box-shadow:0 3px 10px #6552b733}

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/tests/test_studio.py RENAMED Viewed

@@ -11,11 +11,35 @@ from unittest.mock import patch
 ROOT = Path(__file__).resolve().parents[1]
 sys.path.insert(0, str(ROOT))
 sys.path.insert(0, str(ROOT / 'python'))
-from studio.engine import validate, compile_workflow, structured, render, WorkflowError, pydantic_available, register_tool, TOOLS, chat_messages, invoke_model
+from studio.engine import validate, compile_workflow, structured, render, WorkflowError, pydantic_available, register_tool, TOOLS, chat_messages, invoke_model, resolve_model
 from studio.server import Store
 from graphcore import Graph, END, GraphCoreError
 class StudioTests(unittest.TestCase):
+    def test_named_models_resolve_and_validate(self):
+        models = {'model1': 'deepseek/deepseek-v4-pro-0813', 'model2': 'openai/gpt-4o-mini'}
+        self.assertEqual(resolve_model({'model': '$model1'}, models), models['model1'])
+        self.assertEqual(resolve_model({'model': '$model2'}, models), models['model2'])
+        self.assertEqual(resolve_model({'model': 'google/gemini-2.5-flash'}, models), 'google/gemini-2.5-flash')
+        with self.assertRaisesRegex(WorkflowError, 'Unknown model variable'):
+            resolve_model({'model': '$missing'}, models)
+    def test_store_persists_named_models(self):
+        with tempfile.TemporaryDirectory() as path:
+            store = Store(path)
+            try:
+                self.assertEqual(store.update_models({'model1': 'deepseek/deepseek-v4-pro-0813'}),
+                                 {'model1': 'deepseek/deepseek-v4-pro-0813'})
+                with self.assertRaisesRegex(ValueError, 'simple identifiers'):
+                    store.update_models({'bad-name': 'openai/gpt-4o-mini'})
+            finally:
+                store.close()
+            reopened = Store(path)
+            try:
+                self.assertEqual(reopened.models['model1'], 'deepseek/deepseek-v4-pro-0813')
+            finally:
+                reopened.close()
     def flow(self, name='01-research.json'):
         return json.loads((ROOT / 'studio/templates' / name).read_text())
@@ -122,6 +146,10 @@ class StudioTests(unittest.TestCase):
             invoke_model({'provider':'openrouter','model':'deepseek/example','reasoning_effort':'low',
                 'messages':[{'role':'user','content':'hello'}]}, {})
         self.assertEqual(seen['request']['reasoning_effort'],'low')
+        with patch.dict('sys.modules', {'openrouter':sdk}), patch.dict(os.environ, {'OPENROUTER_API_KEY':'test-secret'}):
+            invoke_model({'provider':'openrouter','model':'$model2',
+                'messages':[{'role':'user','content':'hello'}]}, {}, {'model2':'google/gemini-2.5-flash'})
+        self.assertEqual(seen['request']['model'],'google/gemini-2.5-flash')
     def test_model_retries_empty_reasoning_response_and_reads_typed_text_blocks(self):
         seen=[]

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/tests/test_studio_http.py RENAMED Viewed

@@ -77,6 +77,18 @@ class HttpTests(unittest.TestCase):
         self.assertEqual(caught.exception.code,400)
         self.assertIn('error',json.loads(caught.exception.read()))
+    def test_named_model_settings_and_json_reference(self):
+        models={'model1':'deepseek/deepseek-v4-pro-0813','model2':'openai/gpt-4o-mini'}
+        self.assertEqual(self.post('/api/settings/models',{'models':models})['models'],models)
+        with self.request('/api/settings/models') as response:
+            self.assertEqual(json.loads(response.read())['models'],models)
+        workflow=json.loads((ROOT/'studio/templates/05-model.json').read_text())
+        workflow['nodes'][1]['config'].update(provider='openrouter',model='$model1')
+        self.assertEqual(self.post('/api/validate',{'workflow':workflow})['errors'],[])
+        workflow['nodes'][1]['config']['model']='$unknown'
+        self.assertTrue(any('Unknown model variable' in error for error in
+                            self.post('/api/validate',{'workflow':workflow})['errors']))
     def test_model_environment_settings_are_write_only_and_loaded(self):
         name='GRAPHCORE_TEST_SECRET'
         previous=os.environ.pop(name,None)

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/.gitignore RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/LICENSE RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/cmake/GraphCoreConfig.cmake.in RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/docs/PYPI_RELEASE.md RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/docs/ROADMAP.md RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/docs/VALIDATION.md RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/examples/approval.cpp RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/examples/complex_deepseek_workflow.json RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/examples/langgraph_deepseek_workflow_notebook.py RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/examples/python_agent.py RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/include/graphcore/c_api.h RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/include/graphcore/graphcore.hpp RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/requirements-pydantic.txt RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/run_studio.py RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/scripts/build.sh RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/src/c_api.cpp RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/src/graphcore.cpp RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/studio/__init__.py RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/studio/cli.py RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/studio/example_plugin.py RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/studio/templates/01-research.json RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/studio/templates/02-structured.json RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/studio/templates/03-tools.json RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/studio/templates/04-team.json RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/studio/templates/05-model.json RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/tests/core_tests.cpp RENAMED Viewed

File without changes

{graphcore_studio-0.2.0 → graphcore_studio-0.2.2}/tests/test_python.py RENAMED Viewed

File without changes

graphcore-studio 0.2.0__tar.gz → 0.2.2__tar.gz

graphcore-studio 0.2.0tar.gz → 0.2.2tar.gz