revit-bridge 0.1.0__tar.gz

revit_bridge-0.1.0/.gitignore

@@ -0,0 +1,17 @@
+# Secrets never enter this repository
+.env*
+!.env.example
+.secrets/
+*.token
+
+# Local Claude Code state
+.claude/settings.local.json
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/

revit_bridge-0.1.0/CHANGELOG.md

@@ -0,0 +1,48 @@
+# Changelog
+
+All notable changes to `revit-bridge` are recorded here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions follow
+[Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-09-18
+
+First release of the standalone package, extracted from the former
+`revit-api-rag` monorepo.
+
+### Added
+
+- MCP server `revit-bridge` (stdio) with tools `execute_code`, `solidify_tool`,
+  `list_tools`, `get_tool_choices`, `run_tool` and resources `revit://stats`,
+  `revit://tools/{name}`, `revit://connection-status`.
+- `spec_confirmed` execution gate on `execute_code` and `run_tool`;
+  `REVIT_BRIDGE_ALLOW_UNCONFIRMED=1` lifts it for host-internal flows.
+- `revit-bridge check` subcommand that pings the Revit add-in and exits 0/1.
+- Connection settings from environment variables: `REVIT_BRIDGE_HOST`,
+  `REVIT_BRIDGE_PORT`, `REVIT_BRIDGE_TOKEN`, `REVIT_BRIDGE_TIMEOUT`;
+  the token is sent with every JSON-RPC request.
+- Eleven built-in capability packs shipped inside the wheel (a reference pack
+  lives in `capabilities/examples/`, which the store never reads);
+  `REVIT_BRIDGE_CAPABILITIES_DIR` overrides the directory.
+- Slot token helpers (`revit_bridge.auth.tokens`) for the web relay.
+- `RevitQueryExecutor.get_tool_choices(dynamic_params)` resolves a pack's
+  `choices_from` sources (`levels`, `family_types:<OST_*>`, `floor_types`,
+  `elements:<OST_*>`) and `RevitQueryExecutor.get_project_units()` reads the
+  project's length unit. The MCP `get_tool_choices` tool and the web host both
+  call these instead of carrying their own Revit snippets.
+- `escape_param_value` in `revit_bridge.capabilities`: `ToolStore.render_code`
+  escapes quotes, backslashes and newlines in string parameters so a value
+  cannot terminate the C# string literal it is rendered into.
+- Claude Code plugin in `plugin/` (skill `revit-bridge` with pattern, workflow and
+  standards references, `.mcp.json`, PreToolUse spec gate hook) and the
+  marketplace manifest `.claude-plugin/marketplace.json`.
+- Test suite with a fake Revit TCP server; CI and PyPI trusted publishing workflows.
+
+### Removed (compared with the monorepo server)
+
+- RAG tools `search_revit_api`, `get_code_examples`, `generate_code` and every
+  model / vector-store dependency. Hosts bring their own model.
+
+[Unreleased]: https://github.com/revitbridge/revit-bridge/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/revitbridge/revit-bridge/releases/tag/v0.1.0

revit_bridge-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 revitbridge
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

revit_bridge-0.1.0/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.5
+Name: revit-bridge
+Version: 0.1.0
+Summary: Intent bridge between designers and AI for Revit: MCP server + Claude Code plugin
+Project-URL: Homepage, https://github.com/revitbridge/revit-bridge
+Project-URL: Issues, https://github.com/revitbridge/revit-bridge/issues
+Project-URL: Changelog, https://github.com/revitbridge/revit-bridge/blob/main/CHANGELOG.md
+Author: revitbridge
+License-Expression: MIT
+License-File: LICENSE
+Keywords: bim,claude-code,mcp,revit
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.11
+Requires-Dist: mcp<3,>=2
+Requires-Dist: pydantic>=2
+Requires-Dist: pyyaml>=6
+Requires-Dist: websockets>=12
+Description-Content-Type: text/markdown
+
+# revit-bridge
+
+Intent bridge between designers and AI for Autodesk Revit: an MCP server that
+executes code in a running Revit, keeps a library of reusable capability
+packs, and refuses to run anything the designer has not confirmed.
+
+The package contains no model SDK, no vector store and no web framework. Your
+MCP host (Claude Desktop, Claude Code, any MCP client) brings the model; the
+[revit-bridge-addin](https://github.com/revitbridge/revit-bridge-addin) inside
+Revit executes the code.
+
+## Install
+
+Prerequisites: Python 3.11+ with [`uv`](https://docs.astral.sh/uv/) (for `uvx`),
+Revit 2026 with the add-in installed and its local TCP listener on (default
+`127.0.0.1:18080`).
+
+**Claude Desktop** — `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "revit-bridge": {
+      "command": "uvx",
+      "args": ["revit-bridge"]
+    }
+  }
+}
+```
+
+**Claude Code** - the plugin (skill + MCP server + confirmation hook, recommended):
+
+```
+/plugin marketplace add revitbridge/revit-bridge
+/plugin install revit-bridge@revit-bridge
+```
+
+The plugin's `.mcp.json` starts the server with `uvx`; its `hooks/hooks.json`
+denies `execute_code` / `run_tool` calls that lack `spec_confirmed=true`
+(`uv run` executes `plugin/hooks/spec_gate.py`, so `uv` must be on PATH). The
+skill is also installable on its own with
+`npx skills add revitbridge/revit-bridge`.
+
+MCP server only, without the skill and hook:
+
+```bash
+claude mcp add revit-bridge -- uvx revit-bridge
+```
+
+**Any MCP client** — run `uvx revit-bridge` as a stdio server. Pass connection
+settings through environment variables (see Configure), for example in the
+`env` block of the host's server entry.
+
+From a checkout: `uv sync` then `uv run revit-bridge`.
+
+## Use
+
+1. Start Revit, open a project and make sure the add-in is listening.
+2. Check the connection:
+
+   ```bash
+   uvx revit-bridge check
+   ```
+
+   Prints host, port, whether a token is set and `"status": "connected"`; the
+   exit code is 0 when Revit answered, 1 otherwise.
+
+3. In your host, work in three steps:
+
+   - `list_tools` — see the capability packs (`create_wall`, `query_levels`, …).
+   - `get_tool_choices` with a tool name — Revit returns the real levels,
+     family types or elements for that tool's dynamic parameters.
+   - `run_tool` with the chosen values and `spec_confirmed=true`.
+
+   `execute_code` takes arbitrary C# for tasks no pack covers. The code runs
+   inside Revit with `document` in scope and a transaction already open; end it
+   with `return <object>;`. `solidify_tool` saves code that worked as a new pack.
+
+**Confirmation gate.** `execute_code` and `run_tool` default to
+`spec_confirmed=false` and return `refused_unconfirmed_spec` until the host has
+shown the designer every parameter with its source and received confirmation.
+Hosts that run their own confirmation flow can set
+`REVIT_BRIDGE_ALLOW_UNCONFIRMED=1`.
+
+Resources: `revit://stats`, `revit://tools/{name}`, `revit://connection-status`.
+
+## Configure
+
+| Variable | Default | Meaning |
+|---|---|---|
+| `REVIT_BRIDGE_HOST` | `127.0.0.1` | Host where the add-in listens |
+| `REVIT_BRIDGE_PORT` | `18080` | TCP port of the add-in |
+| `REVIT_BRIDGE_TOKEN` | *(unset)* | Pre-shared token, sent with every request when the add-in has one configured |
+| `REVIT_BRIDGE_TIMEOUT` | `60` | Seconds to wait for a command to finish |
+| `REVIT_BRIDGE_ALLOW_UNCONFIRMED` | *(unset)* | `1` lifts the `spec_confirmed` gate (host-internal flows only) |
+| `REVIT_BRIDGE_CAPABILITIES_DIR` | packaged packs | Directory of capability YAML files; new `solidify_tool` packs are written here |
+
+Development:
+
+```bash
+uv sync
+uv run pytest
+uv build
+uvx --from . revit-bridge check
+```
+
+License: MIT. Issues and discussion: <https://github.com/revitbridge/revit-bridge/issues>.

revit_bridge-0.1.0/README.md

@@ -0,0 +1,107 @@
+# revit-bridge
+
+Intent bridge between designers and AI for Autodesk Revit: an MCP server that
+executes code in a running Revit, keeps a library of reusable capability
+packs, and refuses to run anything the designer has not confirmed.
+
+The package contains no model SDK, no vector store and no web framework. Your
+MCP host (Claude Desktop, Claude Code, any MCP client) brings the model; the
+[revit-bridge-addin](https://github.com/revitbridge/revit-bridge-addin) inside
+Revit executes the code.
+
+## Install
+
+Prerequisites: Python 3.11+ with [`uv`](https://docs.astral.sh/uv/) (for `uvx`),
+Revit 2026 with the add-in installed and its local TCP listener on (default
+`127.0.0.1:18080`).
+
+**Claude Desktop** — `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "revit-bridge": {
+      "command": "uvx",
+      "args": ["revit-bridge"]
+    }
+  }
+}
+```
+
+**Claude Code** - the plugin (skill + MCP server + confirmation hook, recommended):
+
+```
+/plugin marketplace add revitbridge/revit-bridge
+/plugin install revit-bridge@revit-bridge
+```
+
+The plugin's `.mcp.json` starts the server with `uvx`; its `hooks/hooks.json`
+denies `execute_code` / `run_tool` calls that lack `spec_confirmed=true`
+(`uv run` executes `plugin/hooks/spec_gate.py`, so `uv` must be on PATH). The
+skill is also installable on its own with
+`npx skills add revitbridge/revit-bridge`.
+
+MCP server only, without the skill and hook:
+
+```bash
+claude mcp add revit-bridge -- uvx revit-bridge
+```
+
+**Any MCP client** — run `uvx revit-bridge` as a stdio server. Pass connection
+settings through environment variables (see Configure), for example in the
+`env` block of the host's server entry.
+
+From a checkout: `uv sync` then `uv run revit-bridge`.
+
+## Use
+
+1. Start Revit, open a project and make sure the add-in is listening.
+2. Check the connection:
+
+   ```bash
+   uvx revit-bridge check
+   ```
+
+   Prints host, port, whether a token is set and `"status": "connected"`; the
+   exit code is 0 when Revit answered, 1 otherwise.
+
+3. In your host, work in three steps:
+
+   - `list_tools` — see the capability packs (`create_wall`, `query_levels`, …).
+   - `get_tool_choices` with a tool name — Revit returns the real levels,
+     family types or elements for that tool's dynamic parameters.
+   - `run_tool` with the chosen values and `spec_confirmed=true`.
+
+   `execute_code` takes arbitrary C# for tasks no pack covers. The code runs
+   inside Revit with `document` in scope and a transaction already open; end it
+   with `return <object>;`. `solidify_tool` saves code that worked as a new pack.
+
+**Confirmation gate.** `execute_code` and `run_tool` default to
+`spec_confirmed=false` and return `refused_unconfirmed_spec` until the host has
+shown the designer every parameter with its source and received confirmation.
+Hosts that run their own confirmation flow can set
+`REVIT_BRIDGE_ALLOW_UNCONFIRMED=1`.
+
+Resources: `revit://stats`, `revit://tools/{name}`, `revit://connection-status`.
+
+## Configure
+
+| Variable | Default | Meaning |
+|---|---|---|
+| `REVIT_BRIDGE_HOST` | `127.0.0.1` | Host where the add-in listens |
+| `REVIT_BRIDGE_PORT` | `18080` | TCP port of the add-in |
+| `REVIT_BRIDGE_TOKEN` | *(unset)* | Pre-shared token, sent with every request when the add-in has one configured |
+| `REVIT_BRIDGE_TIMEOUT` | `60` | Seconds to wait for a command to finish |
+| `REVIT_BRIDGE_ALLOW_UNCONFIRMED` | *(unset)* | `1` lifts the `spec_confirmed` gate (host-internal flows only) |
+| `REVIT_BRIDGE_CAPABILITIES_DIR` | packaged packs | Directory of capability YAML files; new `solidify_tool` packs are written here |
+
+Development:
+
+```bash
+uv sync
+uv run pytest
+uv build
+uvx --from . revit-bridge check
+```
+
+License: MIT. Issues and discussion: <https://github.com/revitbridge/revit-bridge/issues>.

revit_bridge-0.1.0/capabilities/create_beam.yaml

@@ -0,0 +1,72 @@
+name: create_beam
+display_name: Create Beam
+description: Create a structural beam between two points using first available beam
+  family type.
+code_template: |
+  // Step 1: Get beam family symbol by name
+  var symbol = new FilteredElementCollector(document)
+      .OfClass(typeof(FamilySymbol))
+      .OfCategory(BuiltInCategory.OST_StructuralFraming)
+      .Cast<FamilySymbol>()
+      .FirstOrDefault(s => s.Name == "{type_name}");
+  if (symbol == null)
+      return new { Status = "Error", Message = "Beam type '{type_name}' not found" };
+  if (!symbol.IsActive) symbol.Activate();
+
+  // Step 2: Get level by name
+  var level = new FilteredElementCollector(document)
+      .OfClass(typeof(Level))
+      .Cast<Level>()
+      .FirstOrDefault(l => l.Name == "{level_name}");
+  if (level == null)
+      return new { Status = "Error", Message = "Level '{level_name}' not found" };
+
+  // Step 3: Create beam line (mm -> feet)
+  XYZ start = new XYZ({start_x} / 304.8, {start_y} / 304.8, {elevation} / 304.8);
+  XYZ end = new XYZ({end_x} / 304.8, {end_y} / 304.8, {elevation} / 304.8);
+  Line beamLine = Line.CreateBound(start, end);
+
+  // Step 4: Create beam instance
+  var beam = document.Create.NewFamilyInstance(
+      beamLine, symbol, level,
+      Autodesk.Revit.DB.Structure.StructuralType.Beam);
+
+  return new { ElementId = beam.Id.Value, Status = "Created",
+               FamilyType = symbol.Name, Level = level.Name };
+parameters:
+  - name: type_name
+    type: string
+    description: Beam family type name
+    choices_from: family_types:OST_StructuralFraming
+  - name: level_name
+    type: string
+    description: Target level name
+    choices_from: levels
+  - name: start_x
+    type: double
+    description: Beam start X (mm)
+    default: '0'
+  - name: start_y
+    type: double
+    description: Beam start Y (mm)
+    default: '0'
+  - name: end_x
+    type: double
+    description: Beam end X (mm)
+    default: '5000'
+  - name: end_y
+    type: double
+    description: Beam end Y (mm)
+    default: '0'
+  - name: elevation
+    type: double
+    description: Beam elevation (mm)
+    default: '3000'
+tags:
+  - beam
+  - structural
+  - create
+created_at: '2026-03-13T00:00:00'
+source_query: create a structural beam
+execution_count: 0
+last_used: ''

revit_bridge-0.1.0/capabilities/create_column.yaml

@@ -0,0 +1,33 @@
+name: create_column
+display_name: Create Column
+description: create column
+code_template: "// Step 1: Parse the position — convert mm to feet (Revit internal\
+  \ units)\ndouble xFeet = 100.0 / 304.8;  // 100mm -> feet\ndouble yFeet = 0.0 /\
+  \ 304.8;    // 0mm -> feet\ndouble zFeet = 0.0;\n\n// Step 2: Find the Level \"\
+  L1\" — filter by exact name from user selection\nLevel level = new FilteredElementCollector(document)\n\
+  \    .OfClass(typeof(Level))\n    .Cast<Level>()\n    .FirstOrDefault(l => l.Name\
+  \ == \"L1\");\n\nif (level == null)\n    return new { Status = \"Error\", Message\
+  \ = \"Level 'L1' not found.\" };\n\n// Step 3: Find the FamilySymbol \"600 x 750mm\"\
+  \ in family \"M_Concrete-Rectangular-Column\"\nFamilySymbol columnSymbol = new FilteredElementCollector(document)\n\
+  \    .OfClass(typeof(FamilySymbol))\n    .Cast<FamilySymbol>()\n    .FirstOrDefault(s\
+  \ => s.Family.Name == \"M_Concrete-Rectangular-Column\" && s.Name == \"600 x 750mm\"\
+  );\n\nif (columnSymbol == null)\n    return new { Status = \"Error\", Message =\
+  \ \"FamilySymbol '600 x 750mm' not found in family 'M_Concrete-Rectangular-Column'.\"\
+  \ };\n\n// Step 4: Activate the FamilySymbol if not already active — required before\
+  \ placing instances\nif (!columnSymbol.IsActive)\n{\n    columnSymbol.Activate();\n\
+  \    document.Regenerate();\n}\n\n// Step 5: Define the insertion point in Revit\
+  \ internal units (feet)\nXYZ insertionPoint = new XYZ(xFeet, yFeet, zFeet);\n\n\
+  // Step 6: Place the structural column using NewFamilyInstance with StructuralType.Column\n\
+  FamilyInstance columnInstance = document.Create.NewFamilyInstance(\n    insertionPoint,\n\
+  \    columnSymbol,\n    level,\n    Autodesk.Revit.DB.Structure.StructuralType.Column);\n\
+  \nif (columnInstance == null)\n    return new { Status = \"Error\", Message = \"\
+  Failed to create structural column instance.\" };\n\n// Step 7: Return result with\
+  \ element info\nreturn new\n{\n    Status = \"Success\",\n    ElementId = columnInstance.Id.Value,\n\
+  \    FamilyName = columnSymbol.Family.Name,\n    TypeName = columnSymbol.Name,\n\
+  \    Level = level.Name,\n    PositionX_mm = 100.0,\n    PositionY_mm = 0.0\n};"
+parameters: []
+tags: []
+created_at: '2026-03-15T10:44:05.472069'
+source_query: 创建结构柱100,0,0
+execution_count: 0
+last_used: ''

revit_bridge-0.1.0/capabilities/create_column_2.yaml

@@ -0,0 +1,29 @@
+name: create_column_2
+display_name: Create Column 2
+description: create column
+code_template: "// Step 1: Find the FamilySymbol for the structural column type\n\
+  FamilySymbol columnSymbol = new FilteredElementCollector(document)\n    .OfClass(typeof(FamilySymbol))\n\
+  \    .OfCategory(BuiltInCategory.OST_StructuralColumns)\n    .Cast<FamilySymbol>()\n\
+  \    .FirstOrDefault(s => s.Name == \"300 x 450mm\");\n\nif (columnSymbol == null)\n\
+  \    return new { Status = \"Error\", Message = \"FamilySymbol '300 x 450mm' not\
+  \ found.\" };\n\n// Step 2: Activate the FamilySymbol if not already active\nif\
+  \ (!columnSymbol.IsActive)\n{\n    columnSymbol.Activate();\n    document.Regenerate();\n\
+  }\n\n// Step 3: Find the base level (L1 at elevation 0)\nLevel baseLevel = new FilteredElementCollector(document)\n\
+  \    .OfClass(typeof(Level))\n    .Cast<Level>()\n    .FirstOrDefault(l => l.Name\
+  \ == \"L1\");\n\nif (baseLevel == null)\n    return new { Status = \"Error\", Message\
+  \ = \"Level 'L1' not found.\" };\n\n// Step 4: Define the insertion point — 200mm\
+  \ = 200/304.8 feet\ndouble x = 200.0 / 304.8;\ndouble y = 0.0 / 304.8;\ndouble z\
+  \ = 0.0;\nXYZ insertionPoint = new XYZ(x, y, z);\n\n// Step 5: Place the structural\
+  \ column instance using NewFamilyInstance\nFamilyInstance column = document.Create.NewFamilyInstance(\n\
+  \    insertionPoint,\n    columnSymbol,\n    baseLevel,\n    Autodesk.Revit.DB.Structure.StructuralType.Column);\n\
+  \nif (column == null)\n    return new { Status = \"Error\", Message = \"Failed to\
+  \ create column instance.\" };\n\nreturn new\n{\n    Status = \"Created\",\n   \
+  \ ElementId = column.Id.Value,\n    FamilyName = columnSymbol.FamilyName,\n    TypeName\
+  \ = columnSymbol.Name,\n    Level = baseLevel.Name,\n    PositionX_mm = 200,\n \
+  \   PositionY_mm = 0\n};"
+parameters: []
+tags: []
+created_at: '2026-03-15T11:09:58.645698'
+source_query: 创建结构柱在200,0,0
+execution_count: 2
+last_used: '2026-03-20T09:51:45.627432'

revit_bridge-0.1.0/capabilities/create_floor.yaml

@@ -0,0 +1,54 @@
+name: create_floor
+display_name: Create Floor
+description: Create a rectangular floor slab at specified coordinates and dimensions.
+code_template: "// Step 1: Get floor type by name\nvar floorType = new FilteredElementCollector(document)\n\
+  \    .OfClass(typeof(FloorType))\n    .Cast<FloorType>()\n    .FirstOrDefault(ft\
+  \ => ft.Name == \"{type_name}\");\nif (floorType == null)\n    return new { Status\
+  \ = \"Error\", Message = \"Floor type '{type_name}' not found\" };\n\n// Step 2:\
+  \ Get level by name\nvar level = new FilteredElementCollector(document)\n    .OfClass(typeof(Level))\n\
+  \    .Cast<Level>()\n    .FirstOrDefault(l => l.Name == \"{level_name}\");\nif (level\
+  \ == null)\n    return new { Status = \"Error\", Message = \"Level '{level_name}'\
+  \ not found\" };\n\n// Step 3: Create rectangular profile (mm -> feet)\ndouble x0\
+  \ = {x} / 304.8, y0 = {y} / 304.8;\ndouble w = {width} / 304.8, h = {length} / 304.8;\n\
+  var profile = new List<Curve>();\nprofile.Add(Line.CreateBound(new XYZ(x0, y0, 0),\
+  \ new XYZ(x0 + w, y0, 0)));\nprofile.Add(Line.CreateBound(new XYZ(x0 + w, y0, 0),\
+  \ new XYZ(x0 + w, y0 + h, 0)));\nprofile.Add(Line.CreateBound(new XYZ(x0 + w, y0\
+  \ + h, 0), new XYZ(x0, y0 + h, 0)));\nprofile.Add(Line.CreateBound(new XYZ(x0, y0\
+  \ + h, 0), new XYZ(x0, y0, 0)));\nvar curveLoop = CurveLoop.Create(profile);\n\n\
+  // Step 4: Create floor\nvar floor = Floor.Create(document, new List<CurveLoop>\
+  \ { curveLoop },\n                         floorType.Id, level.Id);\n\nreturn new\
+  \ { ElementId = floor.Id.Value, Status = \"Created\",\n             FloorType =\
+  \ floorType.Name, Level = level.Name };\n"
+parameters:
+- name: type_name
+  type: string
+  description: Floor type name
+  choices_from: floor_types
+- name: level_name
+  type: string
+  description: Target level name
+  choices_from: levels
+- name: x
+  type: double
+  description: Floor origin X (mm)
+  default: '0'
+- name: y
+  type: double
+  description: Floor origin Y (mm)
+  default: '0'
+- name: width
+  type: double
+  description: Floor width (mm)
+  default: '6000'
+- name: length
+  type: double
+  description: Floor length (mm)
+  default: '8000'
+tags:
+- floor
+- create
+- basic
+created_at: '2026-03-13T00:00:00'
+source_query: create a floor slab
+execution_count: 1
+last_used: '2026-03-15T14:31:09.972751'

revit_bridge-0.1.0/capabilities/create_room.yaml

@@ -0,0 +1,55 @@
+name: create_room
+display_name: Create Room
+description: create room by height , width and height
+code_template: "// Step 1: Get the wall type \"Generic - 150mm\" — using FilteredElementCollector\
+  \ with OfClass(WallType)\nWallType wallType = new FilteredElementCollector(document)\n\
+  \    .OfClass(typeof(WallType))\n    .Cast<WallType>()\n    .FirstOrDefault(wt =>\
+  \ wt.Name == \"Generic - 150mm\");\n\nif (wallType == null)\n    return new { Status\
+  \ = \"Error\", Message = \"WallType 'Generic - 150mm' not found.\" };\n\n// Step\
+  \ 2: Get the level \"L1\" — using FilteredElementCollector with OfClass(Level)\n\
+  Level level = new FilteredElementCollector(document)\n    .OfClass(typeof(Level))\n\
+  \    .Cast<Level>()\n    .FirstOrDefault(l => l.Name == \"L1\");\n\nif (level ==\
+  \ null)\n    return new { Status = \"Error\", Message = \"Level 'L1' not found.\"\
+  \ };\n\n// Step 3: Define the room dimensions — 5m x 4m in feet (1m = 1/0.3048 ft)\n\
+  double width  = 5.0 / 0.3048; // 5m in feet\ndouble depth  = 4.0 / 0.3048; // 4m\
+  \ in feet\ndouble height = 3.0 / 0.3048; // 3m wall height in feet\n\n// Step 4:\
+  \ Define the four corner points of the room\nXYZ pt0 = new XYZ(0,     0,     level.Elevation);\n\
+  XYZ pt1 = new XYZ(width, 0,     level.Elevation);\nXYZ pt2 = new XYZ(width, depth,\
+  \ level.Elevation);\nXYZ pt3 = new XYZ(0,     depth, level.Elevation);\n\n// Step\
+  \ 5: Define the four wall curves (closed loop)\nList<Curve> wallCurves = new List<Curve>\n\
+  {\n    Line.CreateBound(pt0, pt1), // South wall\n    Line.CreateBound(pt1, pt2),\
+  \ // East wall\n    Line.CreateBound(pt2, pt3), // North wall\n    Line.CreateBound(pt3,\
+  \ pt0)  // West wall\n};\n\n// Step 6: Create the four walls using Wall.Create —\
+  \ structural = false\nList<Wall> createdWalls = new List<Wall>();\nforeach (Curve\
+  \ curve in wallCurves)\n{\n    Wall wall = Wall.Create(\n        document,\n   \
+  \     curve,\n        wallType.Id,\n        level.Id,\n        height,\n       \
+  \ 0.0,    // offset from level\n        false,  // flip\n        false   // structural\n\
+  \    );\n    createdWalls.Add(wall);\n}\n\n// Step 7: Create a Room at the center\
+  \ of the office — using document.Create.NewRoom\n// Room center point (UV for plan\
+  \ placement)\ndouble centerX = width  / 2.0;\ndouble centerY = depth  / 2.0;\nUV\
+  \ roomCenter = new UV(centerX, centerY);\n\nAutodesk.Revit.DB.Architecture.Room\
+  \ room =\n    document.Create.NewRoom(level, roomCenter);\n\nif (room == null)\n\
+  \    return new { Status = \"Error\", Message = \"Failed to create room.\" };\n\n\
+  // Step 8: Set the room name and number\nroom.Name   = \"办公室\";\nroom.Number = \"\
+  101\";\n\n// Step 9: Get the active view to place the room tag\n// Use the first\
+  \ floor plan view associated with L1\nView tagView = new FilteredElementCollector(document)\n\
+  \    .OfClass(typeof(ViewPlan))\n    .Cast<ViewPlan>()\n    .FirstOrDefault(v =>\
+  \ v.GenLevel != null && v.GenLevel.Id == level.Id && !v.IsTemplate);\n\nif (tagView\
+  \ == null)\n{\n    // Fallback: any floor plan view\n    tagView = new FilteredElementCollector(document)\n\
+  \        .OfClass(typeof(ViewPlan))\n        .Cast<ViewPlan>()\n        .FirstOrDefault(v\
+  \ => !v.IsTemplate);\n}\n\nAutodesk.Revit.DB.Architecture.RoomTag roomTag = null;\n\
+  if (tagView != null)\n{\n    // Step 10: Create a RoomTag at the room center — using\
+  \ document.Create.NewRoomTag\n    roomTag = document.Create.NewRoomTag(\n      \
+  \  new LinkElementId(room.Id),\n        roomCenter,\n        tagView.Id\n    );\n\
+  }\n\n// Step 11: Return summary of created elements\nreturn new\n{\n    Status \
+  \      = \"Success\",\n    Message      = \"办公室创建成功 (5m x 4m)\",\n    WallCount\
+  \    = createdWalls.Count,\n    WallIds      = createdWalls.Select(w => w.Id.Value).ToList(),\n\
+  \    RoomId       = room.Id.Value,\n    RoomName     = room.Name,\n    RoomNumber\
+  \   = room.Number,\n    RoomTagId    = roomTag != null ? roomTag.Id.Value : -1L,\n\
+  \    LevelName    = level.Name,\n    WallTypeName = wallType.Name\n};"
+parameters: []
+tags: []
+created_at: '2026-03-15T14:37:20.232999'
+source_query: 创建一个5m x 4m的办公室，包含4面墙、房间和房间标签
+execution_count: 0
+last_used: ''

revit_bridge-0.1.0/capabilities/create_structural_column.yaml

@@ -0,0 +1,43 @@
+name: create_structural_column
+display_name: Create Structural Column
+description: Create a structural column at specified coordinates using first available
+  structural column family type.
+code_template: "// Step 1: Get structural column family symbol by name\nvar symbol\
+  \ = new FilteredElementCollector(document)\n    .OfClass(typeof(FamilySymbol))\n\
+  \    .OfCategory(BuiltInCategory.OST_StructuralColumns)\n    .Cast<FamilySymbol>()\n\
+  \    .FirstOrDefault(s => s.Name == \"{type_name}\");\nif (symbol == null)\n   \
+  \ return new { Status = \"Error\", Message = \"Column type '{type_name}' not found\"\
+  \ };\nif (!symbol.IsActive) symbol.Activate();\n\n// Step 2: Get level by name\n\
+  var level = new FilteredElementCollector(document)\n    .OfClass(typeof(Level))\n\
+  \    .Cast<Level>()\n    .FirstOrDefault(l => l.Name == \"{level_name}\");\nif (level\
+  \ == null)\n    return new { Status = \"Error\", Message = \"Level '{level_name}'\
+  \ not found\" };\n\n// Step 3: Create column at position (mm -> feet)\nXYZ location\
+  \ = new XYZ({x} / 304.8, {y} / 304.8, 0);\nvar column = document.Create.NewFamilyInstance(\n\
+  \    location, symbol, level,\n    Autodesk.Revit.DB.Structure.StructuralType.Column);\n\
+  \nreturn new { ElementId = column.Id.Value, Status = \"Created\",\n            \
+  \ FamilyType = symbol.Name, Level = level.Name };\n"
+parameters:
+- name: type_name
+  type: string
+  description: Structural column family type name
+  choices_from: family_types:OST_StructuralColumns
+- name: level_name
+  type: string
+  description: Target level name
+  choices_from: levels
+- name: x
+  type: double
+  description: Column X position (mm)
+  default: '0'
+- name: y
+  type: double
+  description: Column Y position (mm)
+  default: '0'
+tags:
+- column
+- structural
+- create
+created_at: '2026-03-13T00:00:00'
+source_query: create a structural column
+execution_count: 1
+last_used: '2026-03-15T13:51:40.434751'

revit_bridge-0.1.0/capabilities/create_wall.yaml

@@ -0,0 +1,48 @@
+name: create_wall
+display_name: Create Wall
+description: Create a wall between two points with specified height. Uses first available
+  wall type and first level.
+code_template: "// Step 1: Get level by name\nvar level = new FilteredElementCollector(document)\n\
+  \    .OfClass(typeof(Level))\n    .Cast<Level>()\n    .FirstOrDefault(l => l.Name\
+  \ == \"{level_name}\");\nif (level == null)\n    return new { Status = \"Error\"\
+  , Message = \"Level '{level_name}' not found\" };\n\n// Step 2: Create wall line\
+  \ from mm coordinates\nXYZ start = new XYZ({start_x} / 304.8, {start_y} / 304.8,\
+  \ 0);\nXYZ end = new XYZ({end_x} / 304.8, {end_y} / 304.8, 0);\nLine wallLine =\
+  \ Line.CreateBound(start, end);\n\n// Step 3: Create wall (Transaction already active\
+  \ — do NOT create one)\nWall wall = Wall.Create(document, wallLine, level.Id, false);\n\
+  wall.get_Parameter(BuiltInParameter.WALL_USER_HEIGHT_PARAM)\n    .Set({height} /\
+  \ 304.8);\n\nreturn new { ElementId = wall.Id.Value, Status = \"Created\", Level\
+  \ = level.Name };\n"
+parameters:
+- name: level_name
+  type: string
+  description: Target level name
+  choices_from: levels
+- name: start_x
+  type: double
+  description: Wall start X (mm)
+  default: '0'
+- name: start_y
+  type: double
+  description: Wall start Y (mm)
+  default: '0'
+- name: end_x
+  type: double
+  description: Wall end X (mm)
+  default: '5000'
+- name: end_y
+  type: double
+  description: Wall end Y (mm)
+  default: '0'
+- name: height
+  type: double
+  description: Wall height (mm)
+  default: '3000'
+tags:
+- wall
+- create
+- basic
+created_at: '2026-03-13T00:00:00'
+source_query: create a wall
+execution_count: 1
+last_used: '2026-03-15T14:12:46.748985'