geospec 0.1.0-beta.6 → 0.1.0-beta.7

package/agent/geospec-authoring/api-types.md

@@ -1540,6 +1540,8 @@ LoadModelCodeOptions: {
     code: Code;
     /** Entry path to render from {@link code}. */
     file: keyof Code & string;
+    /** Not accepted: inline code has no project folder to resolve in, and a load naming one is refused. */
+    rootDir?: never;
     /** Geometry format to export. Defaults to `glb`. */
     format?: GeoSpecModelFormat;
     /** Explicit parameters passed to the runtime. */
@@ -1581,6 +1583,9 @@ LoadModelCodeOptions: {
   // Entry path to render from {@link code }
   file: keyof Code & string
 
+  // Not accepted
+  rootDir?: never
+
   // Geometry format to export
   format?: GeoSpecModelFormat
 
@@ -1616,8 +1621,17 @@ LoadModelCodeOptions: {
 
 // Filesystem-backed model load options
 LoadModelFileOptions: {
-    /** Project-relative model file to render. */
+    /**
+     * Model file to render, as a path from the project root: the same root every tool's `targetFile` resolves
+     * against, which the result names as `projectRoot` where the host reports it, as `tau mcp` does.
+     */
     file: string;
+    /**
+     * Project-relative folder `file` resolves in, for a suite that loads from somewhere other than the project root:
+     * `loadModel({ file: 'main.ts', rootDir: 'parts/gear' })` loads `parts/gear/main.ts`. Recorded in the load
+     * evidence.
+     */
+    rootDir?: string;
     /** Project root used by runtime integrations. */
     projectPath?: string;
     /** Geometry format to export. Defaults to `glb`. */
@@ -1653,9 +1667,12 @@ LoadModelFileOptions: {
     region?: GeoSpecLoadRegion;
 }
 
-  // Project-relative model file to render
+  // Model file to render, as a path from the project root
   file: string
 
+  // Project-relative folder `file` resolves in, for a suite that loads from somewhere other than the project root
+  rootDir?: string
+
   // Project root used by runtime integrations
   projectPath?: string
 
@@ -1692,6 +1709,9 @@ LoadModelFileOptions: {
 // Options accepted by {@link import ('./load-model.js').loadModel}
 LoadModelOptions: LoadModelSourceOptions | LoadModelCodeOptions<Code> | LoadModelFileOptions
 
+  // Project-relative folder `file` resolves in, for a suite that loads from somewhere other than the project root
+  rootDir?: string
+
   // Geometry format to export
   format?: GeoSpecModelFormat
 
@@ -1722,6 +1742,11 @@ LoadModelSourceOptions: {
         readonly name: string;
         readonly source: MeshSource | StepSource;
     }>;
+    /**
+     * Project-relative folder a path `source` and each resource path resolve in. Omitted, they resolve against the
+     * project root. Recorded in the load evidence.
+     */
+    rootDir?: string;
     /** Source geometry format. Defaults to `glb`. */
     format?: GeoSpecModelFormat;
     /** Source path recorded in provenance. */
@@ -1757,6 +1782,9 @@ LoadModelSourceOptions: {
           readonly source: MeshSource | StepSource;
       }>
 
+  // Project-relative folder a path `source` and each resource path resolve in
+  rootDir?: string
+
   // Source geometry format
   format?: GeoSpecModelFormat