Get the current location's view

Instructions

Implementation Reference

• src/McpService.ts:264-283 (registration)

  Tool definition and registration in makeToolsDef: conditionally names the tool 'get_traveler_view_info' (non-second person mode), defines input schema for optional booleans includePhoto and includeNearbyFacilities, title, description. Included in tools list returned by ListToolsRequestSchema handler.

  {
    name: env.personMode === 'second' ? "get_current_view_info" : "get_traveler_view_info",
    title: "Get the current location's view",
    description: env.personMode === 'second' ?
      "Get the address of the current location and information on nearby facilities,view snapshot" :
      "Get the address of the current traveler's location and information on nearby facilities,view snapshot",
    inputSchema: {
      type: "object",
      properties: {
        includePhoto: {
          type: "boolean",
          description: "Get scenery photos of current location"
        },
        includeNearbyFacilities: {
          type: "boolean",
          description: "Get information on nearby facilities"
        },
      }
    }
  },

• src/McpService.ts:1029-1031 (handler)

  Dispatch handler in toolSwitch function (invoked by MCP CallToolRequestSchema): matches tool name and calls getCurrentLocationInfo with parsed arguments.

  case "get_traveler_view_info":
    return getCurrentLocationInfo(request.params.arguments?.includePhoto as boolean, request.params.arguments?.includeNearbyFacilities as boolean,env)
  case "reach_a_percentage_of_destination":

• src/McpService.ts:566-568 (helper)

  Thin wrapper helper: invokes RunnerService.getCurrentView with current time and parameters, handling practice mode.

  const getCurrentLocationInfo = (includePhoto: boolean, includeNearbyFacilities: boolean,env:Mode) => {
    return RunnerService.getCurrentView(dayjs(), includePhoto, includeNearbyFacilities, env.isPractice)
  }

• src/RunnerService.ts:290-296 (handler)

  Primary handler implementation: Retrieves current run status, computes elapsed ratio, updates if ended, delegates to makeView for status-specific view generation.

  function getCurrentView(now: dayjs.Dayjs, includePhoto: boolean, includeNearbyFacilities: boolean, practice = false) {
    return Effect.gen(function* () {
      const {runStatus, justArrive, elapseRatio} = yield* getRunStatusAndUpdateEnd(now,practice);
      //  ただし前回旅が存在し、それが終了していても、そのendTimeから1時間以内ならその場所にいるものとして表示する
      return yield* makeView(runStatus, elapseRatio, justArrive && dayjs().isBefore(dayjs.unix(runStatus.tilEndEpoch).add(1, "hour")), includePhoto, includeNearbyFacilities, practice)
    })
  }

• src/RunnerService.ts:298-350 (handler)

  Generates view based on trip status: 'vehicle' (special prompts/images), 'stop' (hotel image), 'running' (facilities, street/AI image, location text); formats ToolContentResponse with text/image.

  function makeView(runStatus: RunStatus, elapseRatio: number, showRunning: boolean, includePhoto: boolean, includeNearbyFacilities: boolean, practice = false, debugRoute?: string) {
    return Effect.gen(function* () {
      let loc: LocationDetail
      let viewStatus: TripStatus;
      const runnerEnv = yield* DbService.getSysEnv()
      // const env = yield *DbService.getSysMode()
      if (practice) {
        loc = {
          status: runStatus.status,
          lat: runStatus.endLat,
          lng: runStatus.endLng,
          bearing: MapService.getBearing(runStatus.startLat, runStatus.startLng, runStatus.endLat, runStatus.endLng),
          timeZoneId: 'Asia/Tokyo',
          remainSecInPath: 0,
          maneuver: undefined,
          isEnd: true,
          landPathNo: -1,
        }
        viewStatus = runStatus.status;
      } else {
        loc = yield* calcCurrentLoc(runStatus, elapseRatio, debugRoute); //  これは計算位置情報
        viewStatus = loc.status;
        yield* McpLogService.logTrace(`getCurrentView:elapseRatio:${elapseRatio},start:${runStatus.startTime},end:${dayjs.unix(runStatus.tilEndEpoch)},status:${loc.status}`)
        if (showRunning) {
          viewStatus = 'running'
        }
        //  skip移動モードのときは例外的に画像情報はrunningにする(stop=ホテル画面ではなく、今の場所の画面を生成する)
        if (runnerEnv.mode.moveMode === "skip" && viewStatus === "stop") {
          viewStatus = 'running'
        }
      }
      switch (viewStatus) {
        case 'vehicle':
          return yield* vehicleView(loc, includePhoto,runnerEnv);
        case 'stop':
          return yield* hotelView(practice ? 'Asia/Tokyo' : loc.timeZoneId, includePhoto, runStatus.to, runnerEnv)
        case "running":
          const {
            nearFacilities,
            image,
            locText
          } = yield* (practice ? getFacilitiesPractice(runStatus.to, includePhoto) : getFacilities(loc, runnerEnv, includePhoto, false))
          return yield* runningReport(locText, includeNearbyFacilities ? nearFacilities : undefined, image, false, showRunning).pipe(Effect.andThen(a => a.out))
      }
  
    }).pipe(Effect.catchAll(e => {
      if (e instanceof AnswerError) {
        return Effect.fail(e)
      }
      return McpLogService.logError(`getCurrentView catch:${e},${JSON.stringify(e)}`).pipe(Effect.andThen(() =>
        Effect.fail(new AnswerError("Sorry,I don't know where you are right now. Please wait a moment and ask again."))));
    }))
  }