pi-revit 0.2.16 → 0.2.18

package/CHANGELOG.md

@@ -7,6 +7,35 @@ Format follows [Keep a Changelog](https://keepachangelog.com/); version headers
 Every published version gets an entry with **Added** / **Changed** / **Fixed** sections
 describing what the user will notice — not internal refactors.
 
+## [0.2.18] - 2026-08-21
+
+### Fixed
+- When pi starts before Revit and the background rediscovery timer (rather than a `ping`
+  call) registers the bridge tools, the session is now told — the same announcement the
+  ping path has always given. Previously the tools appeared silently in the next system
+  prompt while nothing contradicted the session's earlier "Revit is not running", so the
+  agent could stay needlessly pessimistic. The note is queued for the next user prompt
+  and never interrupts. Extension-only change; the Revit add-in is unchanged (the
+  standard installer keeps both versions aligned).
+
+## [0.2.17] - 2026-08-21
+
+### Fixed
+- The bridge's no-document check no longer counts linked documents. With only links
+  loaded, Revit does not pump the bridge's work queue, so a call could wait out its full
+  timeout instead of failing immediately with the clean "no active document" answer.
+
+### Changed
+- Docs and tool descriptions describe localized parameter names generically instead of
+  quoting specific languages.
+- The full search_api_docs benchmark (641 live queries against RevitAPI.xml ground truth)
+  was re-run on Revit 2025 at 0.2.16: 100% recall, 98.75% top-1 on exact names, 100%
+  spacing-variant agreement, 0 false positives across 99 adversarial mutations, 50/50
+  parameter docs, p50 10 ms -- no regression across the 0.2.13-0.2.16 search changes.
+
+Requires redeploying the Revit add-in (`scripts\deploy.ps1` with Revit closed, then
+restart Revit).
+
 ## [0.2.16] - 2026-08-21
 
 ### Fixed

package/extensions/pi-revit/index.ts

@@ -372,7 +372,28 @@ export default async function revitConnector(pi: ExtensionAPI) {
 	// Never block pi startup on Revit: keep retrying quietly in the background
 	// and stop the moment discovery succeeds.
 	const timer = setInterval(async () => {
-		if (await discoverAndRegister()) clearInterval(timer);
+		if (!(await discoverAndRegister())) return;
+		clearInterval(timer);
+		// The ping path announces newly registered tools in its result text; this path
+		// must speak too. Without it the tools appear silently in the next system
+		// prompt while nothing in the conversation contradicts an earlier "Revit is
+		// not running" — the session's belief goes stale. Custom messages participate
+		// in LLM context; deliverAs "nextTurn" queues it for the next user prompt
+		// without interrupting or triggering anything.
+		try {
+			pi.sendMessage(
+				{
+					customType: "pi-revit",
+					content:
+						"Revit is now reachable: the Revit bridge tools (get_elements, set_parameters, execute_csharp, ...) were just registered in this session and are available from now on.",
+					display: true,
+				},
+				{ deliverAs: "nextTurn" },
+			);
+		} catch {
+			// An older pi without sendMessage, or a torn-down session: the
+			// registration itself succeeded and must never be undone by the announcer.
+		}
 	}, REDISCOVERY_INTERVAL_MS);
 	timer.unref?.();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-revit",
-  "version": "0.2.16",
+  "version": "0.2.18",
   "description": "Native Pi connector for Autodesk Revit. Run npx.cmd -y pi-revit for the full Windows install.",
   "author": "Ahmad Altahlawi",
   "license": "MIT",
@@ -26,7 +26,8 @@
   "scripts": {
     "deploy": "powershell -ExecutionPolicy Bypass -File scripts/deploy.ps1",
     "setup": "powershell -ExecutionPolicy Bypass -File scripts/setup-workspace.ps1",
-    "uninstall:revit": "powershell -ExecutionPolicy Bypass -File scripts/uninstall.ps1"
+    "uninstall:revit": "powershell -ExecutionPolicy Bypass -File scripts/uninstall.ps1",
+    "test:search": "dotnet run --project tests/search-engine"
   },
   "files": [
     "bin/",

package/skills/pi-revit/SKILL.md

@@ -31,7 +31,7 @@ Workflow guidance:
 - `get_elements` is the listing/counting primitive (`count_only: true` for bare counts). It returns identity fields only (id, name, category, typeName, levelId); read parameter values with `get_element_details`. Prefer a `category` or `of_class` scope when filtering by a parameter's display name.
 - The selection pipeline is `get_elements` -> ids -> `manage_selection` (action `set`); there is no inline filter on selection.
 - `set_parameters` is the home for bulk parameter writes AND renames (the `Name` parameter covers levels, views, sheets, types). One transaction per batch; per-element failures are reported. Pass `expected_document` (the model title) when several models are open or the session is long — it makes the write fail cleanly instead of landing in a different active document.
-- Parameter display names are LOCALIZED: in a non-English Revit UI, `Mark` is `Kennzeichen` (German), `マーク` (Japanese), etc. When a display-name lookup or `parameter_names` filter finds nothing, or the document may be non-English, use the language-independent `BuiltInParameter` enum name instead (e.g. `ALL_MODEL_MARK` for Mark, `ALL_MODEL_INSTANCE_COMMENTS` for Comments) — `set_parameters`, `get_element_details.parameter_names`, and `get_elements` filter rules all accept them, and `get_element_details` reports each parameter's `builtInParameter` name for discovery.
+- Parameter display names are LOCALIZED: in a non-English Revit UI, `Mark`, `Comments`, and every other display name appear under their translated names. When a display-name lookup or `parameter_names` filter finds nothing, or the document may be non-English, use the language-independent `BuiltInParameter` enum name instead (e.g. `ALL_MODEL_MARK` for Mark, `ALL_MODEL_INSTANCE_COMMENTS` for Comments) — `set_parameters`, `get_element_details.parameter_names`, and `get_elements` filter rules all accept them, and `get_element_details` reports each parameter's `builtInParameter` name for discovery.
 - Before writing `execute_csharp` code, verify unfamiliar classes/members with `search_api_docs` (works with no document open; first query builds the index and takes a few seconds). The top match carries its remarks, parameter docs, and returns inline, and every public API enum value is searchable — trust the result over guessing or web search; narrow the query to promote a different match into the top slot.
 - `export_documents` files its output under `Documents\pi-revit\Models\<model title>\exports` automatically when `output_dir` is omitted — keyed to the exported document, so it lands right even across many models. Pass `output_dir` only when the user names a different target.
 

package/src/Revit/Application.cs

@@ -1,3 +1,4 @@
+using Autodesk.Revit.DB;
 using Autodesk.Revit.UI;
 using RevitApplication = Autodesk.Revit.ApplicationServices.Application;
 
@@ -67,7 +68,32 @@ namespace RevitBridge
         {
             if (sender is RevitApplication app)
                 _application = app;
-            _hasOpenDocument = (_application?.Documents?.Size ?? 0) > 0;
+            try
+            {
+                // Linked documents count in Documents but are never the active UI
+                // document -- with only links loaded, ExternalEvents still are not
+                // pumped, so counting them would let a queued call hang for its full
+                // timeout instead of failing fast with the 409.
+                bool any = false;
+                var documents = _application?.Documents;
+                if (documents != null)
+                {
+                    foreach (Document document in documents)
+                    {
+                        if (!document.IsLinked)
+                        {
+                            any = true;
+                            break;
+                        }
+                    }
+                }
+                _hasOpenDocument = any;
+            }
+            catch
+            {
+                // Transitional states (mid-close) can make the iteration throw; keep
+                // the last known value -- the in-queue backstop still catches a miss.
+            }
         }
 
         private static string StartupErrorPath() =>

package/src/Revit/Tools/GetElementDetails.cs

@@ -27,7 +27,7 @@ namespace RevitBridge.Tools
                 {
                     type = "array",
                     items = new { type = "string" },
-                    description = "Only return these parameters. Matches the display name OR the BuiltInParameter enum name (case-insensitive exact). Display names are localized (e.g. 'Mark' is 'Kennzeichen' in a German UI) — prefer enum names like ALL_MODEL_MARK for language-independent filtering. Default: all.",
+                    description = "Only return these parameters. Matches the display name OR the BuiltInParameter enum name (case-insensitive exact). Display names are localized in non-English Revit UIs — prefer enum names like ALL_MODEL_MARK for language-independent filtering. Default: all.",
                 },
                 include = new
                 {